List Agents

List all agents for the authenticated user.

API scope required: agents.read

GET /unstable/agents

List Agents

cURL

curl --request GET \
  --url https://staging.crossmint.com/api/unstable/agents \
  --header 'X-API-KEY: <x-api-key>'

200

{
  "agentId": "9b3a1c20-1f2c-4f78-9f4d-6c5b8a3a8a01",
  "metadata": {
    "name": "My Shopping Agent",
    "imageUrl": "https://example.com/agent.png",
    "description": "Buys groceries on my behalf"
  }
}

Headers

X-API-KEY · string · required

API key required for authentication

Response

200 - application/json

Returns the list of agents

agentId · string · required

metadata · object · required

Show child attributes

Example:

{
  "agentId": "9b3a1c20-1f2c-4f78-9f4d-6c5b8a3a8a01",
  "metadata": {
    "name": "My Shopping Agent",
    "imageUrl": "https://example.com/agent.png",
    "description": "Buys groceries on my behalf"
  }
}