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}

Authentification

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.

Paramètres de chemin

orgIdstringRequis

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

automationIdstringRequis

Requête

This endpoint expects an object.

frequencystringOptionnel

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

every_secondsintegerOptionnel

Fixed interval in seconds. Alternative to frequency.

scheduled_atdatetimeOptionnel

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

enabledbooleanOptionnelPar défaut true

Réponse

Created.

idstringOptionnel

kindenumOptionnel

enabledbooleanOptionnel

scheduleobject or nullOptionnel

githubobject or nullOptionnel

webhookobject or nullOptionnel

run_kindstring or nullOptionnel

last_fired_atdatetime or nullOptionnel

created_atdatetimeOptionnel

updated_atdatetimeOptionnel

Erreurs

400

Bad Request Error

404

Not Found Error