List Deployments

List deployments for a project

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

cURL

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

Success

{
  "data": [
    {
      "id": "dep_abc123xyz",
      "project": "my-crew",
      "status": "active",
      "message": "Add PDF export feature",
      "created_at": "2024-01-15T10:30:00Z",
      "activated_at": "2024-01-15T10:32:15Z"
    },
    {
      "id": "dep_xyz789abc",
      "project": "my-crew",
      "status": "superseded",
      "message": "Initial deployment",
      "created_at": "2024-01-14T09:00:00Z",
      "activated_at": "2024-01-14T09:02:30Z"
    }
  ],
  "pagination": {
    "total": 15,
    "page": 1,
    "per_page": 20,
    "has_more": false
  }
}

Query Parameters

project · string · required

Project name to list deployments for

status · string

Filter by status: pending, building, active, failed, superseded

page · integer · default: "1"

Page number

per_page · integer · default: "20"

Items per page (max 100)

Response

data · array

Array of deployment objects

pagination · object

Pagination metadata

cURL

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

Success

{
  "data": [
    {
      "id": "dep_abc123xyz",
      "project": "my-crew",
      "status": "active",
      "message": "Add PDF export feature",
      "created_at": "2024-01-15T10:30:00Z",
      "activated_at": "2024-01-15T10:32:15Z"
    },
    {
      "id": "dep_xyz789abc",
      "project": "my-crew",
      "status": "superseded",
      "message": "Initial deployment",
      "created_at": "2024-01-14T09:00:00Z",
      "activated_at": "2024-01-14T09:02:30Z"
    }
  ],
  "pagination": {
    "total": 15,
    "page": 1,
    "per_page": 20,
    "has_more": false
  }
}