Docs / API / Check a task

Check a task

What became of anything that answered 202.

2 min read All plans

GET /api/v1/tasks/{id}

One place answers for every request that returns a task_id, rather than a different poll for each kind of work.

STATUSWHAT IT MEANSWHAT TO DO

pending Queued, not started. Check again shortly.

running Being worked on now. Check again shortly.

completed Done. output carries the result. Read output.

failed error says what went wrong, in a sentence. Show the sentence; it is written for a person.

GOOD TO KNOW Polling works, but webhooks are better for anything that takes minutes — you get told rather than asking.

CURL

curl "https://console.quqi.io/api/v1/tasks/01a0…?website_id=019feda8-0ca6-70d1-b927-697fa6650cda" \
  -H "Authorization: Bearer quqi_YOUR_KEY"

RESPONSE

{
  "success": true,
  "data": {
    "task": {
      "id": "01a0…",
      "status": "completed",
      "type": "generate",
      "output": {
        "image_url": "https://cdn.quqi.io/images/abc.webp"
      },
      "duration": "14s"
    }
  }
}

Did this page answer your question? Yes Not quite

The picture library

Add a webhook