Skip to main content
To check task status, send a GET request to:
https://api.turbofiles.io/tasks/{taskId}
The response includes a data.attributes.status field that will have one of these values:
  • PENDING: Task is queued but not yet started
  • PROCESSING: Task is currently being processed
  • COMPLETED: Task has finished successfully
  • FAILED: Task encountered an error and could not complete
For completed tasks, the response will include output file information in the included field. To download the processed file, use the signed URL provided in the links.download field of the output file object.

Webhook Notifications

(Coming soon)
POST /tasks/{taskId} HTTP/1.1
Accept: application/vnd.api+json
Content-Type: application/vnd.api+json
{
  "jsonapi": {
    "version": "1.1"
  },
  "links": {
    "self": "<string>"
  },
  "data": {
    "type": "tasks",
    "id": "<string>",
    "attributes": {
      "public": false,
      "created_at": "2023-01-01T00:00:00.000000Z",
      "updated_at": "2023-01-02T00:00:00.000000Z",
      "settings": {},
      "format": {
        "input": "image/png",
        "output": "image/avif"
      },
      "started_at": "2023-01-03T00:00:00.000000Z",
      "processed_at": "2023-01-04T00:00:00.000000Z",
      "processing_metadata": {},
      "status": "COMPLETED"
    },
    "relationships": {
      "input": {
        "data": {
          "type": "files",
          "id": "<string>"
        },
        "links": {
          "self": "<string>",
          "related": "<string>"
        }
      },
      "output": {
        "data": {
          "type": "files",
          "id": "<string>"
        },
        "links": {
          "self": "<string>",
          "related": "<string>"
        }
      }
    },
    "links": {
      "self": "<string>"
    }
  },
  "included": [
    {
      "type": "files",
      "id": "8fhd83jpk",
      "attributes": {
        "format": "image/png",
        "size": 504233,
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z"
      },
      "links": {
        "self": "<string>",
        "upload": "<string>",
        "download": "<string>"
      }
    }
  ]
}