Skip to main content
POST
https://api.crewship.dev
/
v1
/
deployments
curl -X POST https://api.crewship.dev/v1/deployments \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project": "my-crew",
    "build_context_url": "https://builds.crewship.dev/abc123",
    "message": "Add PDF export feature"
  }'

{
  "data": {
    "id": "dep_abc123xyz",
    "project": "my-crew",
    "status": "building",
    "message": "Add PDF export feature",
    "created_at": "2024-01-15T10:30:00Z"
  }
}

​
Request

​
project
string
required
Project name
​
build_context_url
string
required
Pre-signed URL to the uploaded build context (obtained from init endpoint)
​
message
string
Deployment message (like a commit message)
​
git_sha
string
Git commit SHA for this deployment

​
Response

​
id
string
Deployment ID (e.g., dep_abc123xyz)
​
project
string
Project name
​
status
string
Deployment status: pending, building, active, failed
​
created_at
string
ISO 8601 timestamp
curl -X POST https://api.crewship.dev/v1/deployments \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project": "my-crew",
    "build_context_url": "https://builds.crewship.dev/abc123",
    "message": "Add PDF export feature"
  }'

{
  "data": {
    "id": "dep_abc123xyz",
    "project": "my-crew",
    "status": "building",
    "message": "Add PDF export feature",
    "created_at": "2024-01-15T10:30:00Z"
  }
}
Most deployments are created via crewship deploy which handles the upload and API calls. Use this endpoint directly for custom CI/CD integrations.