Making Your First Request

Submit a prompt to the Developer API and poll for the final result.

Submit a Task

curl https://taskforceai.chat/api/v1/developer/run \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Analyze the risks in this deployment plan",
    "options": {
      "silent": false,
      "mock": false
    }
  }'

Response

{
  "taskId": "task_1699123456789_abc123def",
  "status": "processing",
  "message": "Task submitted successfully"
}

Check Status

curl https://taskforceai.chat/api/v1/developer/status/task_1699123456789_abc123def \
  -H "x-api-key: YOUR_API_KEY"

Completed tasks include a result field:

{
  "taskId": "task_1699123456789_abc123def",
  "status": "completed",
  "result": "Final synthesized response..."
}

Advanced Options

Requests can include model selection, task budget, attachments, role model overrides, and bring-your-own Vercel AI Gateway keys. See the REST API documentation for the complete request shape.