> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracecat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Workflow Execution Collection Page

> Fetch a bounded page of collection item descriptors.



## OpenAPI

````yaml https://platform.tracecat.com/api/openapi.json post /workspaces/{workspace_id}/workflow-executions/{execution_id}/objects/collection/page
openapi: 3.1.0
info:
  title: Tracecat API
  summary: Tracecat API
  description: The open source AI automation platform for security teams and agents.
  termsOfService: >-
    https://docs.google.com/document/d/e/2PACX-1vQvDe3SoVAPoQc51MgfGCP71IqFYX_rMVEde8zC4qmBCec5f8PLKQRdxa6tsUABT8gWAR9J-EVs2CrQ/pub
  contact:
    name: Tracecat Founders
    email: founders@tracecat.com
  license:
    name: AGPL-3.0
    url: https://www.gnu.org/licenses/agpl-3.0.html
  version: '1'
servers:
  - url: /api
security: []
tags:
  - name: public
    description: Public facing endpoints
  - name: workflows
    description: Workflow management
  - name: actions
    description: Action management
  - name: triggers
    description: Workflow triggers
  - name: secrets
    description: Secret management
  - name: variables
    description: Workspace variable management
paths:
  /workspaces/{workspace_id}/workflow-executions/{execution_id}/objects/collection/page:
    post:
      tags:
        - workflow-executions
      summary: Get Workflow Execution Collection Page
      description: Fetch a bounded page of collection item descriptors.
      operationId: workflow-executions-get_workflow_execution_collection_page
      parameters:
        - name: workspace_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Workspace Id
        - name: execution_id
          in: path
          required: true
          schema:
            type: string
            title: Execution Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkflowExecutionCollectionPageRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowExecutionCollectionPageResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyCookie: []
        - ServiceAccountApiKeyBearer: []
