From 0bbb0d8e20c33dab61b0287c0abb58775776fb39 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mehmet=20Tokg=C3=B6z?= Date: Tue, 12 May 2026 14:57:08 +0300 Subject: [PATCH 1/2] Document multiple label per workflow run/message. --- qstash/openapi.yaml | 124 ++++++++++++++++++++++++++++++++------ workflow/openapi.yaml | 136 +++++++++++++++++++++++++++++++++++------- 2 files changed, 222 insertions(+), 38 deletions(-) diff --git a/qstash/openapi.yaml b/qstash/openapi.yaml index 8795c54f..df439cec 100644 --- a/qstash/openapi.yaml +++ b/qstash/openapi.yaml @@ -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. @@ -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 @@ -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. @@ -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: @@ -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 @@ -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 @@ -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 @@ -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: @@ -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 @@ -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: @@ -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: @@ -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 diff --git a/workflow/openapi.yaml b/workflow/openapi.yaml index 8aaa02ca..30bd4817 100644 --- a/workflow/openapi.yaml +++ b/workflow/openapi.yaml @@ -106,7 +106,13 @@ components: description: IP address of the publisher of this workflow. label: type: string - description: The label assigned to the workflow run. + deprecated: true + description: The label assigned to the workflow run. Deprecated in favor of `labels`. + labels: + type: array + items: + type: string + description: The list of labels assigned to the workflow run. flowControlKey: type: string description: The flow control key used for rate limiting. @@ -252,7 +258,13 @@ components: description: The DLQ ID if the workflow run failed (only in RUN_FAILED). label: type: string - description: Label of the workflow run. + deprecated: true + description: Label of the workflow run. Deprecated in favor of `labels`. + labels: + type: array + items: + type: string + description: List of labels assigned to the workflow run. callerIp: type: string description: IP address of the client who submitted the workflow. @@ -458,7 +470,13 @@ components: description: The DLQ ID if the workflow run failed. label: type: string - description: Label assigned to the workflow run. + deprecated: true + description: Label assigned to the workflow run. Deprecated in favor of `labels`. + labels: + type: array + items: + type: string + description: List of labels assigned to the workflow run. flowControlKey: type: string description: Flow Control Key assigned to the workflow run. @@ -535,7 +553,12 @@ paths: required: false schema: type: string - description: Optional label to attach to the workflow run for easier identification in logs and DLQ. + description: | + Optional label(s) to attach to the workflow run for easier identification in logs and DLQ. + + You can assign multiple labels by providing a comma-separated list. + + Example: `label_1,label_2` - in: header name: Upstash-Flow-Control-Key required: false @@ -805,8 +828,17 @@ paths: name: label required: false schema: - type: string - description: Optional label to filter workflow runs to cancel. + type: array + items: + type: string + style: form + explode: true + description: | + Optional label to filter workflow runs to cancel. Supports multi-value filtering. You can pass multiple values to match workflow runs with any of the given labels (OR logic). + + Examples: + - `label=my_label` + - `label=label_1&label=label_2` - in: query name: count required: false @@ -934,9 +966,17 @@ paths: name: label required: false schema: - type: string + type: array + items: + type: string + style: form + explode: true description: | - Filter workflow run by the label assigned by the user. + Filter workflow run by label. Supports multi-value filtering. You can pass multiple values to match workflow runs with any of the given labels (OR logic). + + Examples: + - `label=my_label` + - `label=label_1&label=label_2` - in: query name: flowControlKey required: false @@ -1055,8 +1095,17 @@ paths: name: label required: false schema: - type: string - description: Filter by label assigned to the workflow run. + type: array + items: + type: string + style: form + explode: true + description: | + Filter by label assigned to the workflow run. Supports multi-value filtering. You can pass multiple values to match workflow runs with any of the given labels (OR logic). + + Examples: + - `label=my_label` + - `label=label_1&label=label_2` - in: query name: failureFunctionState required: false @@ -1186,8 +1235,17 @@ paths: name: label required: false schema: - type: string - description: Filter by label assigned to the workflow run. + type: array + items: + type: string + style: form + explode: true + description: | + Filter by label assigned to the workflow run. Supports multi-value filtering. You can pass multiple values to match workflow runs with any of the given labels (OR logic). + + Examples: + - `label=my_label` + - `label=label_1&label=label_2` - in: query name: failureFunctionState required: false @@ -1395,7 +1453,12 @@ paths: required: false schema: type: string - description: Override the label for the remaining workflow steps. + description: | + Override the label(s) for the remaining workflow steps. + + You can assign multiple labels by providing a comma-separated list. + + Example: `label_1,label_2` - in: header name: Upstash-Failure-Callback required: false @@ -1519,8 +1582,17 @@ paths: name: label required: false schema: - type: string - description: Filter workflows by label assigned by the user. + type: array + items: + type: string + style: form + explode: true + description: | + Filter workflows by label. Supports multi-value filtering. You can pass multiple values to match workflows with any of the given labels (OR logic). + + Examples: + - `label=my_label` + - `label=label_1&label=label_2` - in: query name: failureFunctionState required: false @@ -1582,7 +1654,12 @@ paths: required: false schema: type: string - description: Override the label for the remaining workflow steps. + description: | + Override the label(s) for the remaining workflow steps. + + You can assign multiple labels by providing a comma-separated list. + + Example: `label_1,label_2` - in: header name: Upstash-Failure-Callback required: false @@ -1689,7 +1766,12 @@ paths: required: false schema: type: string - description: Override the label for the workflow. + description: | + Override the label(s) for the workflow. + + You can assign multiple labels by providing a comma-separated list. + + Example: `label_1,label_2` - in: header name: Upstash-Failure-Callback required: false @@ -1806,8 +1888,17 @@ paths: name: label required: false schema: - type: string - description: Filter workflows by label assigned by the user. + type: array + items: + type: string + style: form + explode: true + description: | + Filter workflows by label. Supports multi-value filtering. You can pass multiple values to match workflows with any of the given labels (OR logic). + + Examples: + - `label=my_label` + - `label=label_1&label=label_2` - in: query name: failureFunctionState required: false @@ -1869,7 +1960,12 @@ paths: required: false schema: type: string - description: Override the label for the workflows. + description: | + Override the label(s) for the workflows. + + You can assign multiple labels by providing a comma-separated list. + + Example: `label_1,label_2` - in: header name: Upstash-Failure-Callback required: false From 316497979fe3ee506bd34e3c941e0fb958a6a1b4 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Fri, 15 May 2026 07:57:17 +0000 Subject: [PATCH 2/2] chore(llms): regenerate llms.txt and llms-full.txt --- llms-full.txt | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/llms-full.txt b/llms-full.txt index 17e1854d..0c62f8f2 100644 --- a/llms-full.txt +++ b/llms-full.txt @@ -8218,8 +8218,7 @@ curl -XPOST \ You can schedule an item to be added to a queue at a specified time. -```bash typescript -curl -XPOST \ +```typescript Typescript import { Client } from "@upstash/qstash"; const client = new Client({ token: "" });