UPupstash
DLQ

Bulk Delete DLQ messages

Changed on

Delete multiple messages from the DLQ

delete/v2/dlq

Request

Query parameters

dlqIdsstring[]

List of DLQ IDs to delete. If provided, other filters are ignored.

cursorstring

By providing a cursor you can paginate through all of the messages in the DLQ

messageIdstring

Filter DLQ messages by message ID

urlstring[]

Filter DLQ messages by destination URL. Supports multiple values.

topicNamestring[]

Filter DLQ messages by URL Group name. Supports multiple values.

scheduleIdstring[]

Filter DLQ messages by schedule ID. Supports multiple values.

queueNamestring[]

Filter DLQ messages by queue name. Supports multiple values.

fromDateinteger

Filter DLQ messages by starting date, in milliseconds (Unix timestamp). This is inclusive.

toDateinteger

Filter DLQ messages by ending date, in milliseconds (Unix timestamp). This is inclusive.

responseStatusinteger[]

Filter DLQ messages by HTTP response status code of the last delivery attempt. Supports multiple values.

callerIpstring[]

Filter DLQ messages by IP address of the publisher. Supports multiple values.

labelstring[]

Filter DLQ messages by label. Supports multiple values. You can pass multiple values to match messages with any of the given labels (OR logic).

Examples:

  • label=my_label
  • label=label_1&label=label_2
  • label=label_1,label_2
flowControlKeystring[]

Filter DLQ messages by Flow Control Key. Supports multiple values.

countinteger

The number of messages to delete.

Response

DLQ messages deleted successfully

cursorstring

A cursor which you can use in subsequent requests to paginate through all messages. If no cursor is returned, you have reached the end of the messages.

deletedinteger

The number of messages that were deleted.

Changes

  • 9bff0f72df49Revision changes
    • info

      for the query request parameter callerIp, the type was generalized from string to array

    • info

      for the query request parameter flowControlKey, the type was generalized from string to array

    • info

      for the query request parameter queueName, the type was generalized from string to array

    • info

      for the query request parameter responseStatus, the type was generalized from integer to array

    • info

      for the query request parameter scheduleId, the type was generalized from string to array

    • info

      for the query request parameter topicName, the type was generalized from string to array

    • info

      for the query request parameter url, the type was generalized from string to array

  • d30bd0904328Revision changes
    • info

      for the query request parameter label, the type was generalized from string to array