Update a tag

View as Markdown

Renames a tag and/or re-parents it. Rejects cycles (a tag under itself or a descendant) with 422. Requires action:manage.

Authentication

AuthorizationBearer

WorkOS session JWT or an organization API key, sent as Authorization: Bearer <token>.

Path parameters

tagIdstringRequired

Request

This endpoint expects an object.
labelstringOptional1-200 characters
parentIdstring or nullOptional>=1 character

Response

The updated tag.
tagobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error