answerLoopsanswerLoops Docs
ReferenceAgent API

List support tickets for the organization

GET
/api/v1/agent/tickets

Authorization

bearerAuth tickets:read
AuthorizationBearer <token>

Org-scoped API key generated in Settings → API Keys (al_live_ prefix). Shared with the MCP server — the same key authenticates both surfaces. A key carries a set of least-privilege scopes; each operation lists the scope it requires. A key missing a required scope gets 403 with a WWW-Authenticate: Bearer error="insufficient_scope" header. Scope catalogue: see the x-api-scopes object and /.well-known/oauth-protected-resource.

In: header

Scope: tickets:read

Query Parameters

status?string

Value in

  • "open"
  • "in_progress"
  • "resolved"
  • "closed"
  • "duplicate"
priority?string

Value in

  • "critical"
  • "high"
  • "medium"
  • "low"
category?string

Value in

  • "bug"
  • "feature_request"
  • "documentation"
  • "how_to"
  • "general_question"
limit?integer

Max results per page

Range1 <= value <= 20
Default10
cursor?string

Opaque value from a previous response's next_cursor. Omit for the first page.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/agent/tickets"
{  "tickets": [    {      "id": 0,      "content": "string",      "category": "string",      "priority": "string",      "status": "string",      "ai_summary": "string",      "created_at": "string"    }  ],  "next_cursor": "string"}
{  "error": {    "message": "string",    "code": "rate_limited"  }}
{  "error": {    "message": "string",    "code": "rate_limited"  }}
{  "error": {    "message": "string",    "code": "rate_limited"  }}

Get the organization's most recently generated FAQ digest

Previous Page

Open a new support ticket on behalf of a user

Runs through the same AI triage/answer pipeline as every other channel (Discord, Slack, email) — the ticket may get auto-answered if confidence is high, otherwise it queues for human review.