Cowork API

http://127.0.0.1:8013/api/v1/cowork

GET /api/v1/cowork/sessions

{
  "sessions": [
    {
      "id": "sess_2f8a9c4e5d3b",
      "user_id": "user_abc123",
      "project_id": "proj_7e1a2b3c",
      "title": "API onboarding",
      "status": "idle",
      "mode": "agent",
      "checkpoint": null,
      "metadata": "{}",
      "started_at": "2026-08-13T10:00:00Z",
      "completed_at": null,
      "created_at": "2026-08-13T10:00:00Z",
      "updated_at": "2026-08-13T10:05:00Z"
    }
  ]
}

POST /api/v1/cowork/sessions

{
  "project_id": "proj_7e1a2b3c",
  "title": "API onboarding",
  "status": "idle",
  "mode": "agent",
  "checkpoint": null,
  "metadata": "{}",
  "started_at": "2026-08-13T10:00:00Z",
  "completed_at": null
}

{
  "session": { "id": "sess_2f8a9c4e5d3b" }
}

PATCH /api/v1/cowork/sessions/sess_2f8a9c4e5d3b

{
  "status": "running",
  "title": "API onboarding — in progress",
  "checkpoint": "checkpoint-1",
  "metadata": "{\"step\":2}",
  "completed_at": null
}

{ "ok": true }

POST /api/v1/cowork/personas

{
  "name": "Code Reviewer",
  "description": "Focuses on correctness and idioms.",
  "system_prompt": "You are a careful code reviewer.",
  "tools": "[\"bash\", \"code_execution\"]",
  "isDefault": false
}

{
  "persona": { "id": "pers_9d8e7f6a" }
}

POST /api/v1/cowork/projects

{
  "title": "API docs migration",
  "description": "Migrate runtime API docs to Mintlify.",
  "instructions": "Use the runtime route files as the source of truth.",
  "metadata": "{\"priority\":\"high\"}",
  "git_remote": "https://github.com/allternit/docs",
  "default_branch": "main"
}

{
  "project": { "id": "proj_7e1a2b3c" }
}

POST /api/v1/cowork/projects/proj_7e1a2b3c/files

{
  "name": "routes.md",
  "url": null,
  "upload_id": "abc123upload",
  "media_type": "text/markdown"
}

{
  "file": { "id": "file_1a2b3c4d" }
}

POST /api/v1/cowork/memory

{
  "project_id": "proj_7e1a2b3c",
  "session_id": "sess_2f8a9c4e5d3b",
  "content": "Customer prefers REST over GraphQL.",
  "type": "fact",
  "tags": "preferences,architecture",
  "source": "cowork-session"
}

{
  "memory": { "id": "mem_5e6f7a8b" }
}

POST /api/v1/cowork/memory/search

{ "query": "GraphQL" }

{
  "results": [
    {
      "id": "mem_5e6f7a8b",
      "user_id": "user_abc123",
      "project_id": "proj_7e1a2b3c",
      "session_id": "sess_2f8a9c4e5d3b",
      "content": "Customer prefers REST over GraphQL.",
      "type": "fact",
      "tags": "preferences,architecture",
      "source": "cowork-session",
      "created_at": "2026-08-13T10:00:00Z"
    }
  ]
}

POST /api/v1/cowork/run-agent

{
  "agent_id": "ag_analyzer",
  "role": "reviewer",
  "prompt": "Review the auth module.",
  "spec": { "id": "ag_analyzer", "prompt": "Review the auth module." }
}

{
  "execution_id": "exec_1a2b3c4d",
  "status": "running"
}

POST /api/v1/cowork/team-execute

{
  "command": "cargo test",
  "agent_id": "ag_analyzer",
  "prompt": "Run the test suite and summarize failures."
}

{
  "execution_id": "exec_9d8e7f6a",
  "status": "queued"
}