Assistants API

The Assistants API allows you to programmatically retrieve the AI Agents configured within your tenant workspace.

List Assistants

GET /v1/assistants

Returns a paginated list of all your active assistants.

Example Response

{
  "data": [
    {
      "id": "ast_abc123",
      "name": "Legal Document Analyzer",
      "description": "Extracts liability clauses from PDFs.",
      "createdAt": "2024-03-01T10:00:00Z"
    }
  ]
}

Get Assistant Details

GET /v1/assistants/:id

Retrieves detailed information, including the internal System Prompt defining the agent's behavior.