Skip to main content
POST
/
v1
/
threads
/
{id}
/
runs
curl -X POST https://api.crewship.dev/v1/threads/thr_xyz789abc/runs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {"message": "Tell me about AI agents"}
  }'

{
  "run_id": "run_abc123xyz",
  "thread_id": "thr_xyz789abc",
  "version_id": "ver_xyz789",
  "version_number": 3,
  "status": "running"
}

Documentation Index

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

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

​
Path Parameters

​
id
string
required
Thread ID

​
Request

​
input
object
Input data passed to your crew
​
environment
string
default:"production"
Environment: production or staging

​
Response

Returns HTTP 202 (Accepted).
​
run_id
string
Run ID
​
thread_id
string
Thread ID
​
version_id
string
Version ID used for this run
​
version_number
integer
Version number used for this run
​
status
string
Run status: running

​
Notes

  • The thread must be in idle status. If busy, returns 409.
  • Thread is automatically set to busy during execution.
  • Thread state is updated and a checkpoint is created on completion.
curl -X POST https://api.crewship.dev/v1/threads/thr_xyz789abc/runs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {"message": "Tell me about AI agents"}
  }'

{
  "run_id": "run_abc123xyz",
  "thread_id": "thr_xyz789abc",
  "version_id": "ver_xyz789",
  "version_number": 3,
  "status": "running"
}