List Runs

List runs for a project or deployment

GET https://api.crewship.dev/v1/runs

cURL

curl "https://api.crewship.dev/v1/runs?project=my-crew" \
  -H "Authorization: Bearer YOUR_API_KEY"

Success

{
  "data": [
    {
      "id": "run_xyz789abc",
      "deployment_id": "dep_abc123xyz",
      "project": "my-crew",
      "status": "succeeded",
      "created_at": "2024-01-15T10:35:00Z",
      "completed_at": "2024-01-15T10:35:47Z",
      "duration_ms": 45200
    },
    {
      "id": "run_def456ghi",
      "deployment_id": "dep_abc123xyz",
      "project": "my-crew",
      "status": "succeeded",
      "created_at": "2024-01-15T09:20:00Z",
      "completed_at": "2024-01-15T09:21:12Z",
      "duration_ms": 72000
    }
  ],
  "pagination": {
    "total": 156,
    "page": 1,
    "per_page": 20,
    "has_more": true
  }
}

Query Parameters

project · string

Filter by project name

deployment · string

Filter by deployment ID

status · string

Filter by status: pending, running, succeeded, failed, canceled

page · integer · default: "1"

Page number

per_page · integer · default: "20"

Items per page (max 100)

Response

data · array

Array of run objects

pagination · object

Pagination metadata

cURL

curl "https://api.crewship.dev/v1/runs?project=my-crew" \
  -H "Authorization: Bearer YOUR_API_KEY"

Success

{
  "data": [
    {
      "id": "run_xyz789abc",
      "deployment_id": "dep_abc123xyz",
      "project": "my-crew",
      "status": "succeeded",
      "created_at": "2024-01-15T10:35:00Z",
      "completed_at": "2024-01-15T10:35:47Z",
      "duration_ms": 45200
    },
    {
      "id": "run_def456ghi",
      "deployment_id": "dep_abc123xyz",
      "project": "my-crew",
      "status": "succeeded",
      "created_at": "2024-01-15T09:20:00Z",
      "completed_at": "2024-01-15T09:21:12Z",
      "duration_ms": 72000
    }
  ],
  "pagination": {
    "total": 156,
    "page": 1,
    "per_page": 20,
    "has_more": true
  }
}