---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/agent-identity/api/users#article
headline: Users API
description: Manage Agent Identity users and their authorization relationships with clients through the Users API.
url: https://www.twilio.com/docs/agent-identity/api/users
inLanguage: en
dateModified: 2026-09-18T12:02:39.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# Users API

> \[!IMPORTANT]
>
> Agent Identity is available as a Private Beta product, and the information
> contained in this document is subject to change. You acknowledge and agree
> that your use of Agent Identity is subject to the terms of the [Services in
> Private
> Beta](https://www.twilio.com/en-us/legal/service-country-specific-terms/private-beta).
> Some features are not yet implemented and others may change before the
> product is declared as Generally Available. Private Beta products are not
> covered by the Twilio Support Terms or Twilio Service Level Agreement.

Agent Identity tracks the relationships between your users and the clients they've authorized. You can query and manage these relationships through the API and view them in the Console.

## User

A user record is created automatically the first time a user completes the Trusted Auth Token flow, and updated on later sign-ins. Each user carries the subject from your system, the scopes the user may grant, and the custom claims from the Trusted Auth Token.

## Authorization

An authorization is a consent relationship between a user and a client. It records the client that was granted access and the scopes the user granted.

## Endpoints

| Operation            | Method and path                                       | Description                                                                                                                                                |
| -------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| List users           | `GET /v1/Users`                                       | Retrieve a paginated list of users.                                                                                                                        |
| Get user             | `GET /v1/Users/{userId}`                              | Retrieve a single user by ID.                                                                                                                              |
| Delete user          | `DELETE /v1/Users/{userId}`                           | Delete a user.                                                                                                                                             |
| List authorizations  | `GET /v1/Users/{userId}/Authorizations`               | Retrieve a paginated list of the clients a user has authorized and the scopes granted.                                                                     |
| Delete authorization | `DELETE /v1/Users/{userId}/Authorizations/{clientId}` | Revoke a user's authorization for a client. This also revokes the refresh tokens issued to that client for that user. Note that a `clientId` can be a URL. |