Add a trigger to an automation

curl -X POST https://api.ara.so/v3/organizations/orgId/automations/automationId/triggers \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "frequency": "0 3 * * *"
}'

{
  "id": "string",
  "kind": "schedule",
  "enabled": true,
  "schedule": {
    "kind": "cron",
    "expression": "string",
    "every_seconds": 1,
    "next_run_at": "2024-01-15T09:30:00Z"
  },
  "github": {
    "event": "string",
    "action": "string",
    "repo": "string"
  },
  "webhook": {
    "configured": true
  },
  "run_kind": "string",
  "last_fired_at": "2024-01-15T09:30:00Z",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z"
}

Provide exactly one schedule: a frequency cron expression for recurring runs, every_seconds for a fixed interval, or a scheduled_at timestamp for a one-time run.

_{Scope: automations:write}

Authentication

AuthorizationBearer

Your ara_ API key from Settings > Ara API. Keys are capability-scoped: run, plugins:read, secrets:read, secrets:write, sessions:read, knowledge:read, repos:read, repos:write, reviews:read, reviews:write, analytics:read, org:read, org:write, attachments:read, attachments:write, plugins:write, guardrails:read, guardrails:write.

Path parameters

orgIdstringRequired

Organization id or slug. Resolve it with GET /v3/self.

automationIdstringRequired

Request

This endpoint expects an object.

frequencystringOptional

Cron expression, e.g. 0 3 * * *, for a recurring trigger.

every_secondsintegerOptional

Fixed interval in seconds. Alternative to frequency.

scheduled_atdatetimeOptional

Run-at time for a one-time trigger. Alternative to frequency.

enabledbooleanOptionalDefaults to true

Response

Created.

idstringOptional

kindenumOptional

enabledbooleanOptional

scheduleobject or nullOptional

githubobject or nullOptional

webhookobject or nullOptional

run_kindstring or nullOptional

last_fired_atdatetime or nullOptional

created_atdatetimeOptional

updated_atdatetimeOptional

Errors

400

Bad Request Error

404

Not Found Error