API Reference: Task Management Endpoints
Programmatically create, update, and manage tasks via REST API. Full authentication and example requests included.
Authentication
All API requests require a Bearer token. Generate one in Settings → API Keys.
``
Authorization: Bearer YOUR_API_KEY
Create Task
POST /api/v1/tasks
Request body:
`json`
{
"project_id": "proj_abc123",
"title": "Update landing page copy",
"assigned_to": "user_def456",
"due_date": "2024-02-15",
"priority": "high",
"dependencies": ["task_xyz789"]
}
Response:
`json`
{
"id": "task_new123",
"status": "open",
"created_at": "2024-01-20T14:32:00Z"
}
Update Task Status
PATCH /api/v1/tasks/{task_id}
Request body:
`json`
{
"status": "completed",
"completed_at": "2024-01-20T16:45:00Z"
}
List Project Tasks
GET /api/v1/projects/{project_id}/tasks
Query parameters:
- status=open|completed|blocked
- assigned_to=user_id
- sort=due_date|priority`
Rate limits: 1000 requests/hour per API key.