---
title: "List automation invocations"
method: GET
path: "/agents/automations/{automation_id}/invocations"
tags: ["Agents"]
---

# List automation invocations

`GET /agents/automations/{automation_id}/invocations`

## Request

- Base URL: `https://api.openai.com/v1`
- URL: `https://api.openai.com/v1/agents/automations/{automation_id}/invocations`
- Auth: HTTP bearer

Lists delivery records for a project-owned automation.

## Path parameters

- `automation_id` string, required

## Query parameters

- `limit` integer
- `order` 'asc' | 'desc': The order in which paginated resources are returned.
- `after` string

## Response `200`

The invocation history.

- object: A page of Agents API resources, with IDs for retrieving additional pages.
  - `object` 'list', required: The object type, which is always `list`.
  - `data` AutomationInvocationResource[], required: The resources returned in this page, in the requested sort order.
    - `id` string, required: The invocation ID.
    - `object` 'agent.automation.invocation', required: Always `agent.automation.invocation`.
    - `automation_id` string, required: The automation that owns the invocation.
    - `created_at` integer, required: The creation time as a Unix timestamp in seconds.
    - `source` union, required
      - object
        - `type` 'manual', required: The type of the object. Always `manual`.
      - object
        - `type` 'automation', required: The type of the object. Always `automation`.
        - `automation` union, required: A saved automation and its schedule.
          - object: Fields shared by periodic and one-time automations.
            - `type` 'periodic', required: The type of the object. Always `periodic`.
            - `id` string, required: The automation ID.
            - `object` 'agent.automation', required: Always `agent.automation`.
            - `created_at` integer, required: The creation time as a Unix timestamp in seconds.
            - `name` string, required: The automation's display name.
            - `target` union, required: Saved target configuration, excluding confidential request-only values.
              - …
            - `metadata` object, required: Custom string key-value pairs attached to the automation.
            - `created_by` union, required: How the automation was created, independently of how an invocation started.
              - …
            - `expression` string, required: The cron expression determining scheduled occurrences.
            - `timezone` string, required: The timezone used to interpret the expression.
            - `status` 'active' | 'paused', required
          - object: Fields shared by periodic and one-time automations.
            - `type` 'once', required: The type of the object. Always `once`.
            - `id` string, required: The automation ID.
            - `object` 'agent.automation', required: Always `agent.automation`.
            - `created_at` integer, required: The creation time as a Unix timestamp in seconds.
            - `name` string, required: The automation's display name.
            - `target` union, required: Saved target configuration, excluding confidential request-only values.
              - …
            - `metadata` object, required: Custom string key-value pairs attached to the automation.
            - `created_by` union, required: How the automation was created, independently of how an invocation started.
              - …
            - `run_at` integer, required: The Unix timestamp, in seconds, of the scheduled occurrence.
            - `status` 'active' | 'paused' | 'completed', required
    - `scheduled_at` integer, nullable, required: The intended occurrence as a Unix timestamp in seconds, or null for manual runs.
    - `session_id` string, nullable, required: The target or newly created session ID, or null before one is available.
    - `status` 'queued' | 'completed' | 'failed' | 'skipped', required
    - `skip_reason` 'pending_delivery' | 'null', nullable, required: Why an occurrence was skipped, or null when it was not skipped.
    - `error` AutomationInvocationErrorResource, required
      - `code` string, required: A machine-readable error code.
      - `message` string, required: A public explanation of the delivery failure.
  - `first_id` string, nullable, required: The ID of the first resource in `data`, or `null` if the page is empty.
  - `last_id` string, nullable, required: The ID of the last resource in `data`, or `null` if the page is empty. Pass this as `after` with the same order and filters.
  - `has_more` boolean, required: Whether there are more resources to retrieve after this page.

## Other responses

- `400`: The request was invalid.
- `401`: Authentication or project context was missing.
- `403`: The API key lacks the required permission.
- `404`: The requested session or event was not found.
- `409`: The request conflicted with the current session state.
- `500`: An internal error occurred.
- `501`: This operation is not implemented.
- `503`: The service is temporarily unavailable.

## Changes

- **2026-10-23** `adcff4143658`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openai/apis/openapi/changes/agents/automations/:automation_id/invocations/get.md)

---

[API](https://skmtc.dev/openai/apis/openapi.md) - [All operations](https://skmtc.dev/openai/apis/openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/openai/apis/openapi/revisions/b7f3ab500153?raw)