Get Agents

Returns the agents (team members) that belong to your organization. Use this endpoint to discover the agent `id` values required by the `assignedTo` field on Create Ticket and Update Ticket.

Endpoint

GET /api/categories

Authentication

• Requires API token authentication

• Subject to rate limiting

Response

Success (200 OK)

{
  "agents": [
    {
      "id": "6630a1f4c2b9e4a1d8f00b21",
      "email": "[e-mail]",
      "username": "Ada",
      "walletAddress": null
    },
    {
      "id": "6630a1f4c2b9e4a1d8f00b22",
      "email": null,
      "username": "Grace",
      "walletAddress": "0xfDf95D7A893f87A6809E532d57ac220525873B80"
    }
  ]
}

Response Fields

Field	Type	Description
agents	array	The organization's non-archived agents
agents[].id	string	Unique identifier of the agent. Use this value for assignedTo
agents[].email	string | null	The agent's email, or null if the agent signed up with a wallet
agents[].username	string | null	The agent's display name, or null if not set
agents[].walletAddress	string | null	The agent's wallet address, or null if the agent signed up with an email

Error Responses

Unauthorized (401)

{
  "error": "Unauthorized"
}

Server error (500)

{
  "error": "Internal server error"
}

Behavior

• Only agents belonging to the authenticated organization are returned; agents of other organizations are never included.

• Archived agents are excluded.

• email and walletAddress are mutually independent — an agent may have one, the other, or both.

Example (cURL)

curl -X GET https://app.mava.app/api/agents \
    -H "x-auth-token: YOUR_API_KEY"