Activate brand

Brand activated; returns the brand and the validation report that gated activation.

POST /v1/brands/{brand_id}/activate

cURL

curl --request POST \
  --url 'https://api.workstream.stateset.com/v1/brands/{brand_id}/activate' \
  --header "x-api-key: $STATESET_TEMPORAL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "expected_config_version": 1
}'

200

{
  "brand": {
    "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": null,
        "template_key": null,
        "template_version": null,
        "task_queue": null,
        "enabled": null,
        "deterministic_config": null
      }
    ]
  },
  "validation": {
    "valid": true,
    "errors": [
      "string"
    ],
    "warnings": [
      "string"
    ],
    "checks": [
      {
        "code": null,
        "ok": null,
        "message": null
      }
    ],
    "readiness": {
      "activation_ready": true,
      "self_service_ready": true,
      "summary": "Two-person tent, green — replacement for damaged pole set.",
      "steps": []
    }
  }
}

Path parameters

brand_id · string (uuid) · required

Request body

object

expected_config_version · integer

Response

object

brand · object · required

Brand record

Show brand

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

validation · object · required

Validation report

Show validation

valid · boolean · required

errors · string[] · required

warnings · string[] · required

checks · object[] · required

Show checks

code · string · required

ok · boolean · required

message · string · required

readiness · object

Show readiness

activation_ready · boolean · required

self_service_ready · boolean · required

summary · string · required

steps · object[] · required

Status codes

Code	Meaning
200	Brand activated; returns the brand and the validation report that gated activation.
400	Validation error
401	Unauthorized
404	Not found
429	Rate limited
500	Internal error

cURL

curl --request POST \
  --url 'https://api.workstream.stateset.com/v1/brands/{brand_id}/activate' \
  --header "x-api-key: $STATESET_TEMPORAL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "expected_config_version": 1
}'

200

{
  "brand": {
    "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": null,
        "template_key": null,
        "template_version": null,
        "task_queue": null,
        "enabled": null,
        "deterministic_config": null
      }
    ]
  },
  "validation": {
    "valid": true,
    "errors": [
      "string"
    ],
    "warnings": [
      "string"
    ],
    "checks": [
      {
        "code": null,
        "ok": null,
        "message": null
      }
    ],
    "readiness": {
      "activation_ready": true,
      "self_service_ready": true,
      "summary": "Two-person tent, green — replacement for damaged pole set.",
      "steps": []
    }
  }
}