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

# Get Versions

> Retrieve a paginated list of an action's published versions, newest first, for the action identified by the `id` path parameter. Each version includes its full JSON `content`, its `digestSRI`, and publication metadata; drafts are hidden from public clients. Supports pagination via `pageIndex` and `pageSize`. If the action does not exist or does not belong to the authenticated organization, an empty page is returned (`data: []`, `totalPages: 0`) rather than a 404.



## OpenAPI

````yaml /versions/2026-07-06.yaml get /actions/version/{id}
openapi: 3.1.0
info:
  title: Humanos API
  description: Humanos API
  version: '1.0'
  contact: {}
servers: []
security: []
tags:
  - name: humanosApp
    description: ''
paths:
  /actions/version/{id}:
    get:
      tags:
        - Actions
      summary: Get Versions
      description: >-
        Retrieve a paginated list of an action's published versions, newest
        first, for the action identified by the `id` path parameter. Each
        version includes its full JSON `content`, its `digestSRI`, and
        publication metadata; drafts are hidden from public clients. Supports
        pagination via `pageIndex` and `pageSize`. If the action does not exist
        or does not belong to the authenticated organization, an empty page is
        returned (`data: []`, `totalPages: 0`) rather than a 404.
      operationId: actions_versions
      parameters:
        - name: id
          required: true
          in: path
          description: MongoDB id of the action whose versions to list.
          schema:
            example: 507f1f77bcf86cd799439011
            type: string
        - name: pageIndex
          required: false
          in: query
          description: Zero-based page index. `0` returns the first page.
          schema:
            default: 0
            example: 0
            type: number
        - name: pageSize
          required: false
          in: query
          description: Number of items per page
          schema:
            minimum: 5
            maximum: 100
            default: 10
            example: 10
            type: number
        - name: search
          required: false
          in: query
          description: >-
            Search query to filter by. Is case-insensitive and does not need to
            match the entire value.
          schema:
            maxLength: 100
            example: example
            type: string
        - name: active
          required: false
          in: query
          description: Filter by active status. Accepts true/false as string or boolean.
          schema:
            example: true
            type: boolean
        - $ref: '#/components/parameters/ApiVersion'
      responses:
        '200':
          description: >-
            A paginated list of the action's published versions (each with its
            full content and integrity digest), plus the total page count.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionVersionListEntity'
        '400':
          description: >-
            A malformed action id (not a 24-character hex MongoDB id) or invalid
            query parameters.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    example: 400
                  message:
                    type: string
                    example: id is not a valid MongoDB id
                  error:
                    type: string
                    example: Bad Request
components:
  parameters:
    ApiVersion:
      name: API-Version
      in: header
      required: false
      schema:
        type: string
        pattern: ^\d{4}-\d{2}-\d{2}$
        example: '2026-07-06'
      description: >-
        Pin request, response, and webhook shapes to a specific dated API
        version (YYYY-MM-DD). Omit to use the version pinned to your API key
        (set when the key is created; new keys default to the latest version).
        New integrations should target the latest version.
  schemas:
    ActionVersionListEntity:
      type: object
      properties:
        data:
          description: The current page of action versions.
          type: array
          items:
            $ref: '#/components/schemas/ActionVersionDetailEntity'
        totalPages:
          type: number
          description: Total number of pages available for the current `pageSize`.
          example: 1
      required:
        - data
        - totalPages
    ActionVersionDetailEntity:
      type: object
      properties:
        id:
          type: string
          description: >-
            URN of the action version. Use this value as the version identifier
            when calling version endpoints.
          example: urn:via:action:abc-123
        actionId:
          type: string
          description: >-
            MongoDB identifier of the parent action. Note: unlike `id`, this is
            a MongoDB id, not a URN.
          example: 507f1f77bcf86cd799439011
        version:
          type: number
          description: >-
            Sequential version number of the action, starting at 1 and
            incremented on each new version.
          example: 1
        digestSRI:
          type: string
          description: >-
            Subresource Integrity digest (`sha256-<base64url>`) of the published
            version content; null until the version is published.
          example: sha256-47DEQpj8HBSaTImW5JCeuQeRkm5NMpJWZG3hSuFU
          nullable: true
        content:
          type: object
          description: >-
            JSON content of the action (target, userParams, executionParams,
            rules, mapper)
          example:
            target:
              method: POST
              domain: api.stripe.com
              path: /v1/payment_intents
            userParams:
              amount:
                description: Amount to charge, in the smallest currency unit (e.g. cents)
            executionParams:
              currency:
                description: ISO 4217 currency code
            rules:
              - name: max-amount
                description: Reject charges above 100.00 USD
                expression: userParams.amount <= 10000
            mapper:
              amount: amount
              currency: currency
          nullable: true
        published:
          type: boolean
          description: >-
            Whether this version is published. The public API only ever returns
            published versions, so this is always true here.
          example: true
        createdAt:
          format: date-time
          type: string
          description: ISO 8601 timestamp of when the version was created.
          example: '2025-01-01T00:00:00.000Z'
        updatedAt:
          format: date-time
          type: string
          description: ISO 8601 timestamp of when the version was last updated.
          example: '2025-01-02T00:00:00.000Z'
      required:
        - id
        - actionId
        - version
        - published
        - createdAt
        - updatedAt

````