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

# Get action policy

> Read persisted Actions data for an account available to this workspace key. An unbound key selects account_id; a bound key stays limited to its own account.



## OpenAPI

````yaml https://plainrouter.com/openapi.json get /agent/workspaces/{workspace}/actions/policy
openapi: 3.1.0
info:
  title: Plainrouter Conversion API
  version: 0.5.0
  description: Plainrouter public Signals Conversion API.
servers:
  - url: https://plainrouter.com/api/v1
    description: Production
security:
  - workspaceSecret: []
paths:
  /agent/workspaces/{workspace}/actions/policy:
    get:
      tags:
        - ActionReadApi
      summary: Get action policy
      description: >-
        Read persisted Actions data for an account available to this workspace
        key. An unbound key selects account_id; a bound key stays limited to its
        own account.
      operationId: actions.api.policy
      parameters:
        - name: workspace
          in: path
          required: true
          description: The workspace ID
          schema:
            type: integer
        - name: account_id
          in: query
          description: >-
            Optional positive account ID. A bound key may name only its own
            account; any other value returns 422. An unbound key may name only
            an active account with an active connection in its workspace, and
            must name one when the workspace has more than one.
          schema:
            minimum: 1
            type: integer
      responses:
        '200':
          description: Authorized Actions resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionPolicyRead'
        '401':
          description: Missing, invalid, or expired workspace key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
        '403':
          description: The key lacks the propose-actions grant.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
        '404':
          description: Workspace, account, or Actions resource not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorMessage'
        '422':
          description: Request validation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
      security:
        - workspaceActionKey: []
components:
  schemas:
    ActionPolicyRead:
      type: object
      properties:
        data:
          type: object
          properties:
            id:
              type:
                - integer
                - 'null'
            workspace_id:
              type: integer
            execution_mode:
              type: string
              enum:
                - ask
                - full
                - suggest_only
                - auto_with_limits
                - full_auto
            max_spend_delta_percent:
              type: string
            hard_account_daily_cap_minor:
              type:
                - integer
                - 'null'
            protected_entities:
              type:
                - array
                - 'null'
              items: {}
            quiet_hours_start:
              type:
                - string
                - 'null'
            quiet_hours_end:
              type:
                - string
                - 'null'
            protect_learning_phase:
              type: boolean
            outcome_check_after_hours:
              type: integer
            anomaly_threshold_percent:
              type: string
          required:
            - id
            - workspace_id
            - execution_mode
            - max_spend_delta_percent
            - hard_account_daily_cap_minor
            - protected_entities
            - quiet_hours_start
            - quiet_hours_end
            - protect_learning_phase
            - outcome_check_after_hours
            - anomaly_threshold_percent
      required:
        - data
      title: ActionPolicyRead
    ErrorMessage:
      type: object
      properties:
        message:
          type: string
      required:
        - message
      title: ErrorMessage
    ValidationError:
      type: object
      properties:
        message:
          type: string
        errors:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
      required:
        - message
        - errors
      title: ValidationError
  securitySchemes:
    workspaceSecret:
      type: http
      description: >-
        Per-workspace Server secret. It authenticates only the Signals workspace
        represented by the credential.
      scheme: bearer
    workspaceActionKey:
      type: http
      description: >-
        Workspace execution key with the propose-actions grant. Unbound keys
        select an available advertising account with account_id.
      scheme: bearer

````