---
title: "Search Automation Executions"
method: POST
path: "/api/v1/search/automation_executions"
tags: ["Automations"]
---

# Search Automation Executions

`POST /api/v1/search/automation_executions`

Search for automation executions with optional filters for automation_template_id, state, and query.
 Each AutomationExecutionView row is large — request a small page_size (≤10) and set expand_mask to only the paths you need; broad expansion inlines whole related objects and bloats the response.

## Request body

- C1ApiAutomationsV1SearchAutomationExecutionsRequest — The SearchAutomationExecutionsRequest message.
  - `automationTemplateId` string — Filter results to executions of this automation template.
  - `executionId` string, int64 — Filter results to a specific execution by its numeric identifier.
  - `executionStepStates` string[], nullable — Filter results to executions in any of the specified states.
  - `expandMask` C1ApiAutomationsV1AutomationExecutionExpandMask — The AutomationExecutionExpandMask message.
    - `paths` string[], nullable — The paths field.
  - `pageSize` integer — Maximum number of results to return per page.
  - `pageToken` string — Pagination token from a previous SearchAutomationExecutionsResponse.
  - `query` string — Free-text search query to filter executions.
  - `refs` C1ApiAutomationsV1AutomationExecutionRef[], nullable — Restrict results to specific execution references.
    - `id` string, int64 — The id field.

## Response `200`

Successful response

- C1ApiAutomationsV1SearchAutomationExecutionsResponse — The SearchAutomationExecutionsResponse message.
  - `expanded` object[], nullable — Related objects requested via the expand mask.
    - `@type` string — The type of the serialized message.
  - `list` C1ApiAutomationsV1AutomationExecutionView[], nullable — The page of execution views matching the search criteria.
    - `automationExecution` C1ApiAutomationsV1AutomationExecution — The AutomationExecution message.
      - `automationTemplateId` string — The automationTemplateId field.
      - `completedAt` string, date-time, nullable
      - `context` C1ApiAutomationsV1AutomationContext — The AutomationContext message.
        - `context` object, nullable
      - `createdAt` string, date-time, nullable
      - `currentVersion` integer — The currentVersion field.
      - `deletedAt` string, date-time, nullable
      - `duration` string, duration, nullable
      - `id` string, int64 — The id field.
      - `isDraft` boolean — The isDraft field.
      - `state` 'AUTOMATION_EXECUTION_STATE_UNSPECIFIED' | 'AUTOMATION_EXECUTION_STATE_PENDING' | 'AUTOMATION_EXECUTION_STATE_CREATING' | 'AUTOMATION_EXECUTION_STATE_GET_STEP' | 'AUTOMATION_EXECUTION_STATE_PROCESS_STEP' | 'AUTOMATION_EXECUTION_STATE_COMPLETE_STEP' | 'AUTOMATION_EXECUTION_STATE_DONE' | 'AUTOMATION_EXECUTION_STATE_ERROR' | 'AUTOMATION_EXECUTION_STATE_TERMINATE' | 'AUTOMATION_EXECUTION_STATE_WAITING' | 'AUTOMATION_EXECUTION_STATE_PAUSED_BY_CIRCUIT_BREAKER' — The state field.
      - `updatedAt` string, date-time, nullable
    - `automationExecutionTriggerPath` string — The automationExecutionTriggerPath field.
    - `automationPath` string — The automationPath field.
  - `nextPageToken` string — Token to retrieve the next page of results, empty when no more results exist.

## Changes

- **2026-08-21** `f2cf3228f366` — 5 breaking, 12 warning, 1 info
  - the request property `executionStepStates` became not nullable
  - the request property `refs` became not nullable
  - the `expandMask` request property type/format changed from `object`/`` to ``/``
  - added `#/components/schemas/c1.api.automations.v1.AutomationExecution, subschema #2` to the `list/items/automationExecution` response property `oneOf` list for the response status `200`
  - …14 more
- **2026-05-15** `f6e337c979e4` — 1 warning, 1 info
  - added the new `AUTOMATION_EXECUTION_STATE_PAUSED_BY_CIRCUIT_BREAKER` enum value to the `list/items/automationExecution/state` response property for the response status `200`
  - added the new `AUTOMATION_EXECUTION_STATE_PAUSED_BY_CIRCUIT_BREAKER` enum value to the request property `executionStepStates/items/`
- **2026-03-10** `7fa698b04b81` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/search/automation_executions/post.md)

---

[API](https://skmtc.dev/conductorone/apis/c1-api.md) · [All operations](https://skmtc.dev/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/f2cf3228f366/schema)