Skip to content

QSTH-740: Multiple label per workflow run/message #698

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
CahidArda merged 3 commits into from
May 15, 2026
+223 −40
Merged

QSTH-740: Multiple label per workflow run/message #698

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
0bbb0d8
Document multiple label per workflow run/message.
mehmettokgoz May 12, 2026
74286a3
Merge branch 'main' into QSTH-740
CahidArda May 15, 2026
3164979
chore(llms): regenerate llms.txt and llms-full.txt
github-actions[bot] May 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 1 addition & 2 deletions llms-full.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8218,8 +8218,7 @@ curl -XPOST \
You can schedule an item to be added to a queue at a specified time.

<CodeGroup>
```bash typescript
curl -XPOST \
```typescript Typescript
import { Client } from "@upstash/qstash";

const client = new Client({ token: "<QSTASH_TOKEN>" });
Expand Down
124 changes: 106 additions & 18 deletions qstash/openapi.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -111,7 +111,13 @@ components:
description: IP address of the publisher of this message.
label:
type: string
description: The label of the message assigned by the user.
deprecated: true
description: The label of the message assigned by the user. Deprecated in favor of `labels`.
labels:
type: array
items:
type: string
description: The list of labels assigned to the message by the user.
flowControlKey:
type: string
description: The flow control key used for rate limiting.
Expand Down Expand Up @@ -241,9 +247,15 @@ components:
retryDelayExpression:
type: string
description: The retry delay expression used for calculating retry delays
label:
label:
type: string
description: The label assigned to the scheduled message
deprecated: true
description: The label assigned to the scheduled message. Deprecated in favor of `labels`.
labels:
type: array
items:
type: string
description: The list of labels assigned to the scheduled message.
lastScheduleTime:
type: integer
format: int64
Expand Down Expand Up @@ -381,7 +393,13 @@ components:
description: IP address of the publisher of this message.
label:
type: string
description: The label of the message assigned by the user.
deprecated: true
description: The label of the message assigned by the user. Deprecated in favor of `labels`.
labels:
type: array
items:
type: string
description: The list of labels assigned to the message by the user.
flowControlKey:
type: string
description: The flow control key used for rate limiting.
Expand Down Expand Up @@ -514,7 +532,13 @@ components:
description: The retry delay expression used for calculating retry delays
label:
type: string
description: The label assigned to the message
deprecated: true
description: The label assigned to the message. Deprecated in favor of `labels`.
labels:
type: array
items:
type: string
description: The list of labels assigned to the message.
paths:
/v2/publish/{destination}:
post:
Expand Down Expand Up @@ -671,7 +695,11 @@ paths:
schema:
type: string
description: |
Label to assign to the message for easier identification and filtering in logs and DLQ.
Label(s) to assign to the message for easier identification and filtering in logs and DLQ.

You can assign multiple labels by providing a comma-separated list.

Example: `label_1,label_2`

- name: Upstash-Flow-Control-Key
in: header
Expand Down Expand Up @@ -993,7 +1021,11 @@ paths:
schema:
type: string
description: |
Label to assign to the message for easier identification and filtering in logs and DLQ.
Label(s) to assign to the message for easier identification and filtering in logs and DLQ.

You can assign multiple labels by providing a comma-separated list.

Example: `label_1,label_2`

- name: Upstash-Deduplication-Id
in: header
Expand Down Expand Up @@ -1313,8 +1345,17 @@ paths:
in: query
required: false
schema:
type: string
description: Filter messages by label.
type: array
items:
type: string
style: form
explode: true
description: |
Filter messages by label. Supports multi-value filtering. 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`
- name: flowControlKey
in: query
required: false
Expand Down Expand Up @@ -1787,6 +1828,17 @@ paths:
- `body, header[Authorization]`: Redact the body and the Authorization header
- `body, headers`: Redact both body and all headers

- name: Upstash-Label
in: header
schema:
type: string
description: |
Label(s) to assign to the scheduled message for easier identification and filtering in logs and DLQ.

You can assign multiple labels by providing a comma-separated list.

Example: `label_1,label_2`

requestBody:
description: The raw request message passed to the endpoints as is
content:
Expand Down Expand Up @@ -2124,15 +2176,24 @@ paths:
- name: label
in: query
schema:
type: string
description: Filter DLQ messages by the label of the message assigned by the user
type: array
items:
type: string
style: form
explode: true
description: |
Filter DLQ messages by label. Supports multi-value filtering. 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`
- name: count
in: query
schema:
type: integer
default: 100
maximum: 100
description: The number of messages to return.
description: The number of messages to return.
responses:
'200':
description: List of DLQ messages
Expand Down Expand Up @@ -2218,8 +2279,17 @@ paths:
- name: label
in: query
schema:
type: string
description: Filter DLQ messages by the label of the message assigned by the user
type: array
items:
type: string
style: form
explode: true
description: |
Filter DLQ messages by label. Supports multi-value filtering. 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`
- name: flowControlKey
in: query
schema:
Expand Down Expand Up @@ -2414,8 +2484,17 @@ paths:
- name: label
in: query
schema:
type: string
description: Filter DLQ messages by the label of the message assigned by the user
type: array
items:
type: string
style: form
explode: true
description: |
Filter DLQ messages by label. Supports multi-value filtering. 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`
- name: flowControlKey
in: query
schema:
Expand Down Expand Up @@ -2812,8 +2891,17 @@ paths:
- name: label
in: query
schema:
type: string
description: Filter logs by the label of the message assigned by the user
type: array
items:
type: string
style: form
explode: true
description: |
Filter logs by label. Supports multi-value filtering. 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`
responses:
'200':
description: List of logs
Expand Down
Loading