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

# Get workflow action retry and reliability capabilities

**Required scope:** `workflows.view`

<Note>Requires workflows enabled for your workspace. Otherwise the request is refused; see [Errors](/concepts/errors).</Note>


## OpenAPI

````yaml /api-reference/openapi.json get /workflow-action-capabilities
openapi: 3.0.3
info:
  title: Pineyard API
  version: 1.0.0
  description: >-
    Programmatic access to agents, campaigns, calls, phone numbers, WhatsApp and
    results in your Pineyard workspace.
servers:
  - url: https://api.pineyard.ai
    description: Production
security:
  - bearerAuth: []
paths:
  /workflow-action-capabilities:
    get:
      summary: Get workflow action retry and reliability capabilities
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  guardrails:
                    type: object
                    properties:
                      maxAttempts:
                        type: integer
                      maxElapsedMs:
                        type: integer
                      maxDelayMs:
                        type: integer
                      minMultiplier:
                        type: number
                      maxJitterRatio:
                        type: number
                    required:
                      - maxAttempts
                      - maxElapsedMs
                      - maxDelayMs
                      - minMultiplier
                      - maxJitterRatio
                  suggestedPolicy:
                    anyOf:
                      - type: object
                        properties:
                          maxAttempts:
                            type: integer
                            minimum: 1
                            maximum: 50
                          maxElapsedMs:
                            type: integer
                            minimum: 0
                            maximum: 2592000000
                          jitterRatio:
                            type: number
                            minimum: 0
                            maximum: 0.5
                            default: 0
                          respectRetryAfter:
                            type: boolean
                            default: true
                          strategy:
                            type: string
                            enum:
                              - adaptive
                          initialDelayMs:
                            type: integer
                            minimum: 0
                            maximum: 2592000000
                          maxDelayMs:
                            type: integer
                            minimum: 0
                            maximum: 2592000000
                          multiplier:
                            type: number
                            minimum: 1
                        required:
                          - maxAttempts
                          - maxElapsedMs
                          - strategy
                          - initialDelayMs
                          - maxDelayMs
                          - multiplier
                        additionalProperties: false
                      - type: object
                        properties:
                          maxAttempts:
                            type: integer
                            minimum: 1
                            maximum: 50
                          maxElapsedMs:
                            type: integer
                            minimum: 0
                            maximum: 2592000000
                          jitterRatio:
                            type: number
                            minimum: 0
                            maximum: 0.5
                            default: 0
                          respectRetryAfter:
                            type: boolean
                            default: true
                          strategy:
                            type: string
                            enum:
                              - fixed
                          initialDelayMs:
                            type: integer
                            minimum: 0
                            maximum: 2592000000
                        required:
                          - maxAttempts
                          - maxElapsedMs
                          - strategy
                          - initialDelayMs
                        additionalProperties: false
                      - type: object
                        properties:
                          maxAttempts:
                            type: integer
                            minimum: 1
                            maximum: 50
                          maxElapsedMs:
                            type: integer
                            minimum: 0
                            maximum: 2592000000
                          jitterRatio:
                            type: number
                            minimum: 0
                            maximum: 0.5
                            default: 0
                          respectRetryAfter:
                            type: boolean
                            default: true
                          strategy:
                            type: string
                            enum:
                              - linear
                          initialDelayMs:
                            type: integer
                            minimum: 0
                            maximum: 2592000000
                          maxDelayMs:
                            type: integer
                            minimum: 0
                            maximum: 2592000000
                        required:
                          - maxAttempts
                          - maxElapsedMs
                          - strategy
                          - initialDelayMs
                          - maxDelayMs
                        additionalProperties: false
                      - type: object
                        properties:
                          maxAttempts:
                            type: integer
                            minimum: 1
                            maximum: 50
                          maxElapsedMs:
                            type: integer
                            minimum: 0
                            maximum: 2592000000
                          jitterRatio:
                            type: number
                            minimum: 0
                            maximum: 0.5
                            default: 0
                          respectRetryAfter:
                            type: boolean
                            default: true
                          strategy:
                            type: string
                            enum:
                              - exponential
                          initialDelayMs:
                            type: integer
                            minimum: 0
                            maximum: 2592000000
                          maxDelayMs:
                            type: integer
                            minimum: 0
                            maximum: 2592000000
                          multiplier:
                            type: number
                            minimum: 1
                        required:
                          - maxAttempts
                          - maxElapsedMs
                          - strategy
                          - initialDelayMs
                          - maxDelayMs
                          - multiplier
                        additionalProperties: false
                      - type: object
                        properties:
                          maxAttempts:
                            type: integer
                            minimum: 1
                            maximum: 50
                          maxElapsedMs:
                            type: integer
                            minimum: 0
                            maximum: 2592000000
                          jitterRatio:
                            type: number
                            minimum: 0
                            maximum: 0.5
                            default: 0
                          respectRetryAfter:
                            type: boolean
                            default: true
                          strategy:
                            type: string
                            enum:
                              - custom
                          customDelaysMs:
                            type: array
                            items:
                              type: integer
                              minimum: 0
                              maximum: 2592000000
                        required:
                          - maxAttempts
                          - maxElapsedMs
                          - strategy
                          - customDelaysMs
                        additionalProperties: false
                  actions:
                    type: object
                    properties:
                      google_calendar:
                        type: object
                        properties:
                          idempotency:
                            type: string
                            enum:
                              - native
                              - visit_key
                              - none
                            description: Currently effective idempotency guarantee.
                          visitKeySupport:
                            type: string
                            enum:
                              - none
                              - planned_v2
                              - active
                            description: >-
                              planned_v2 is inactive metadata only; it must not
                              authorize ambiguous-outcome replay.
                          defaultTimeoutMs:
                            type: integer
                            minimum: 0
                            exclusiveMinimum: true
                          allowedStrategies:
                            type: array
                            items:
                              type: string
                              enum:
                                - adaptive
                                - fixed
                                - linear
                                - exponential
                                - custom
                          retrySafety:
                            type: string
                            enum:
                              - known_failed_only
                              - method_dependent
                        required:
                          - idempotency
                          - visitKeySupport
                          - defaultTimeoutMs
                          - allowedStrategies
                          - retrySafety
                      whatsapp_send:
                        type: object
                        properties:
                          idempotency:
                            type: string
                            enum:
                              - native
                              - visit_key
                              - none
                            description: Currently effective idempotency guarantee.
                          visitKeySupport:
                            type: string
                            enum:
                              - none
                              - planned_v2
                              - active
                            description: >-
                              planned_v2 is inactive metadata only; it must not
                              authorize ambiguous-outcome replay.
                          defaultTimeoutMs:
                            type: integer
                            minimum: 0
                            exclusiveMinimum: true
                          allowedStrategies:
                            type: array
                            items:
                              type: string
                              enum:
                                - adaptive
                                - fixed
                                - linear
                                - exponential
                                - custom
                          retrySafety:
                            type: string
                            enum:
                              - known_failed_only
                              - method_dependent
                        required:
                          - idempotency
                          - visitKeySupport
                          - defaultTimeoutMs
                          - allowedStrategies
                          - retrySafety
                      whatsapp_template:
                        type: object
                        properties:
                          idempotency:
                            type: string
                            enum:
                              - native
                              - visit_key
                              - none
                            description: Currently effective idempotency guarantee.
                          visitKeySupport:
                            type: string
                            enum:
                              - none
                              - planned_v2
                              - active
                            description: >-
                              planned_v2 is inactive metadata only; it must not
                              authorize ambiguous-outcome replay.
                          defaultTimeoutMs:
                            type: integer
                            minimum: 0
                            exclusiveMinimum: true
                          allowedStrategies:
                            type: array
                            items:
                              type: string
                              enum:
                                - adaptive
                                - fixed
                                - linear
                                - exponential
                                - custom
                          retrySafety:
                            type: string
                            enum:
                              - known_failed_only
                              - method_dependent
                        required:
                          - idempotency
                          - visitKeySupport
                          - defaultTimeoutMs
                          - allowedStrategies
                          - retrySafety
                      whatsapp_media:
                        type: object
                        properties:
                          idempotency:
                            type: string
                            enum:
                              - native
                              - visit_key
                              - none
                            description: Currently effective idempotency guarantee.
                          visitKeySupport:
                            type: string
                            enum:
                              - none
                              - planned_v2
                              - active
                            description: >-
                              planned_v2 is inactive metadata only; it must not
                              authorize ambiguous-outcome replay.
                          defaultTimeoutMs:
                            type: integer
                            minimum: 0
                            exclusiveMinimum: true
                          allowedStrategies:
                            type: array
                            items:
                              type: string
                              enum:
                                - adaptive
                                - fixed
                                - linear
                                - exponential
                                - custom
                          retrySafety:
                            type: string
                            enum:
                              - known_failed_only
                              - method_dependent
                        required:
                          - idempotency
                          - visitKeySupport
                          - defaultTimeoutMs
                          - allowedStrategies
                          - retrySafety
                      lead_suppress:
                        type: object
                        properties:
                          idempotency:
                            type: string
                            enum:
                              - native
                              - visit_key
                              - none
                            description: Currently effective idempotency guarantee.
                          visitKeySupport:
                            type: string
                            enum:
                              - none
                              - planned_v2
                              - active
                            description: >-
                              planned_v2 is inactive metadata only; it must not
                              authorize ambiguous-outcome replay.
                          defaultTimeoutMs:
                            type: integer
                            minimum: 0
                            exclusiveMinimum: true
                          allowedStrategies:
                            type: array
                            items:
                              type: string
                              enum:
                                - adaptive
                                - fixed
                                - linear
                                - exponential
                                - custom
                          retrySafety:
                            type: string
                            enum:
                              - known_failed_only
                              - method_dependent
                        required:
                          - idempotency
                          - visitKeySupport
                          - defaultTimeoutMs
                          - allowedStrategies
                          - retrySafety
                      lead_tag:
                        type: object
                        properties:
                          idempotency:
                            type: string
                            enum:
                              - native
                              - visit_key
                              - none
                            description: Currently effective idempotency guarantee.
                          visitKeySupport:
                            type: string
                            enum:
                              - none
                              - planned_v2
                              - active
                            description: >-
                              planned_v2 is inactive metadata only; it must not
                              authorize ambiguous-outcome replay.
                          defaultTimeoutMs:
                            type: integer
                            minimum: 0
                            exclusiveMinimum: true
                          allowedStrategies:
                            type: array
                            items:
                              type: string
                              enum:
                                - adaptive
                                - fixed
                                - linear
                                - exponential
                                - custom
                          retrySafety:
                            type: string
                            enum:
                              - known_failed_only
                              - method_dependent
                        required:
                          - idempotency
                          - visitKeySupport
                          - defaultTimeoutMs
                          - allowedStrategies
                          - retrySafety
                      lead_disposition:
                        type: object
                        properties:
                          idempotency:
                            type: string
                            enum:
                              - native
                              - visit_key
                              - none
                            description: Currently effective idempotency guarantee.
                          visitKeySupport:
                            type: string
                            enum:
                              - none
                              - planned_v2
                              - active
                            description: >-
                              planned_v2 is inactive metadata only; it must not
                              authorize ambiguous-outcome replay.
                          defaultTimeoutMs:
                            type: integer
                            minimum: 0
                            exclusiveMinimum: true
                          allowedStrategies:
                            type: array
                            items:
                              type: string
                              enum:
                                - adaptive
                                - fixed
                                - linear
                                - exponential
                                - custom
                          retrySafety:
                            type: string
                            enum:
                              - known_failed_only
                              - method_dependent
                        required:
                          - idempotency
                          - visitKeySupport
                          - defaultTimeoutMs
                          - allowedStrategies
                          - retrySafety
                      lead_handoff:
                        type: object
                        properties:
                          idempotency:
                            type: string
                            enum:
                              - native
                              - visit_key
                              - none
                            description: Currently effective idempotency guarantee.
                          visitKeySupport:
                            type: string
                            enum:
                              - none
                              - planned_v2
                              - active
                            description: >-
                              planned_v2 is inactive metadata only; it must not
                              authorize ambiguous-outcome replay.
                          defaultTimeoutMs:
                            type: integer
                            minimum: 0
                            exclusiveMinimum: true
                          allowedStrategies:
                            type: array
                            items:
                              type: string
                              enum:
                                - adaptive
                                - fixed
                                - linear
                                - exponential
                                - custom
                          retrySafety:
                            type: string
                            enum:
                              - known_failed_only
                              - method_dependent
                        required:
                          - idempotency
                          - visitKeySupport
                          - defaultTimeoutMs
                          - allowedStrategies
                          - retrySafety
                      notify:
                        type: object
                        properties:
                          idempotency:
                            type: string
                            enum:
                              - native
                              - visit_key
                              - none
                            description: Currently effective idempotency guarantee.
                          visitKeySupport:
                            type: string
                            enum:
                              - none
                              - planned_v2
                              - active
                            description: >-
                              planned_v2 is inactive metadata only; it must not
                              authorize ambiguous-outcome replay.
                          defaultTimeoutMs:
                            type: integer
                            minimum: 0
                            exclusiveMinimum: true
                          allowedStrategies:
                            type: array
                            items:
                              type: string
                              enum:
                                - adaptive
                                - fixed
                                - linear
                                - exponential
                                - custom
                          retrySafety:
                            type: string
                            enum:
                              - known_failed_only
                              - method_dependent
                        required:
                          - idempotency
                          - visitKeySupport
                          - defaultTimeoutMs
                          - allowedStrategies
                          - retrySafety
                      ai_judge:
                        type: object
                        properties:
                          idempotency:
                            type: string
                            enum:
                              - native
                              - visit_key
                              - none
                            description: Currently effective idempotency guarantee.
                          visitKeySupport:
                            type: string
                            enum:
                              - none
                              - planned_v2
                              - active
                            description: >-
                              planned_v2 is inactive metadata only; it must not
                              authorize ambiguous-outcome replay.
                          defaultTimeoutMs:
                            type: integer
                            minimum: 0
                            exclusiveMinimum: true
                          allowedStrategies:
                            type: array
                            items:
                              type: string
                              enum:
                                - adaptive
                                - fixed
                                - linear
                                - exponential
                                - custom
                          retrySafety:
                            type: string
                            enum:
                              - known_failed_only
                              - method_dependent
                        required:
                          - idempotency
                          - visitKeySupport
                          - defaultTimeoutMs
                          - allowedStrategies
                          - retrySafety
                      mint_link:
                        type: object
                        properties:
                          idempotency:
                            type: string
                            enum:
                              - native
                              - visit_key
                              - none
                            description: Currently effective idempotency guarantee.
                          visitKeySupport:
                            type: string
                            enum:
                              - none
                              - planned_v2
                              - active
                            description: >-
                              planned_v2 is inactive metadata only; it must not
                              authorize ambiguous-outcome replay.
                          defaultTimeoutMs:
                            type: integer
                            minimum: 0
                            exclusiveMinimum: true
                          allowedStrategies:
                            type: array
                            items:
                              type: string
                              enum:
                                - adaptive
                                - fixed
                                - linear
                                - exponential
                                - custom
                          retrySafety:
                            type: string
                            enum:
                              - known_failed_only
                              - method_dependent
                        required:
                          - idempotency
                          - visitKeySupport
                          - defaultTimeoutMs
                          - allowedStrategies
                          - retrySafety
                      campaign_enroll:
                        type: object
                        properties:
                          idempotency:
                            type: string
                            enum:
                              - native
                              - visit_key
                              - none
                            description: Currently effective idempotency guarantee.
                          visitKeySupport:
                            type: string
                            enum:
                              - none
                              - planned_v2
                              - active
                            description: >-
                              planned_v2 is inactive metadata only; it must not
                              authorize ambiguous-outcome replay.
                          defaultTimeoutMs:
                            type: integer
                            minimum: 0
                            exclusiveMinimum: true
                          allowedStrategies:
                            type: array
                            items:
                              type: string
                              enum:
                                - adaptive
                                - fixed
                                - linear
                                - exponential
                                - custom
                          retrySafety:
                            type: string
                            enum:
                              - known_failed_only
                              - method_dependent
                        required:
                          - idempotency
                          - visitKeySupport
                          - defaultTimeoutMs
                          - allowedStrategies
                          - retrySafety
                      email_send:
                        type: object
                        properties:
                          idempotency:
                            type: string
                            enum:
                              - native
                              - visit_key
                              - none
                            description: Currently effective idempotency guarantee.
                          visitKeySupport:
                            type: string
                            enum:
                              - none
                              - planned_v2
                              - active
                            description: >-
                              planned_v2 is inactive metadata only; it must not
                              authorize ambiguous-outcome replay.
                          defaultTimeoutMs:
                            type: integer
                            minimum: 0
                            exclusiveMinimum: true
                          allowedStrategies:
                            type: array
                            items:
                              type: string
                              enum:
                                - adaptive
                                - fixed
                                - linear
                                - exponential
                                - custom
                          retrySafety:
                            type: string
                            enum:
                              - known_failed_only
                              - method_dependent
                        required:
                          - idempotency
                          - visitKeySupport
                          - defaultTimeoutMs
                          - allowedStrategies
                          - retrySafety
                      sheet_sync:
                        type: object
                        properties:
                          idempotency:
                            type: string
                            enum:
                              - native
                              - visit_key
                              - none
                            description: Currently effective idempotency guarantee.
                          visitKeySupport:
                            type: string
                            enum:
                              - none
                              - planned_v2
                              - active
                            description: >-
                              planned_v2 is inactive metadata only; it must not
                              authorize ambiguous-outcome replay.
                          defaultTimeoutMs:
                            type: integer
                            minimum: 0
                            exclusiveMinimum: true
                          allowedStrategies:
                            type: array
                            items:
                              type: string
                              enum:
                                - adaptive
                                - fixed
                                - linear
                                - exponential
                                - custom
                          retrySafety:
                            type: string
                            enum:
                              - known_failed_only
                              - method_dependent
                        required:
                          - idempotency
                          - visitKeySupport
                          - defaultTimeoutMs
                          - allowedStrategies
                          - retrySafety
                      human_hold:
                        type: object
                        properties:
                          idempotency:
                            type: string
                            enum:
                              - native
                              - visit_key
                              - none
                            description: Currently effective idempotency guarantee.
                          visitKeySupport:
                            type: string
                            enum:
                              - none
                              - planned_v2
                              - active
                            description: >-
                              planned_v2 is inactive metadata only; it must not
                              authorize ambiguous-outcome replay.
                          defaultTimeoutMs:
                            type: integer
                            minimum: 0
                            exclusiveMinimum: true
                          allowedStrategies:
                            type: array
                            items:
                              type: string
                              enum:
                                - adaptive
                                - fixed
                                - linear
                                - exponential
                                - custom
                          retrySafety:
                            type: string
                            enum:
                              - known_failed_only
                              - method_dependent
                        required:
                          - idempotency
                          - visitKeySupport
                          - defaultTimeoutMs
                          - allowedStrategies
                          - retrySafety
                      http:
                        type: object
                        properties:
                          idempotency:
                            type: string
                            enum:
                              - native
                              - visit_key
                              - none
                            description: Currently effective idempotency guarantee.
                          visitKeySupport:
                            type: string
                            enum:
                              - none
                              - planned_v2
                              - active
                            description: >-
                              planned_v2 is inactive metadata only; it must not
                              authorize ambiguous-outcome replay.
                          defaultTimeoutMs:
                            type: integer
                            minimum: 0
                            exclusiveMinimum: true
                          allowedStrategies:
                            type: array
                            items:
                              type: string
                              enum:
                                - adaptive
                                - fixed
                                - linear
                                - exponential
                                - custom
                          retrySafety:
                            type: string
                            enum:
                              - known_failed_only
                              - method_dependent
                          methodRequirements:
                            type: object
                            properties:
                              safeMethods:
                                type: array
                                items:
                                  type: string
                                  enum:
                                    - GET
                                    - HEAD
                              mutatingMethods:
                                type: array
                                items:
                                  type: string
                                  enum:
                                    - POST
                                    - PUT
                                    - PATCH
                                    - DELETE
                              mutatingRetryRequires:
                                type: string
                                enum:
                                  - idempotency_key
                            required:
                              - safeMethods
                              - mutatingMethods
                              - mutatingRetryRequires
                          request:
                            type: object
                            properties:
                              requestVersion:
                                type: number
                                enum:
                                  - 1
                              methods:
                                type: array
                                items:
                                  type: string
                                  enum:
                                    - GET
                                    - HEAD
                                    - POST
                                    - PUT
                                    - PATCH
                                    - DELETE
                              bodyModes:
                                type: array
                                items:
                                  type: string
                                  enum:
                                    - none
                                    - json
                                    - text
                                    - form
                              responseTypes:
                                type: array
                                items:
                                  type: string
                                  enum:
                                    - text
                                    - json
                              maxTimeoutMs:
                                type: integer
                                minimum: 0
                                exclusiveMinimum: true
                              supportsQuery:
                                type: boolean
                              supportsHeaderRows:
                                type: boolean
                              supportsResponseSelection:
                                type: boolean
                              supportsSecretHeaders:
                                type: boolean
                            required:
                              - requestVersion
                              - methods
                              - bodyModes
                              - responseTypes
                              - maxTimeoutMs
                              - supportsQuery
                              - supportsHeaderRows
                              - supportsResponseSelection
                              - supportsSecretHeaders
                        required:
                          - idempotency
                          - visitKeySupport
                          - defaultTimeoutMs
                          - allowedStrategies
                          - retrySafety
                          - methodRequirements
                          - request
                    required:
                      - google_calendar
                      - whatsapp_send
                      - whatsapp_template
                      - whatsapp_media
                      - lead_suppress
                      - lead_tag
                      - lead_disposition
                      - lead_handoff
                      - notify
                      - ai_judge
                      - mint_link
                      - campaign_enroll
                      - email_send
                      - sheet_sync
                      - human_hold
                      - http
                    additionalProperties: false
                required:
                  - guardrails
                  - suggestedPolicy
                  - actions
                additionalProperties: false
        '400':
          description: >-
            - `internal_error`: An unexpected error. A `400` with this code
            usually means the body is not valid JSON; a `413` means the body is
            larger than 1 MB.

            - `invalid_body`: The request body (or query) failed validation.
            Details are in `issues` (or `detail`). `422` on `POST
            /v1/campaigns/{campaignId}/leads`.
        '401':
          description: >-
            - `invalid_api_key`: The API key is unknown, revoked or expired, or
            its workspace was deleted.

            - `unauthorized`: No `Authorization: Bearer` header, or an empty
            token.
        '403':
          description: >-
            - `api_key_not_scoped`: A key issued without scopes was used outside
            `/v1`.

            - `api_key_owner_inactive`: The member the key acts for was removed
            or suspended.

            - `forbidden`: The key lacks the permission named in
            `requiredPermission`, or the resource belongs to another workspace.

            - `workspace_pending_approval`: The workspace has not been approved
            yet.

            - `workspace_suspended`: The workspace is suspended.
        '404':
          description: >-
            - `not_found`: The resource does not exist in your workspace, or the
            feature is not enabled for it.
        '413':
          description: >-
            - `internal_error`: An unexpected error. A `400` with this code
            usually means the body is not valid JSON; a `413` means the body is
            larger than 1 MB.
        '429':
          description: '- `rate_limited`: Too many requests.'
        '500':
          description: >-
            - `internal_error`: An unexpected error. A `400` with this code
            usually means the body is not valid JSON; a `413` means the body is
            larger than 1 MB.
        '502':
          description: >-
            - `provider_error`: The calling service rejected the request
            (`upstreamStatus` 4xx) or was unavailable (5xx).
        '503':
          description: '- `database_unavailable`: The service is temporarily unavailable.'
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your API key, e.g. `pk_live_xxxxxxxxxxxxxxxxxxxxxxxx`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.