---
title: "Get an automation invocation"
method: GET
path: "/agents/automations/{automation_id}/invocations/{invocation_id}"
tags: ["Agents"]
---

# Get an automation invocation

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

## Request

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

Retrieves a delivery record for a project-owned automation.

## Path parameters

- `automation_id` string, required
- `invocation_id` string, required

## Response `200`

The invocation.

- AutomationInvocationResource: One attempted delivery by an automation.
  - `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.
            - object
              - …
            - object
              - …
          - `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.
            - object
              - …
            - object
              - …
          - `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.
            - object
              - …
            - object
              - …
          - `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.
            - object
              - …
            - object
              - …
          - `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.

## 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.
- `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/:invocation_id/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)