Get Message Tasks

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

GET /v1/messages/{messageId}/tasks

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"
    }
  ]
}

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"
    }
  ]
}