# Applications

The WorkApps endpoints allow you to manage and investigate SaaS applications that Cakewalk discovers, connects to, or governs. These APIs support detailed visibility into app metadata, user access levels, permission schemas, and access governance policies.

They are especially useful for:

* Auditing who has access to what apps (and at what permission level)
* Assigning/removing access via API
* Controlling access request flows per app or permission level

***

### 📘 WorkApps Endpoints

<table><thead><tr><th width="287.6328125">Endpoint</th><th width="114.953125">Method</th><th width="102.8671875">Version<select><option value="pAwt80GOEHEW" label="v1" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><a href="/pages/G4ww7HGUpE28FVkdLwSm">/{version}/WorkApps</a></td><td>GET</td><td><span data-option="pAwt80GOEHEW">v1</span></td><td>Returns a list of all work apps visible to Cakewalk, including metadata like name, source, and sync status.</td></tr><tr><td><a href="/pages/OE7uEwz7o0VQHtCexbjK">/{version}/WorkApps/{workAppId}</a></td><td>GET</td><td><span data-option="pAwt80GOEHEW">v1</span></td><td>Retrieves detailed metadata for a specific app, such as its status, source system, and settings.</td></tr><tr><td><a href="/pages/IjxhjAzMjUxXCSAEStRz">/{version}/WorkApps/{workAppId}/Accesses</a></td><td>GET</td><td><span data-option="pAwt80GOEHEW">v1</span></td><td>Lists user-level access records for a given app, including user ID and assigned permission level.</td></tr><tr><td><a href="/pages/COUszw0LDPCfEKmSqbVP">/{version}/WorkApps/{workAppId}/PermissionLevels</a></td><td>GET</td><td><span data-option="pAwt80GOEHEW">v1</span></td><td>Returns the list of permission levels defined for the app (e.g., Viewer, Admin, Editor).</td></tr><tr><td><a href="/pages/vKPcxcznIb3ImZuCBjCF">/{version}/WorkApps/Accesses</a></td><td>POST</td><td><span data-option="pAwt80GOEHEW">v1</span></td><td>Bulk create or update user access records. Used to grant or sync access to an app programmatically.</td></tr><tr><td><a href="/pages/5KZcVBdwUprWNOfqa1EB">/{version}/WorkApps/{workAppId}/Policies/{requestType}</a></td><td>PUT</td><td><span data-option="pAwt80GOEHEW">v1</span></td><td>Update the app-wide policy for a specific request type (e.g., grant or remove access).</td></tr><tr><td><a href="/pages/zwKANRMZCSPwapuvcBST">/{version}/WorkApps/{workAppId}/PermissionLevels/{permissionLevelId}/Policies/{requestType}</a></td><td>PUT</td><td><span data-option="pAwt80GOEHEW">v1</span></td><td>Update the policy for a specific permission level within the app for a given request type.</td></tr><tr><td><a href="/pages/psbAcG9nQBu6g7Ihm5hg">/{version}/WorkApps/{workAppId}/CustomFields</a></td><td>GET</td><td><span data-option="pAwt80GOEHEW">v1</span></td><td>Returns the list of Custom Fields values for the app.</td></tr><tr><td><a href="/pages/l8qeovlcADkm9Nzr0oJl">/{version}/WorkApps/{workAppId}/CustomFields</a></td><td>PATCH</td><td><span data-option="pAwt80GOEHEW">v1</span></td><td>Bulk Update the app Custom Fields values.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.getcakewalk.io/open-api-and-mcp/api-reference/applications.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.