API Documentation

Everything you need to integrate with the DevStack API.

Home API Documentation

Authentication

All API requests require authentication via Bearer token. Include your API key in the Authorization header of every request.

curl -X GET https://api.devstack.io/v1/projects \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

You can generate API keys from your dashboard under Settings → API Keys.

Projects

Manage your DevStack projects programmatically.

GET /v1/projects

Returns a list of all projects in your workspace.

// Response
{
  "data": [
    {
      "id": "proj_abc123",
      "name": "My App",
      "status": "active",
      "created_at": "2026-01-15T10:30:00Z"
    }
  ],
  "total": 1
}

POST /v1/projects

Create a new project.

Deployments

Trigger, monitor, and roll back deployments via the API.

POST /v1/projects/:id/deploy

Trigger a new deployment for the specified project.

DELETE /v1/deployments/:id

Roll back a specific deployment.

Analytics

Retrieve analytics data for your projects.

GET /v1/analytics/:project_id

Webhooks

Configure webhooks to receive real-time notifications about events.

POST /v1/webhooks

Error Codes

DevStack uses standard HTTP status codes. Common errors include 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 429 Rate Limited, and 500 Internal Server Error.