curl -X POST https://api.crewship.dev/v1/runs \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"deployment_id": "dep_abc123xyz",
"input": {
"topic": "AI agents",
"style": "technical"
}
}'
{
"run_id": "run_xyz789abc",
"version_id": "ver_abc123xyz",
"version_number": 3,
"status": "running"
}
{
"error": {
"message": "No running version found for production environment"
}
}
Runs
Create Run
Trigger a new run of your deployed crew
POST
/
v1
/
runs
curl -X POST https://api.crewship.dev/v1/runs \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"deployment_id": "dep_abc123xyz",
"input": {
"topic": "AI agents",
"style": "technical"
}
}'
{
"run_id": "run_xyz789abc",
"version_id": "ver_abc123xyz",
"version_number": 3,
"status": "running"
}
{
"error": {
"message": "No running version found for production environment"
}
}
Request
string
required
Deployment ID
object
Input data passed to your crew’s kickoff function
string
default:"production"
Environment to run in:
production or stagingResponse
Returns HTTP 202 (Accepted).string
Run ID (e.g.,
run_abc123xyz)string
Version ID used for this run
integer
Version number used for this run
string
Run status:
runningcurl -X POST https://api.crewship.dev/v1/runs \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"deployment_id": "dep_abc123xyz",
"input": {
"topic": "AI agents",
"style": "technical"
}
}'
{
"run_id": "run_xyz789abc",
"version_id": "ver_abc123xyz",
"version_number": 3,
"status": "running"
}
{
"error": {
"message": "No running version found for production environment"
}
}
Notes
- Runs are created and executed asynchronously
- Use the Stream Events endpoint to get real-time updates
- Poll the Get Run endpoint for completion status