Skip to main content
PATCH
Update Tag

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string

Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.

Example:

"550e8400-e29b-41d4-a716-446655440000"

Path Parameters

tag_id
string<uuid>
required

Body

application/json

Schema for updating a workflow tag

name
string | null
Required string length: 1 - 100
description
string | null
Maximum string length: 500
emoji
string | null
Maximum string length: 10
color
string | null
Maximum string length: 20
group_id
string<uuid> | null

Optional group for mutual exclusivity

is_archived
boolean | null

Archive tag to prevent new assignments

Response

Successful Response

Workflow tag response schema

name
string
required
Required string length: 1 - 100
id
string<uuid>
required
organization_id
string
required
order
integer
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
description
string | null
Maximum string length: 500
emoji
string | null
Maximum string length: 10
color
string | null
Maximum string length: 20
group_id
string<uuid> | null

Optional group for mutual exclusivity

is_archived
boolean
default:false
workflow_count
integer | null

Number of workflows with this tag (returned in list endpoint)

group
WorkflowTagGroupResponse · object | null

The group this tag belongs to