API Documentation

Async Task Flow

Every endpoint except /healthz returns HTTP 202 with a typed task object. Poll links.self, or provide callback_url for webhook events (task.completed / task.failed). The legacy status_url field is still included for backward compatibility.

HTTP/1.1 202 Accepted
Location: https://droidapps.one/task/task_1748200000000_abc123xyz
Retry-After: 5

{
  "object": "task",
  "id": "task_1748200000000_abc123xyz",
  "status": "queued",
  "endpoint": "/cut",
  "created_at": "2026-05-25T12:00:00+00:00",
  "error": null,
  "links": {
    "self": "https://droidapps.one/task/task_1748200000000_abc123xyz",
    "download": null
  },
  "status_url": "https://droidapps.one/task/task_1748200000000_abc123xyz"
}

Webhook Payload

POST to your callback_url when the task completes or fails:
{
  "object": "event",
  "id": "evt_1748200000000_abc123xyz",
  "type": "task.completed",
  "created_at": "2026-05-25T12:00:05+00:00",
  "data": {
    "object": {
      "object": "task",
      "id": "task_abc123def456",
      "status": "completed",
      "endpoint": "/cut",
      "created_at": "2025-01-01T00:00:00+00:00",
      "completed_at": "2025-01-01T00:00:05+00:00",
      "error": null,
      "links": {
        "self": "https://droidapps.one/task/task_abc123def456",
        "download": "https://droidapps.one/task/task_abc123def456/download"
      },
      "output": {
        "file_url": "https://droidapps.one/task/task_abc123def456/download",
        "file_name": "cut_abc123def456.mp4",
        "file_size": 1234567,
        "duration": 10.5,
        "media_type": "video/mp4"
      }
    }
  }
}