> ## 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 Actions

> Retrieve a paginated list of actions for the authenticated organization. Only published versions are ever exposed here; drafts are hidden from public clients. Each action includes up to its 10 most recent published versions (newest first); use GET /actions/version/{id} to page through the full version history. Supports `search` (case-insensitive partial match on the action name) and pagination via `pageIndex` and `pageSize`.



## OpenAPI

````yaml /versions/2026-07-06.yaml get /actions
openapi: 3.1.0
info:
  title: Humanos API
  description: Humanos API
  version: '1.0'
  contact: {}
servers: []
security: []
tags:
  - name: humanosApp
    description: ''
paths:
  /actions:
    get:
      tags:
        - Actions
      summary: Get Actions
      description: >-
        Retrieve a paginated list of actions for the authenticated organization.
        Only published versions are ever exposed here; drafts are hidden from
        public clients. Each action includes up to its 10 most recent published
        versions (newest first); use GET /actions/version/{id} to page through
        the full version history. Supports `search` (case-insensitive partial
        match on the action name) and pagination via `pageIndex` and `pageSize`.
      operationId: actions_list
      parameters:
        - 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 actions, each including its most recent
            published versions, plus the total page count.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionListEntity'
        '400':
          description: >-
            Invalid query parameters — e.g. a pageSize outside the 5–100 range,
            a search value longer than 100 characters, or an unrecognized query
            parameter.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    example: 400
                  message:
                    type: string
                    example: pageSize must not be greater than 100
                  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:
    ActionListEntity:
      type: object
      properties:
        data:
          description: The current page of actions.
          type: array
          items:
            $ref: '#/components/schemas/ActionEntity'
        totalPages:
          type: number
          description: Total number of pages available for the current `pageSize`.
          example: 1
      required:
        - data
        - totalPages
    ActionEntity:
      type: object
      properties:
        id:
          type: string
          description: >-
            MongoDB identifier of the action. Note: this is a MongoDB id, unlike
            a version `id`, which is a URN.
          example: 507f1f77bcf86cd799439011
        name:
          type: string
          description: Human-readable name of the action.
          example: Create Stripe Payment Intent
        description:
          type: string
          description: Optional human-readable description of the action.
          example: Authorize an agent to create a one-off payment intent on Stripe.
          nullable: true
        updatedAt:
          format: date-time
          type: string
          description: ISO 8601 timestamp of when the action was last updated.
          example: '2025-01-01T00:00:00.000Z'
        versions:
          description: >-
            The most recent published versions of the action, newest first (up
            to 10). Use GET /actions/version/{id} to retrieve the full version
            history.
          type: array
          items:
            $ref: '#/components/schemas/ActionVersionSummaryEntity'
      required:
        - id
        - name
        - updatedAt
        - versions
    ActionVersionSummaryEntity:
      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
        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
        createdAt:
          format: date-time
          type: string
          description: ISO 8601 timestamp of when the version was created.
          example: '2025-01-01T00:00:00.000Z'
      required:
        - id
        - version
        - createdAt

````