Skip to main content
POST
Bulk update prompts
Applies the requested operation to each accessible prompt and returns a per-item outcome. This endpoint uses idempotency instead of per-prompt ETags. Use Update a prompt when you need a conditional update against one known version. Requires an active Business, Agency Business or Enterprise plan. Use an API token with write access enabled. See Writing data for idempotency, conditional requests and error handling.
string
required
Bearer token for your team.
string
required
Unique key for this operation. Completed responses replay for 24 hours.
string
required
Workspace identifier. The workspace must belong to the token’s team.
string
required
archive, restore, frequency, topic or tags.
string[]
required
Between 1 and 20 prompt UUIDs. Duplicate IDs are processed once.
string | null
Required for frequency: NONE, DAILY, WEEKLY, MONTHLY, or null to inherit the workspace schedule.
string | null
Required for topic: a topic UUID in the workspace, or null to detach.
string[]
Required for tags: the complete replacement list, at most 50 tag UUIDs. Send [] to remove all tags except the system tag of each prompt, if any. In a workspace created from v1.21, Qwairy sets the Branded or Non-branded system tag from each prompt text. The id of either system tag in this list is ignored, and the tag each prompt already carries is kept.
boolean
default:"false"
Validate the request and return the per-item results without changing anything.

Response

Returns 200 with operation, updated and results. Inspect every result even when the HTTP request succeeds: updated counts only items whose status is updated. Archiving keeps answers and history.

Synthetic request and response

Errors

Invalid operations or payloads return 400 INVALID_REQUEST. An inaccessible workspace, topic or tag returns 404 RESOURCE_NOT_FOUND. Missing prompt IDs are reported per item instead. See Error codes for authentication, plan, idempotency and server errors. On 429, honor Retry-After; writes can return 503 SERVICE_UNAVAILABLE if the write limiter is unavailable.