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}

身份验证

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.

路径参数

orgIdstring必需

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

automationIdstring必需

请求

This endpoint expects an object.

frequencystring可选

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

every_secondsinteger可选

Fixed interval in seconds. Alternative to frequency.

scheduled_atdatetime可选

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

enabledboolean可选默认为 true

响应

Created.

idstring可选

kindenum可选

enabledboolean可选

scheduleobject or null可选

githubobject or null可选

webhookobject or null可选

run_kindstring or null可选

last_fired_atdatetime or null可选

created_atdatetime可选

updated_atdatetime可选

错误

400

Bad Request Error

404

Not Found Error