---
title: "GET /api/v1/organizations/{organization_id}/automations"
method: GET
path: "/api/v1/organizations/{organization_id}/automations"
tags: ["organizations"]
---

# GET /api/v1/organizations/{organization_id}/automations

`GET /api/v1/organizations/{organization_id}/automations`

## Request

- Base URL: `https://composal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://composal.com/api/v1/organizations/{organization_id}/automations`
- Auth: HTTP bearer

## Path parameters

- `organization_id` string, required

## Query parameters

- `agent_triggerable` boolean
- `limit` integer
- `cursor` string

## Response `200`

Automation response

- object
  - `pagination` AutomationPagination, required
    - `limit` integer, required
    - `next` string
  - `automations` AutomationRecord[], required
    - `agent_action` object, nullable
      - `revision` integer
      - `prompt` string
      - `input_schema` object, nullable
      - `output_mode` string
      - `output_schema` object, nullable
      - `tools` string[]
    - `id` string, required
    - `organization_id` string
    - `slug` string, required
    - `name` string, required
    - `revision` integer, required
    - `status` 'draft' | 'active' | 'paused' | 'archived', required
    - `configuration` AutomationStoredConfiguration, required
      - `execution` 'agent' | 'evaluation'
      - `evaluation` AutomationEvaluationDefinition
        - `model` string, required
        - `state` object, required
          - `source` 'triggering_change', required
          - `include` string[], required: Must contain changed_paths followed by diff_hunks.
        - `questions` object, required
        - `rules` object[], required: One rule per question, with distinct criteria and at_most less than at_least.
          - `question` string, required
          - `criterion` string, required
          - `description` string, required
          - `at_least` number, required
          - `at_most` number, required
      - `result_audience` string[]: Explicit organization member IDs allowed to read integration results after every source owner grants this revision. Empty means the common source owner only.
      - `connections` string[]: Explicit connection public IDs; every selected account requires an owner grant for this exact revision.
      - `change_output` object
        - `target_branch` string, required: Fixed target branch for propose_change. Requires repository context and the proposal execution release gate.
      - `signal_output` AutomationSignalOutput
        - `kind` string, required
        - `severity` 'info' | 'warning' | 'error' | 'critical', required
      - `cooldown` AutomationCooldown
        - `key` 'hosted_app' | 'repository' | 'subject' | 'source', required
        - `seconds` integer, required
      - `context` AutomationRepositoryContext
        - `mode` 'none' | 'repository' | 'trigger_change', required
        - `repository_id` string
        - `ref` string
        - `base_ref` string
        - `path_prefix` string
      - `tools` string[]
      - `max_tool_calls` integer
      - `skills` AutomationStoredSkillReference[]
        - `repository_id` string, required
        - `revision` string, required: Original Git SHA or retained historical native revision.
        - `path` string, required
        - `sha256` string, required
        - `files` AutomationSkillFile[]
          - `path` string, required
          - `sha256` string, required
      - `prompt` string
      - `model_provider` 'openai' | 'azure-openai'
      - `model` 'gpt-5.6-luna'
      - `output_mode` 'text' | 'json' | 'none' | 'artifacts'
      - `input_schema` object
      - `output_schema` object
      - `condition` object
      - `trigger` object
      - `max_concurrent_runs` integer: Active runs across this Automation, still subject to organization admission limits.
      - `max_automatic_attempts_per_hour` integer: Automatic attempts across this Automation in a rolling hour, including execution retries and uncertain starts.
      - `execution_retries` integer: Optional read-only execution retries (defaults to zero for agents; omitted for evaluations). Token budget is reserved across all possible attempts; every attempt retains the first execution deadline.
      - `max_tokens` integer
      - `deadline_seconds` integer: Maximum 60 seconds for evaluation mode; 300 for agent mode.
      - `triggers` object[]
    - `next_due_at` string, date-time, nullable
    - `active_revision_number` integer, nullable
    - `triggers` object[]

## Other responses

- `401`: Authentication required
- `403`: Organization admin access or automation authority required
- `404`: Resource not found
- `409`: Revision or idempotency conflict
- `422`: Invalid definition, input or execution gate
- `502`: Bad gateway

---

[API](https://skmtc.dev/composal/apis/vex-api.md) - [All operations](https://skmtc.dev/composal/apis/vex-api/llms.txt) - [OpenAPI document](https://skmtc.dev/composal/apis/vex-api/revisions/45c6fc7914b1?raw)