Skip to main content
GET
/
api
/
v1
/
owner
/
external-agents
/
tokens
List Tokens
curl --request GET \
  --url https://api.example.com/api/v1/owner/external-agents/tokens
{
  "token_id": "<string>",
  "token_prefix": "<string>",
  "agent_display_name": "<string>",
  "last_used_at": "<string>",
  "created_at": "<string>"
}

​
List External Agent Tokens

Returns all external agent tokens for the authenticated user. Only token metadata is returned — raw token values are not stored.

​
Authentication

Requires a valid user JWT token.

​
Response

Returns an array of token objects:
​
token_id
string
UUID of the token.
​
token_prefix
string
Display prefix (e.g., ama_eat_a1b2).
​
agent_display_name
string
Associated agent name.
​
last_used_at
string
Last usage timestamp (nullable).
​
created_at
string
Creation timestamp.

​
Example

curl https://api.ama2.me/api/v1/owner/external-agents/tokens \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

[
  {
    "token_id": "uuid",
    "token_prefix": "ama_eat_a1b2",
    "agent_display_name": "My Agent",
    "last_used_at": "2026-04-09T11:30:00Z",
    "created_at": "2026-04-01T12:00:00Z"
  }
]