Referencia

Queues

A queue chains analyses across several lots. Read-only here: enqueuing and running consumes credits and storage, and stays a manual action inside Kaax.

GET/api/v2/queues

The account's saved queues, with their steps.

Parámetros

pageintegeroptionaldefault 1

Page number, starting at 1.

limitintegeroptionaldefault 20 · max 100

Results per page.

GET/api/v2/queue-runs

The enqueued or executed runs, with the status of each step.

Parámetros

statusstringoptionalpending · claimed · running · completed · failed · cancelled

Filters by run status.

pageintegeroptionaldefault 1

Page number, starting at 1.

limitintegeroptionaldefault 20 · max 100

Results per page.

Response

json
{
  "total": 1,
  "page": 1,
  "limit": 20,
  "data": [
    {
      "id": "6a7a90ca3daa44929f42a440",
      "name": "Campaña mayo",
      "queueId": "6a7a8ca87a894f021d2224a7",
      "status": "completed",
      "estimatedHa": 18.4,
      "steps": [
        {
          "order": 1,
          "lotId": "6a7a8c177a894f021d22249e",
          "analysisType": "counting",
          "status": "completed",
          "analysisId": "675a93c456a2f093c8c4651f",
          "finishedAt": "2026-05-14T18:22:34.159Z"
        }
      ]
    }
  ]
}

A tener en cuenta

  • This is the endpoint you poll to learn a queue finished: Kaax has no push notifications.
  • A finished step's `analysisId` is what links it to the result in `GET /api/v2/analyses`.