Get Message Tasks

This endpoint returns the last 100 tasks in descending chronological order.
Use the cursor parameter to paginate.

Request

messageId

string

required

MessageId is the Id of the message to list tasks for.

cursor

int

Cursor is a unix timestamp with milliseconds precision. You can use it to paginate the results.

Response

cursor

int

If there are more logs, this is the cursor to use to get the next page. Returns 0 or undefined if there are no more logs.

tasks

Array<Task>

required

Show Task

completedAt

int

CompletedAt is the time when the task is processed successfully. Unix timestamp with millisecond precision

error

string

Error is the error message from the last failure.

lastErrorAt

int

LastErrorAt is the time time of the last failure if any. Unix timestamp with millisecond precision

maxRetry

int

required

MaxRetry is the maximum number of times the task can be retried.

messageId

string

required

Id is the identifier of the the message for this task.

nextProcessAt

int

NextProcessAt is the time the task is scheduled to be processed, Unix timestamp with millisecond precision

retried

int

required

Retried is the number of times the task has retried so far.

state

string

required

The current state of this task

taskId

string

required

Id is the identifier of the task.

url

string

required

URL is the destination where we should send the message.

curl

curl -X GET "https://qstash.upstash.io/v1/messages/msg_123/tasks" \
 -H "Authorization: Bearer <token>"

200

{
  "cursor": 1678901234567,
  "tasks": [
    {
      "completedAt": 1678901123456,
      "error": "",
      "lastErrorAt": 0,
      "maxRetry": 3,
      "messageId": "abc123",
      "nextProcessAt": 1678902000000,
      "retried": 2,
      "state": "processing",
      "taskId": "task001",
      "url": "https://example.com/task001"
    },
    {
      "completedAt": 1678900876543,
      "error": "Connection timeout",
      "lastErrorAt": 1678901800000,
      "maxRetry": 5,
      "messageId": "def456",
      "nextProcessAt": 1678902100000,
      "retried": 4,
      "state": "retrying",
      "taskId": "task002",
      "url": "https://example.com/task002"
    }
  ]
}