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