# Users

The Users endpoints allow you to retrieve information about the human end users in your organization who interact with or are managed through Cakewalk. This includes discovering who is provisioned in connected applications and understanding user activity or role-based metadata across SaaS systems.

These endpoints are commonly used to:

* Build custom reporting on user access and activity
* Identify stale or orphaned accounts in managed applications
* Power internal IT workflows (e.g. deprovisioning, role reviews)

{% hint style="info" %}
Non-human identities are available in the Cakewalk dashboard. They are not documented in this public Open API section.
{% endhint %}

***

### 📘 Users Endpoints

<table><thead><tr><th width="183.6796875">Endpoint</th><th width="116.54296875">Method</th><th width="111.18359375">Version<select><option value="CY0fvifNYlq4" label="v1" color="blue"></option></select></th><th>Description</th></tr></thead><tbody><tr><td><a href="/pages/crfhAZ91hQPZezEJ3GRN">/{version}/users</a></td><td>GET</td><td><span data-option="CY0fvifNYlq4">v1</span></td><td>Returns a list of users known to Cakewalk, including metadata such as email, department, job title, and system roles. Supports filtering and pagination.</td></tr><tr><td><a href="/pages/JtIcNha0V4NLlKb6ECaE">/{version}/users/{id}</a></td><td>GET</td><td><span data-option="CY0fvifNYlq4">v1</span></td><td>Returns detailed metadata about a specific user, including linked app accounts and access insights. Useful for investigations or user-level audits.</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/users.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.