Skip to main content
GET
/
v1
/
agents
List agents
curl --request GET \
  --url https://api.speko.dev/v1/agents \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "organizationId": "<string>",
    "name": "<string>",
    "systemPrompt": "<string>",
    "voice": "<string>",
    "intent": {
      "language": "<string>",
      "optimizeFor": "latency"
    },
    "llmOptions": {
      "temperature": 1,
      "maxTokens": 2,
      "model": "<string>"
    },
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "stackPreferences": {
      "allowedProviders": {
        "stt": [
          "<string>"
        ],
        "llm": [
          "<string>"
        ],
        "tts": [
          "<string>"
        ]
      }
    }
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.speko.dev/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Agents owned by the authenticated organization.

​
id
string
required

Agent id, prefixed agent_.

Example:

"agent_01HW..."

​
organizationId
string
required

Owning organization. Always equal to the authenticated org — agents are never visible across orgs.

​
name
string
required

Human-readable name. Unique within an organization.

Required string length: 1 - 120
​
systemPrompt
string
required

Initial agent instructions. Hydrated as the session's systemPrompt default when no per-call value is supplied.

Minimum string length: 1
​
voice
string | null
required

Default TTS voice id. null when unset — the router picks a sane default per provider.

​
intent
object
required

Routing defaults stored on an agent row. Hydrated into a session's RoutingIntent when the session is created with agentId and no inline intent. Note: agents accept a smaller optimizeFor enum than the per-session RoutingIntent.

​
llmOptions
object
required

Optional LLM tuning defaults. null when unset.

​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
stackPreferences
object
required

Per-agent stack preferences. null when the agent has no preferences set.