Create and start thread
Threads
Create and start thread
Create a new captain thread and immediately start execution, optionally assigning existing project tags.
POST
Create and start thread
Authorizations
API token (capy_xxxx). Generate at capy.ai/settings/tokens
Body
application/json
Minimum string length:
1Pattern:
^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$Available options:
claude-opus-4-8, claude-opus-4-7, claude-opus-4-6, claude-opus-4-5, claude-sonnet-4-6, claude-haiku-4-5, gpt-5.5, gpt-5.5-pro, gpt-5.4, gpt-5.4-mini, gpt-5.3-codex, gpt-5.3-codex-spark, gemini-3.1-pro-preview, gemini-3-flash-preview, grok-4-1-fast, glm-5.2, glm-5.1, glm-5v-turbo, glm-5, deepseek-v4-pro, glm-5-turbo, glm-4.7, kimi-k2.7-code, kimi-k2.6, qwen3-coder, claude-fable-5 Available options:
fast, standard Available options:
claude-opus-4-8, claude-opus-4-7, claude-opus-4-6, claude-opus-4-5, claude-sonnet-4-6, claude-haiku-4-5, gpt-5.5, gpt-5.5-pro, gpt-5.4, gpt-5.4-mini, gpt-5.3-codex, gpt-5.3-codex-spark, gemini-3.1-pro-preview, gemini-3-flash-preview, grok-4-1-fast, glm-5.2, glm-5.1, glm-5v-turbo, glm-5, deepseek-v4-pro, glm-5-turbo, glm-4.7, kimi-k2.7-code, kimi-k2.6, qwen3-coder, claude-fable-5 Available options:
fast, standard Maximum array length:
20Required string length:
1 - 64Pattern:
^[a-z0-9][a-z0-9_-]{0,63}$Pattern:
^rel_[a-f0-9]{40}$Response
Success
Coarse Captain run-loop status retained for compatibility. Prefer runState/waitingOn/blockedOn for completion and waiting UX.
Available options:
active, idle, archived Full computed execution state for the agent thread.
Available options:
running, queued, waiting, blocked, ready, archived Async system dependencies expected to continue without user action.
Available options:
task, review, ci, timer, worker User/integration gates required before progress can continue.
Available options:
auth, permission Pending append-and-resume notifications waiting to be processed.
Required range:
0 <= x <= 9007199254740991