> ## Documentation Index
> Fetch the complete documentation index at: https://platform.atlan.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> To act on Atlan objects, use the Atlan MCP server at https://api.atlan.com/mcp or the atlanai CLI; `atlanai --map json` prints its command map. Run a read-only identity check before any write.
> The docs MCP server at /mcp searches these docs only. It cannot read or change Atlan objects.
> SDK packages: Python `atlanai` (PyPI) and TypeScript `@atlanai/sdk` (npm). Show Python first, then TypeScript.

# Users

> Every published users operation, generated from the contract.

14 operations on `client.users`, including `users.sessions`, `users.traces`.

Path parameters come first, positionally; the request body is last, as a plain
object. Method names are `snake_case` in Python and `camelCase` in
TypeScript, and resource names follow the same rule.

<CodeGroup>
  ```python Python theme={null}
  result = client.users.get(user_id)
  ```

  ```typescript TypeScript theme={null}
  const result = await client.users.get(user_id);
  ```
</CodeGroup>

## Operations

| Call | Route | Does |
| - | - | - |
| `client.users.get(user_id)` | `GET /registry/v1/users/{user_id}` | Get a user |
| `client.users.get_own_me()` | `GET /registry/v1/users/me` | Get the caller's own user record |
| `client.users.list()` | `GET /registry/v1/users` | List users |
| `client.users.onboard()` | `POST /registry/v1/users/onboard` | Onboard the caller |
| `client.users.update_own_me(body)` | `PATCH /registry/v1/users/me` | Update the caller's own user record |
| `client.users.sessions.get_own(session_id)` | `GET /registry/v1/users/sessions/{session_id}` | Read one of the caller's own sessions by id |
| `client.users.sessions.list_own_me()` | `GET /registry/v1/users/me/sessions` | List the caller's own sessions |
| `client.users.sessions.revoke_own(session_id)` | `POST /registry/v1/users/sessions/{session_id}/revoke` | Revoke one of the caller's own sessions by id |
| `client.users.sessions.revoke_own_me(body)` | `POST /registry/v1/users/me/sessions/revoke` | Revoke the caller's own sessions |
| `client.users.traces.delete_content(user_id, trace_id)` | `DELETE /registry/v1/users/{user_id}/traces/{trace_id}/content` | Delete one trace's stored content |
| `client.users.traces.get(user_id, trace_id)` | `GET /registry/v1/users/{user_id}/traces/{trace_id}` | Read one of this person's traces |
| `client.users.traces.list(user_id)` | `GET /registry/v1/users/{user_id}/traces` | List the traces this person created |
| `client.users.traces.list_spans(user_id, trace_id)` | `GET /registry/v1/users/{user_id}/traces/{trace_id}/spans` | List the spans of one of this person's traces |
| `client.users.traces.query_stats(user_id, body)` | `POST /registry/v1/users/{user_id}/traces/stats/query` | Trace statistics for this person |

## Related

<CardGroup cols={2}>
  <Card title="How the client is organised" icon="list" href="/tools/sdk/how-tos/operations">
    Resources, call shapes, and errors.
  </Card>

  <Card title="Errors and retries" icon="triangle-exclamation" href="/platform/references/errors-and-retries">
    What the SDK raises, and which calls are safe to retry.
  </Card>
</CardGroup>
