# List workflow executions

Returns a paginated list of workflow executions. Supports filtering by dataspace ID, status, workflow ID, and content ID. Since workflow executions are stored at the workspace level, dataspace filtering is optional.

Endpoint: GET /workflow-executions
Version: 1.0.0
Security: bearerAuth

## Query parameters:

  - `primaryScopeDataspaceId` (string)
    Optional filter by dataspace ID
    Example: "sds-abc12345"

  - `status` (string)
    Filter by execution status
    Enum: "started", "completed", "failed"

  - `workflowId` (string)
    Filter by workflow ID
    Example: "987fcdeb-51a2-43d1-9c4e-5f6e7d8c9a0b"

  - `primaryScopeObjectId` (string)
    Filter by primary scope object ID
    Example: "456e7890-e89b-12d3-a456-426614174001"

  - `limit` (integer)
    Number of items to return
    Example: 20

  - `offset` (integer,null)
    Number of items to skip

## Response 200 fields (application/json):

  - `items` (array, required)

  - `items.id` (string, required)
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `items.workflowId` (string, required)
    Example: "987fcdeb-51a2-43d1-9c4e-5f6e7d8c9a0b"

  - `items.primaryScopeObjectId` (string, required)
    Example: "456e7890-e89b-12d3-a456-426614174001"

  - `items.primaryScopeDataspaceId` (string, required)
    Short dataspace ID with sds- prefix
    Example: "sds-abc12345"

  - `items.status` (string, required)
    Enum: "started", "completed", "failed"

  - `items.startedAt` (string, required)
    Example: "2025-01-15T10:30:00Z"

  - `items.completedAt` (string,null, required)
    Example: "2025-01-15T10:35:00Z"

  - `items.errorMessage` (string,null, required)
    Example: "Workflow execution failed at step 3"

  - `totalCount` (integer, required)
    Example: 42

  - `limit` (integer, required)
    Example: 20

  - `offset` (integer, required)

## Response 401 fields (application/json):

  - `error` (string, required)
    Example: "Unauthorized"

  - `message` (string, required)
    Example: "Authentication required"

## Response 500 fields (application/json):

  - `error` (string, required)
    Example: "Internal Server Error"

  - `message` (string, required)
    Example: "An unexpected error occurred"