Skip to main content
POST
Start a manual run of an enabled automation
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

POST /ai/automations//run trigger_source is always manual:user on this route. Not plan-gated — manual runs are available on every tier — but subject to the service’s own concurrency (1 live run per automation) and the FREE-tier monthly run quota (10/month; uncapped on paid tiers). The run row is written before the workflow starts, so a refused or throwing start is still visible in run history. Authorization: any authenticated tenant member.

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Path Parameters

templateId
enum<string>
required
Available options:
statement-notify-artists,
royalty-file-anomaly-hold,
catalog-hygiene,
release-delivery

Body

application/json
idempotency_key
string

Supplied by event subscribers (P2) so a redelivered event is a no-op. Ignored for manual UI runs.

Response

Automation started (or an idempotent replay of a prior run)

status
string
Example:

"success"

message
string
data
object