---
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.

## 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
      - `context` C1ApiAutomationsV1AutomationContext — The AutomationContext message.
        - `context` object
      - `createdAt` string, date-time
      - `currentVersion` integer — The currentVersion field.
      - `deletedAt` string, date-time
      - `duration` string, duration
      - `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
    - `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.

---

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