v2
latestOpenAPI 3.1.02026-07-263761369.4 KBthreads
Create and start thread
Create a new captain thread and immediately start execution, optionally assigning existing project tags.
post/v1/threads
Request body
projectIdstring required
impersonateUserEmailstring email
promptstring required
model'claude-fable-5' | 'claude-opus-5' | 'claude-sonnet-5' | '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.6-sol' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | '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' | 'grok-4-5' | 'composer-2.5-fast' | 'glm-5.2' | 'glm-5.1' | 'glm-5v-turbo' | 'deepseek-v4-pro' | 'glm-5-turbo' | 'glm-4.7' | 'kimi-k3' | 'kimi-k2.7-code' | 'kimi-k2.6' | 'qwen3-coder'
speed'fast' | 'standard'
buildModel'claude-fable-5' | 'claude-opus-5' | 'claude-sonnet-5' | '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.6-sol' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | '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' | 'grok-4-5' | 'composer-2.5-fast' | 'glm-5.2' | 'glm-5.1' | 'glm-5v-turbo' | 'deepseek-v4-pro' | 'glm-5-turbo' | 'glm-4.7' | 'kimi-k3' | 'kimi-k2.7-code' | 'kimi-k2.6' | 'qwen3-coder'
buildSpeed'fast' | 'standard'
browserSnapshotIdsstring[]
attachmentUrlsstring[]
tagsstring[]
reliabilityInvestigationIdstring
Response
Success
idstring required
projectIdstring required
titlestring nullable required
status'active' | 'idle' | 'archived' required
Coarse Captain run-loop status retained for compatibility. Prefer runState/waitingOn/blockedOn for completion and waiting UX.
runState'running' | 'stopping' | 'queued' | 'waiting' | 'blocked' | 'ready' | 'archived' required
Full computed execution state for the agent thread.
waitingOnstring[] required
Async system dependencies expected to continue without user action.
blockedOnstring[] required
User/integration gates required before progress can continue.
pendingWakeupsinteger required
Pending append-and-resume notifications waiting to be processed.
createdAtstring required