Run dispatch guard

Guard evaluation: planned (and, with apply, applied) routing-mode rollbacks for unhealthy brands.

POST /v1/dispatch/guard

cURL

curl --request POST \
  --url 'https://api.workstream.stateset.com/v1/dispatch/guard' \
  --header "x-api-key: $STATESET_TEMPORAL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "apply": true,
  "minimum_health_status": "string",
  "max_actions": 1
}'

200

{
  "generated_at": "2026-08-31T14:22:05Z",
  "tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "apply": true,
  "minimum_health_status": "string",
  "max_actions": 1,
  "window_minutes": 1,
  "summary": {
    "total_brands_scanned": 1,
    "candidate_brands": 1,
    "planned_actions": 1,
    "applied_actions": 1,
    "failed_actions": 1,
    "truncated_candidates": 1
  },
  "actions": [
    {
      "tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenant_name": "string",
      "brand_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "brand_slug": "acme-outdoors",
      "health_status": "string",
      "current_stage": "string",
      "current_routing_mode": "string",
      "target_stage": "string",
      "target_routing_mode": "string",
      "action": "string",
      "reason": "Two-person tent, green — replacement for damaged pole set.",
      "alerts": [],
      "applied": true,
      "error": "string"
    }
  ]
}

Request body

object

tenant_id · string

apply · boolean

minimum_health_status · string

Defaults to ‘critical’

max_actions · integer

Response

object

generated_at · string (date-time) · required

tenant_id · string (uuid)

apply · boolean · required

minimum_health_status · string · required

max_actions · integer · required

window_minutes · integer · required

summary · object · required

Show summary

total_brands_scanned · integer · required

candidate_brands · integer · required

planned_actions · integer · required

applied_actions · integer · required

failed_actions · integer · required

truncated_candidates · integer · required

actions · object[] · required

Show actions

tenant_id · string (uuid) · required

tenant_name · string · required

brand_id · string (uuid) · required

brand_slug · string · required

health_status · string · required

current_stage · string · required

current_routing_mode · string · required

target_stage · string · required

target_routing_mode · string · required

action · string · required

reason · string · required

alerts · string[] · required

applied · boolean · required

error · string

Status codes

Code	Meaning
200	Guard evaluation: planned (and, with apply, applied) routing-mode rollbacks for unhealthy brands.
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/dispatch/guard' \
  --header "x-api-key: $STATESET_TEMPORAL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "apply": true,
  "minimum_health_status": "string",
  "max_actions": 1
}'

200

{
  "generated_at": "2026-08-31T14:22:05Z",
  "tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "apply": true,
  "minimum_health_status": "string",
  "max_actions": 1,
  "window_minutes": 1,
  "summary": {
    "total_brands_scanned": 1,
    "candidate_brands": 1,
    "planned_actions": 1,
    "applied_actions": 1,
    "failed_actions": 1,
    "truncated_candidates": 1
  },
  "actions": [
    {
      "tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenant_name": "string",
      "brand_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "brand_slug": "acme-outdoors",
      "health_status": "string",
      "current_stage": "string",
      "current_routing_mode": "string",
      "target_stage": "string",
      "target_routing_mode": "string",
      "action": "string",
      "reason": "Two-person tent, green — replacement for damaged pole set.",
      "alerts": [],
      "applied": true,
      "error": "string"
    }
  ]
}