List tokens (Cloud-only)

get/v1/client-side-access-tokens

List all client side access tokens for the current account. This is only available for cloud users.

Query ParametersExpand Collapse

agentId: optional string

The agent ID to filter tokens by. If provided, only tokens for this agent will be returned.

limit: optional number

The number of tokens to return per page. Defaults to 10.

offset: optional number

The offset for pagination. Defaults to 0.

ReturnsExpand Collapse

hasNextPage: boolean

tokens: array of object { token, expiresAt, hostname, policy }

token: string

expiresAt: string

hostname: string

policy: object { data, version }

data: array of object { id, access, type }

id: string

access: array of "read_messages" or "write_messages" or "read_agent" or "write_agent"

Accepts one of the following:

"read_messages"

"write_messages"

"read_agent"

"write_agent"

type: "agent"

Accepts one of the following:

"agent"

version: "1"

Accepts one of the following:

"1"

List tokens (Cloud-only)

curl https://api.letta.com/v1/client-side-access-tokens \
    -H "Authorization: Bearer $LETTA_API_KEY"

{
  "hasNextPage": true,
  "tokens": [
    {
      "token": "token",
      "expiresAt": "expiresAt",
      "hostname": "hostname",
      "policy": {
        "data": [
          {
            "id": "id",
            "access": [
              "read_messages"
            ],
            "type": "agent"
          }
        ],
        "version": "1"
      }
    }
  ]
}

Returns Examples

{
  "hasNextPage": true,
  "tokens": [
    {
      "token": "token",
      "expiresAt": "expiresAt",
      "hostname": "hostname",
      "policy": {
        "data": [
          {
            "id": "id",
            "access": [
              "read_messages"
            ],
            "type": "agent"
          }
        ],
        "version": "1"
      }
    }
  ]
}