Update brand

The updated brand. Note: a workflow_bindings array in the patch replaces ALL of the brand’s bindings.

PATCH /v1/brands/{brand_id}

cURL

curl --request PATCH \
  --url 'https://api.workstream.stateset.com/v1/brands/{brand_id}' \
  --header "x-api-key: $STATESET_TEMPORAL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "slug": "acme-outdoors",
  "name": "Two-Person Tent",
  "tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "pending",
  "routing_mode": "string"
}'

200

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "slug": "acme-outdoors",
  "display_name": "Ada Lovelace",
  "status": "pending",
  "routing_mode": "string",
  "canary_percent": 8,
  "region": "CA",
  "default_locale": "string",
  "policy_set_key": "string",
  "quotas": {},
  "metadata": {},
  "config_version": 1,
  "config_fingerprint": "string",
  "activated_at": "2026-08-31T14:22:05Z",
  "created_at": "2026-08-31T14:22:05Z",
  "updated_at": "2026-08-31T14:22:05Z",
  "workflow_bindings": [
    {
      "workflow_type": "string",
      "template_key": "string",
      "template_version": 1,
      "task_queue": "string",
      "enabled": true,
      "deterministic_config": {}
    }
  ]
}

Path parameters

brand_id · string (uuid) · required

Request body

BrandInput

slug · string

name · string

tenant_id · string (uuid)

status · string

routing_mode · string

Response

object

id · string (uuid) · required

tenant_id · string (uuid) · required

slug · string · required

display_name · string · required

status · string · required

routing_mode · string · required

canary_percent · integer · required

region · string · required

default_locale · string · required

policy_set_key · string

quotas · object · required

metadata · object · required

config_version · integer · required

config_fingerprint · string · required

activated_at · string (date-time)

created_at · string (date-time) · required

updated_at · string (date-time) · required

workflow_bindings · object[] · required

Show workflow_bindings

workflow_type · string · required

template_key · string · required

template_version · integer · required

task_queue · string · required

enabled · boolean · required

deterministic_config · object · required

Status codes

Code	Meaning
200	The updated brand. Note: a workflow_bindings array in the patch replaces ALL of the brand’s bindings.
400	Validation error
401	Unauthorized
404	Not found
429	Rate limited
500	Internal error

cURL

curl --request PATCH \
  --url 'https://api.workstream.stateset.com/v1/brands/{brand_id}' \
  --header "x-api-key: $STATESET_TEMPORAL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "slug": "acme-outdoors",
  "name": "Two-Person Tent",
  "tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "pending",
  "routing_mode": "string"
}'

200

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "slug": "acme-outdoors",
  "display_name": "Ada Lovelace",
  "status": "pending",
  "routing_mode": "string",
  "canary_percent": 8,
  "region": "CA",
  "default_locale": "string",
  "policy_set_key": "string",
  "quotas": {},
  "metadata": {},
  "config_version": 1,
  "config_fingerprint": "string",
  "activated_at": "2026-08-31T14:22:05Z",
  "created_at": "2026-08-31T14:22:05Z",
  "updated_at": "2026-08-31T14:22:05Z",
  "workflow_bindings": [
    {
      "workflow_type": "string",
      "template_key": "string",
      "template_version": 1,
      "task_queue": "string",
      "enabled": true,
      "deterministic_config": {}
    }
  ]
}