Developer API

Access the full power of DevHub's infrastructure through our clean, well-documented REST API.

Authentication

Bearer Token

All API requests must include an authorization header with a valid Bearer token.

Authorization: Bearer <your_access_token>

API Key

Generate API keys in your dashboard profile settings. Use this format:

X-API-Key: abcdef123456

Available Resources

Projects

Create Project

POST /api/v1/projects
{
  "name": "My Awesome Project",
  "description": "Description of the project"
}

List Projects

GET /api/v1/projects

Returns all projects for the authenticated user

Show Project

GET /api/v1/projects/{id}

Returns project details by ID

Tasks

Create Task

POST /api/v1/projects/{id}/tasks
{
  "title": "Implement login flow",
  "priority": "high"
}

List Tasks

GET /api/v1/projects/{id}/tasks

Returns all tasks for a project

Update Task

PATCH /api/v1/tasks/{id}
{
  "status": "completed"
}

Example Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "My First Project",
  "created_at": "2025-09-10T08:00:00.000Z",
  "members": [
    {
      "id": "660e8400-e29b-41d4-a716-446655440000",
      "name": "John Doe",
      "role": "OWNER"
    }
  ]
}

API Playground

Example: Create Project

Endpoint

POST /api/v1/projects

Headers

Authorization: Bearer <token>

Body

{
  "name": "My Sample Project",
  "description": "Created from the API docs"
}

Response

{
  "success": true,
  "message": "Project created successfully",
  "project": {
    "id": "b00d16d5-1e48-42c1-8f88-6a4076a73b4f",
    "name": "My Sample Project",
    "created_at": "2025-09-10T12:34:56.789Z"
  }
}

Status: 201 Created