---
title: "Search Workflow Executions"
method: POST
path: "/api/v1beta/workflow_executions/search"
tags: ["Workflows"]
---

# Search Workflow Executions

`POST /api/v1beta/workflow_executions/search`

Invokes the c1.api.workflows.v1beta.WorkflowExecutionSearchService.SearchWorkflowExecutions method.

## Request body

- C1ApiWorkflowsV1betaSearchWorkflowExecutionsRequest — The SearchWorkflowExecutionsRequest message.
  - `executionStepStates` string[], nullable — The executionStepStates field.
  - `expandMask` C1ApiWorkflowsV1betaWorkflowExecutionExpandMask — The WorkflowExecutionExpandMask message.
    - `paths` string[], nullable — The paths field.
  - `pageSize` integer — The pageSize field.
  - `pageToken` string — The pageToken field.
  - `query` string — The query field.
  - `refs` C1ApiWorkflowsV1betaWorkflowExecutionRef[], nullable — The refs field.
    - `id` string, int64 — The id field.
  - `workflowTemplateId` string — The workflowTemplateId field.

## Response `200`

Successful response

- C1ApiWorkflowsV1betaSearchWorkflowExecutionsResponse — The SearchWorkflowExecutionsResponse message.
  - `expanded` object[], nullable — The expanded field.
    - `@type` string — The type of the serialized message.
  - `list` C1ApiWorkflowsV1betaWorkflowExecutionView[], nullable — The list field.
    - `workflowExecution` C1ApiWorkflowsV1betaWorkflowExecution — The WorkflowExecution message.
      - `completedAt` string, date-time
      - `context` C1ApiWorkflowsV1betaWorkflowContext — The WorkflowContext message.
        - `context` object
      - `createdAt` string, date-time
      - `deletedAt` string, date-time
      - `duration` string, duration
      - `id` string, int64 — The id field.
      - `state` 'WORKFLOW_EXECUTION_STATE_UNSPECIFIED' | 'WORKFLOW_EXECUTION_STATE_PENDING' | 'WORKFLOW_EXECUTION_STATE_CREATING' | 'WORKFLOW_EXECUTION_STATE_GET_STEP' | 'WORKFLOW_EXECUTION_STATE_PROCESS_STEP' | 'WORKFLOW_EXECUTION_STATE_COMPLETE_STEP' | 'WORKFLOW_EXECUTION_STATE_DONE' | 'WORKFLOW_EXECUTION_STATE_ERROR' | 'WORKFLOW_EXECUTION_STATE_TERMINATE' — The state field.
      - `updatedAt` string, date-time
      - `workflowTemplateId` string — The workflowTemplateId field.
    - `workflowExecutionTriggerPath` string — The workflowExecutionTriggerPath field.
    - `workflowPath` string — The workflowPath field.
  - `nextPageToken` string — The nextPageToken field.

## Changes

- **2025-04-10** `17f9f3bcedd5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1beta/workflow_executions/search/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/17f9f3bcedd5/schema)