curl https://api.crewship.dev/v1/runs/run_xyz789abc \
-H "Authorization: Bearer YOUR_API_KEY"
{
"id": "run_xyz789abc",
"version_id": "ver_abc123xyz",
"deployment_id": "dep_abc123xyz",
"status": "running",
"input": {
"topic": "AI agents"
},
"output": null,
"error_message": null,
"created_at": "2024-01-15T10:35:00Z",
"started_at": "2024-01-15T10:35:02Z",
"completed_at": null
}
{
"id": "run_xyz789abc",
"version_id": "ver_abc123xyz",
"deployment_id": "dep_abc123xyz",
"status": "succeeded",
"input": {
"topic": "AI agents"
},
"output": {
"result": "Generated report about AI agents..."
},
"error_message": null,
"created_at": "2024-01-15T10:35:00Z",
"started_at": "2024-01-15T10:35:02Z",
"completed_at": "2024-01-15T10:35:47Z"
}
{
"id": "run_xyz789abc",
"version_id": "ver_abc123xyz",
"deployment_id": "dep_abc123xyz",
"status": "failed",
"input": {
"topic": "AI agents"
},
"output": null,
"error_message": "OpenAI API rate limit exceeded",
"created_at": "2024-01-15T10:35:00Z",
"started_at": "2024-01-15T10:35:02Z",
"completed_at": "2024-01-15T10:35:05Z"
}
Runs
Get Run
Retrieve a specific run by ID
GET
/
v1
/
runs
/
{id}
curl https://api.crewship.dev/v1/runs/run_xyz789abc \
-H "Authorization: Bearer YOUR_API_KEY"
{
"id": "run_xyz789abc",
"version_id": "ver_abc123xyz",
"deployment_id": "dep_abc123xyz",
"status": "running",
"input": {
"topic": "AI agents"
},
"output": null,
"error_message": null,
"created_at": "2024-01-15T10:35:00Z",
"started_at": "2024-01-15T10:35:02Z",
"completed_at": null
}
{
"id": "run_xyz789abc",
"version_id": "ver_abc123xyz",
"deployment_id": "dep_abc123xyz",
"status": "succeeded",
"input": {
"topic": "AI agents"
},
"output": {
"result": "Generated report about AI agents..."
},
"error_message": null,
"created_at": "2024-01-15T10:35:00Z",
"started_at": "2024-01-15T10:35:02Z",
"completed_at": "2024-01-15T10:35:47Z"
}
{
"id": "run_xyz789abc",
"version_id": "ver_abc123xyz",
"deployment_id": "dep_abc123xyz",
"status": "failed",
"input": {
"topic": "AI agents"
},
"output": null,
"error_message": "OpenAI API rate limit exceeded",
"created_at": "2024-01-15T10:35:00Z",
"started_at": "2024-01-15T10:35:02Z",
"completed_at": "2024-01-15T10:35:05Z"
}
Path Parameters
string
required
Run ID (e.g.,
run_xyz789abc)Response
string
Run ID
string
Version ID
string
Deployment ID
string
Run status:
pending, running, succeeded, failed, canceledobject
Input provided when creating the run
object
Final output (only present when succeeded)
string
Error message (only present when failed)
string
When the run was created (ISO 8601)
string
When execution started (ISO 8601), or
nullstring
When the run finished (ISO 8601), or
nullcurl https://api.crewship.dev/v1/runs/run_xyz789abc \
-H "Authorization: Bearer YOUR_API_KEY"
{
"id": "run_xyz789abc",
"version_id": "ver_abc123xyz",
"deployment_id": "dep_abc123xyz",
"status": "running",
"input": {
"topic": "AI agents"
},
"output": null,
"error_message": null,
"created_at": "2024-01-15T10:35:00Z",
"started_at": "2024-01-15T10:35:02Z",
"completed_at": null
}
{
"id": "run_xyz789abc",
"version_id": "ver_abc123xyz",
"deployment_id": "dep_abc123xyz",
"status": "succeeded",
"input": {
"topic": "AI agents"
},
"output": {
"result": "Generated report about AI agents..."
},
"error_message": null,
"created_at": "2024-01-15T10:35:00Z",
"started_at": "2024-01-15T10:35:02Z",
"completed_at": "2024-01-15T10:35:47Z"
}
{
"id": "run_xyz789abc",
"version_id": "ver_abc123xyz",
"deployment_id": "dep_abc123xyz",
"status": "failed",
"input": {
"topic": "AI agents"
},
"output": null,
"error_message": "OpenAI API rate limit exceeded",
"created_at": "2024-01-15T10:35:00Z",
"started_at": "2024-01-15T10:35:02Z",
"completed_at": "2024-01-15T10:35:05Z"
}
⌘I