API referenceAutomations

Set automation status

Sets the automation's status to ACTIVE (armed) or PAUSED.

PATCH
/v1/brands/{brandId}/automations/{automationId}/status
bearerAuth
headerAuthorizationBearer <token>

An organization API key (koast_sk_…) with the API surface enabled, or an OAuth access token issued by Koast (koast_at_…) whose audience covers this API. REST access requires an active Agency plan.

brandId*integer

The brand the request acts on. Every brand-scoped resource lives under its brand.

automationId*string
Match^[1-9]\d*$
Length1 <= length
application/json
  1. body
status*string
Value in"ACTIVE""PAUSED"

Response Body

Set automation status

application/json
  1. response
[key: string]?unknown
curl -X PATCH "https://example.com/v1/brands/0/automations/string/status" \  -H "Authorization: Bearer koast_sk_..." \  -H "Content-Type: application/json" \  -d '{    "status": "ACTIVE"  }'
{  "property1": null,  "property2": null}

Required scope: write. CLI: koast set-automation-status, see Automations commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.