> For the complete documentation index, see [llms.txt](https://www.cakewalk.security/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.cakewalk.security/docs/open-api-and-mcp/api-reference/users.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://www.cakewalk.security/docs/open-api-and-mcp/api-reference/users.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.