Tasks

List tasks

List the organization's tasks, most recent first, with cursor pagination. Filter by status (or active), api_key_id, and a created_after/created_before range; pass fields=summary to leave out input/output (recommended for polling — then fetch GET /v1/tasks/{id} for the payload).

get/v1/tasks

Request

  • Base URL: https://api.hotapi.ai
  • URL: https://api.hotapi.ai/v1/tasks
  • Auth: HTTP bearer

Query parameters

limitstring

Max results (default 20, max 100).

cursorstring

Pagination cursor from a prior next_cursor.

statusstring

Filter by lifecycle status, or active for everything not yet terminal (pending, queued, processing).

qstring

Free-text search over task id / model / task kind.

fieldsstring

full (default) includes input and output; summary omits both. Prefer summary when polling a list — an inlined image input can be megabytes.

api_key_idstring

Only tasks created by this API key of the organization.

created_afterstring

ISO 8601. Only tasks created at or after this instant.

created_beforestring

ISO 8601 (exclusive). Only tasks created before this instant.

Response

A page of tasks. fields=full (default) returns TaskList; fields=summary returns TaskListSummary.

OR

Example response

{
  "data": [
    {
      "id": "task_8sd9f7aQ2",
      "model": "z-image-spicy",
      "task_kind": "image.generate",
      "error": {
        "type": "provider_error",
        "code": "generation_failed",
        "message": "Generation failed"
      },
      "estimated_credits_cost": 26,
      "api_key_id": "ak_8sd9f7aQ2"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.