Skip to main content

​
List Agents

​
GET /v1/agents
Returns all agents in your workspace. 
curl https://api.orka.sh/v1/agents \
  -H "Authorization: Bearer $ORKA_API_KEY"
Response
{
  "data": [
    {
      "id": "agent_abc123",
      "name": "Financial Analyst",
      "description": "Answers questions about company filings",
      "created_at": "2026-01-15T10:00:00Z"
    }
  ]
}

​
Get Agent

​
GET /v1/agents/:id
Returns a single agent by ID.

​
Create Agent

​
POST /v1/agents
Request
{
  "name": "Support Bot",
  "description": "Customer support assistant",
  "system_prompt": "You are a helpful support agent...",
  "datastore_ids": ["ds_abc123"]
}

​
Delete Agent

​
DELETE /v1/agents/:id
Permanently deletes an agent and its conversation history.