Create brand

Create brand

POST /v1/brands

cURL

curl --request POST \
  --url 'https://api.workstream.stateset.com/v1/brands' \
  --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"
}'

201

{
  "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
      }
    ]
  },
  "idempotent_replay": true
}

Request body

BrandInput

slug · string

name · string

tenant_id · string (uuid)

status · string

routing_mode · string

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

idempotent_replay · boolean · required

Status codes

Code	Meaning
201	Brand created.
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' \
  --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"
}'

201

{
  "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
      }
    ]
  },
  "idempotent_replay": true
}