List tasks

Your tasks, newest first, in pages. Each row carries the status and cost but not the request or the result — fetch those from the task itself.

GET/tasks
AuthAPI keyorOAuth tokenHow to send it

Query parameters#

limitinteger

How many tasks to return.

default 20≥ 1≤ 100
afterstring

Cursor: return tasks created before this task ID.

e.g. "tsk_01KE7XWWEQ4MCGWKBQKJ1G47RP"

Response#

200Tasks returned

dataobject[]required
coststring | nullrequired
createdAtanyrequired
idstringrequired
statusstringrequired
"completed""failed""pending"
typestringrequired
"image.alt""image.generate""image.rate""image.remove_background""image.review""video.generate"
updatedAtanyrequired

Errors#

A failed call names what went wrong in code, with a sentence in message. The codes, which of them are worth retrying, and how to read a validation failure are on Errors.