List automations | Ara Documentation

{
  "items": [
    {
      "id": "a1b2c3d4-e5f6-7890-ab12-cdef34567890",
      "org_id": "dev-team-42",
      "name": "Daily Code Review Reminder",
      "instructions": "Send a daily reminder to the team to review open pull requests.",
      "model": "gpt-4",
      "enabled": true,
      "tools": {
        "mcp_servers": [
          "mcp-server-01"
        ],
        "app_tools": [
          "slack-notifier"
        ]
      },
      "environment": {
        "repo": "openai/ara",
        "provider": "github"
      },
      "triggers": [
        {
          "id": "trigger-1234abcd-5678-efgh-9012-ijklmnopqrst",
          "kind": "schedule",
          "enabled": true,
          "schedule": {
            "kind": "cron",
            "expression": "0 9 * * 1-5",
            "every_seconds": null,
            "next_run_at": "2024-06-01T09:00:00Z"
          },
          "github": {
            "event": null,
            "action": null,
            "repo": null
          },
          "webhook": {
            "configured": false
          },
          "run_kind": "scheduled",
          "last_fired_at": "2024-05-31T09:00:00Z",
          "created_at": "2024-01-15T09:30:00Z",
          "updated_at": "2024-05-31T09:00:00Z"
        }
      ],
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-05-31T09:00:00Z"
    }
  ],
  "end_cursor": "cursor_abcdef1234567890",
  "has_next_page": false
}

User-authored automations in the workspace, each with its triggers. System automations (repo/issue plumbing, connector bridges) are excluded by default; pass include=system to return them too. An automation with no triggers is included; it simply never fires on its own.

_{Scope: automations:read}

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.

Query parameters

firstintegerOptionalDefaults to 50

Page size (default 50, max 200).

afterstringOptional

Cursor from the previous page’s end_cursor.

includeenumOptional

By default only user-authored automations are returned. Pass system to also include system automations (repo/issue plumbing, connector bridges) that back product features.

Allowed values:

Response

Automations.

itemslist of objectsOptional

end_cursorstring or nullOptional

has_next_pagebooleanOptional

$	curl https://api.ara.so/v3/organizations/orgId/automations \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"