Speko Docs
API Reference

List agents

Returns every agent belonging to the authenticated organization. Agents are scoped per-org — IDs from another org will never appear here.

GET
/v1/agents

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Response Body

application/json

application/json

[
  {
    "id": "agent_01HW...",
    "organizationId": "string",
    "name": "string",
    "systemPrompt": "string",
    "voice": "string",
    "intent": {
      "language": "en-US",
      "optimizeFor": "latency"
    },
    "llmOptions": {
      "temperature": 0,
      "maxTokens": 1,
      "model": "string"
    },
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "stackPreferences": {
      "allowedProviders": {
        "stt": [
          "deepgram"
        ],
        "llm": [
          "openai"
        ],
        "tts": [
          "elevenlabs"
        ]
      }
    }
  }
]
{
  "error": "Unauthorized",
  "code": "UNAUTHORIZED"
}

Complete

Single-turn LLM call routed to the best provider for your intent, with automatic failover. Returns assistant text + token usage.

Create agent

Persists a reusable voice persona — `systemPrompt`, optional `voice`, routing `intent`, and optional `llmOptions` — keyed by `name` within the authenticated organization. Pass the returned `id` as `agentId` on `POST /v1/sessions` to seed a session from this agent.