Fake agents API

Connect

curl "https://api.sondahub.com/v1/helpdesk/agents?limit=3"

Sample records

Records 1 to 3 of 25, exactly as GET /v1/helpdesk/agents/{id} answers them. The data file holds all of them.

[
  {
    "id": 1,
    "created_at": "2025-12-02T12:03:22Z",
    "updated_at": "2025-12-02T12:03:22Z",
    "name": "Nora Lewis",
    "email": "[email protected]",
    "team_id": 1,
    "role": "admin",
    "status": "away",
    "skills": [
      "integrations",
      "onboarding"
    ],
    "open_tickets": 10,
    "rating": 4.4
  },
  {
    "id": 2,
    "created_at": "2025-07-12T20:06:49Z",
    "updated_at": "2025-07-12T20:06:49Z",
    "name": "Camila Roberts",
    "email": "[email protected]",
    "team_id": 1,
    "role": "senior",
    "status": "available",
    "skills": [
      "reports",
      "security",
      "onboarding"
    ],
    "open_tickets": 10,
    "rating": 4.8
  },
  {
    "id": 3,
    "created_at": "2026-04-04T11:53:10Z",
    "updated_at": "2026-04-04T11:53:10Z",
    "name": "Nora Khan",
    "email": "[email protected]",
    "team_id": 1,
    "role": "agent",
    "status": "available",
    "skills": [
      "onboarding",
      "billing",
      "mobile"
    ],
    "open_tickets": 16,
    "rating": 5
  }
]

Fields

Relations: team → one team through team_id; tickets → the tickets whose assignee_id is this agent. Use ?expand=team,tickets to embed them, or the nested routes.

Endpoints

Try it

curl "https://api.sondahub.com/v1/helpdesk/agents?role=senior&expand=team&limit=3"

curl https://api.sondahub.com/v1/helpdesk/agents/1?expand=team

curl "https://api.sondahub.com/v1/helpdesk/agents/1/tickets?limit=5"

curl -i -X POST https://api.sondahub.com/v1/helpdesk/agents \
  -H "Content-Type: application/json" \
  -d '{"name":"A name","email":"A email","team_id":1,"role":"agent","status":"available"}'

curl "https://api.sondahub.com/v1/helpdesk/agents?sort=-id&limit=3" \
  -H "X-Sondahub-Session: THE_TOKEN_FROM_THE_CREATE"

curl -X PATCH https://api.sondahub.com/v1/helpdesk/agents/1 \
  -H "Content-Type: application/json" \
  -d '{"role":"senior"}'

curl -X DELETE https://api.sondahub.com/v1/helpdesk/agents/26 \
  -H "X-Sondahub-Session: THE_TOKEN_FROM_THE_CREATE"

Query recipes

Every list option works on agents; these are ready to paste. All the options.

GraphQL

The same agents as the agents query on https://api.sondahub.com/v1/helpdesk/graphql, and one agent as agent(id: 1). Introspection is on. More on the GraphQL API.

{
  agents(limit: 3, sort: "-id", filter: { role: agent }) {
    total
    data {
      id name email team_id
      team { name }
      tickets(limit: 2) { id }
    }
  }
}

curl https://api.sondahub.com/v1/helpdesk/graphql -H "Content-Type: application/json" -d '{"query": "{ agents(limit: 3, sort: \"-id\", filter: { role: agent }) { total data { id name email team_id team { name } tickets(limit: 2) { id } } } }"}'

From an AI agent (MCP)

The MCP server reaches the same rows with list_records, get_record, create_record, update_record and delete_record, and as the resource sondahub://helpdesk/agents.

curl https://api.sondahub.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_records","arguments":{"api":"helpdesk","collection":"agents","filters":{"role":"agent"},"limit":3}}}'

More in the Helpdesk API

teams (4) · customers (300) · tickets (2,000) · messages (5,069)

The live streams, and the whole API on one page: Helpdesk API. Other worlds: fake e-commerce API, fake IoT API, fake banking API, fake social media API, fake flight booking API, fake user directory API.