Skip to main content
PATCH
Update a topic
Renames one topic. Its prompt associations and retained answers are preserved. 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
Copy the complete ETag from the latest GET, including its quotes.
string
required
Workspace identifier. The workspace must belong to the token’s team.
string
required
Topic identifier within this workspace.
string
required
Topic text, 1 to 255 characters after trimming.

Response

Returns 200 with a topic object in the same shape as Get a topic and a new ETag. The mutation response has no top-level success field. Treat versions as opaque values, not counters.

Synthetic request and response

Read the current topic first. This example assumes its ETag is "4".

Errors

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.