components:
  schemas:
    WorkflowExecutionCollectionPageRequest:
      properties:
        event_id:
          type: integer
          minimum: 1
          title: Event Id
          description: Temporal history event ID
        field:
          $ref: '#/components/schemas/WorkflowExecutionObjectField'
          default: action_result
        offset:
          type: integer
          minimum: 0
          title: Offset
          description: Page start index (0-indexed)
          default: 0
        limit:
          type: integer
          maximum: 100
          minimum: 1
          title: Limit
          description: Maximum number of items to return
          default: 25
      type: object
      required:
        - event_id
      title: WorkflowExecutionCollectionPageRequest
    WorkflowExecutionCollectionPageResponse:
      properties:
        collection:
          $ref: '#/components/schemas/CollectionObject'
          description: Collection metadata for the requested result
        offset:
          type: integer
          minimum: 0
          title: Offset
          description: Requested page offset
        limit:
          type: integer
          minimum: 1
          title: Limit
          description: Requested page size
        next_offset:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          title: Next Offset
          description: Offset to use for next page, or null if no more items
        items:
          items:
            $ref: '#/components/schemas/WorkflowExecutionCollectionPageItem'
          type: array
          title: Items
          description: Collection page descriptors
      type: object
      required:
        - collection
        - offset
        - limit
      title: WorkflowExecutionCollectionPageResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    WorkflowExecutionObjectField:
      type: string
      enum:
        - action_result
      title: WorkflowExecutionObjectField
    CollectionObject:
      properties:
        typename:
          anyOf:
            - type: string
            - type: 'null'
          title: Typename
        type:
          type: string
          const: collection
          title: Type
        manifest_ref:
          $ref: '#/components/schemas/ObjectRef'
        count:
          type: integer
          title: Count
        chunk_size:
          type: integer
          title: Chunk Size
        element_kind:
          type: string
          enum:
            - value
            - stored_object
          title: Element Kind
        schema_version:
          type: integer
          title: Schema Version
          default: 1
        index:
          anyOf:
            - type: integer
            - type: 'null'
          title: Index
      type: object
      required:
        - type
        - manifest_ref
        - count
        - chunk_size
        - element_kind
      title: CollectionObject
      description: >-
        Handle to a collection manifest stored in blob storage.


        Represents huge collections without embedding list[StoredObject] in
        history.

        The manifest contains chunk references for paged access.


        This is a small, history-safe handle. The actual data lives in chunked

        blobs referenced by the manifest.


        Attributes:
            manifest_ref: Reference to the manifest blob containing chunk refs.
            count: Total number of elements in the collection.
            chunk_size: Number of items per chunk.
            element_kind: Whether elements are raw values or StoredObject handles.
            schema_version: Manifest schema version for forward compatibility.
    WorkflowExecutionCollectionPageItem:
      properties:
        index:
          type: integer
          minimum: 0
          title: Index
          description: Collection index for this item
        kind:
          $ref: '#/components/schemas/WorkflowExecutionCollectionPageItemKind'
          description: Descriptor type for this collection page item
        stored:
          anyOf:
            - oneOf:
                - $ref: '#/components/schemas/InlineObject'
                - $ref: '#/components/schemas/ExternalObject'
                - $ref: '#/components/schemas/CollectionObject'
              discriminator:
                propertyName: type
                mapping:
                  collection:
                    $ref: '#/components/schemas/CollectionObject'
                  external:
                    $ref: '#/components/schemas/ExternalObject'
                  inline:
                    $ref: '#/components/schemas/InlineObject'
            - type: 'null'
          title: Stored
          description: StoredObject descriptor when kind is stored_object_ref
        value_preview:
          anyOf:
            - type: string
            - type: 'null'
          title: Value Preview
          description: UTF-8 preview of serialized inline value when kind is inline_value
        value_size_bytes:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          title: Value Size Bytes
          description: Serialized inline value size in bytes when kind is inline_value
        truncated:
          type: boolean
          title: Truncated
          description: Whether value_preview was truncated
          default: false
      type: object
      required:
        - index
        - kind
      title: WorkflowExecutionCollectionPageItem
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    ObjectRef:
      properties:
        backend:
          type: string
          const: s3
          title: Backend
          default: s3
        bucket:
          type: string
          title: Bucket
        key:
          type: string
          title: Key
        size_bytes:
          type: integer
          title: Size Bytes
        sha256:
          type: string
          title: Sha256
        content_type:
          type: string
          title: Content Type
          default: application/json
        encoding:
          type: string
          enum:
            - json
            - json+zstd
            - json+gzip
          title: Encoding
          default: json
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
        - bucket
        - key
        - size_bytes
        - sha256
      title: ObjectRef
      description: >-
        Reference to an externalized object in blob storage.


        This is a typed reference that replaces large payloads in workflow
        context.

        Only dereference ObjectRef instances created by Tracecat - never
        arbitrary URIs.
    WorkflowExecutionCollectionPageItemKind:
      type: string
      enum:
        - stored_object_ref
        - inline_value
      title: WorkflowExecutionCollectionPageItemKind
    InlineObject:
      properties:
        typename:
          anyOf:
            - type: string
            - type: 'null'
          title: Typename
        type:
          type: string
          const: inline
          title: Type
        data:
          title: Data
      type: object
      required:
        - type
        - data
      title: InlineObject
      description: Data stored inline (not externalized).
    ExternalObject:
      properties:
        typename:
          anyOf:
            - type: string
            - type: 'null'
          title: Typename
        type:
          type: string
          const: external
          title: Type
        ref:
          $ref: '#/components/schemas/ObjectRef'
      type: object
      required:
        - type
        - ref
      title: ExternalObject
      description: Data externalized to blob storage.
  securitySchemes:
    APIKeyCookie:
      type: apiKey
      in: cookie
      name: fastapiusersauth
    ServiceAccountApiKeyBearer:
      type: http
      description: Tracecat service account API key.
      scheme: bearer

````