Overall
Features
How To
API Reference
- Authentication
- Messages
- Topics
- Schedules
- Signing Keys
- Events
- Dead Letter Queues
- v1 (Deprecated)
Migrating
Recipes
Integrations
Events
List Events
List all events that happened, such as message creation or delivery
GET
/
v2
/
events
curl https://qstash.upstash.io/v2/events \
-H "Authorization: Bearer <token>"
{
"cursor": "1686652644442-12",
"events":[
{
"time": "1686652644442",
"messageId": "msg_123",
"state": "delivered",
"url": "https://example.com",
}
]
}
Request
By providing a cursor you can paginate through all of the events.
Response
A cursor which you can use in subsequent requests to paginate through all events. If no cursor is returned, you have reached the end of the events.
Timestamp of this log entry, in milliseconds
The associated message id
The current state of the message at this point in time.
Value | Description |
---|---|
CREATED | The message has been accepted and stored in QStash |
RETRY | The task has been scheduled to retry. |
ACTIVE | The task is currently being processed by a worker. |
ERROR | The execution threw an error and the task is waiting to be retried or failed. |
DELIVERED | The message was successfully delivered. |
FAILED | The task has errored too many times or encountered an error that it cannot recover from. |
An explanation what went wrong
The next scheduled time of the message. (Unix timestamp in milliseconds)
The destination url
The name of the topic if this message was sent through a topic
The name of the endpoint if this message was sent through a topic
curl https://qstash.upstash.io/v2/events \
-H "Authorization: Bearer <token>"
{
"cursor": "1686652644442-12",
"events":[
{
"time": "1686652644442",
"messageId": "msg_123",
"state": "delivered",
"url": "https://example.com",
}
]
}
Was this page helpful?
curl https://qstash.upstash.io/v2/events \
-H "Authorization: Bearer <token>"
{
"cursor": "1686652644442-12",
"events":[
{
"time": "1686652644442",
"messageId": "msg_123",
"state": "delivered",
"url": "https://example.com",
}
]
}