Agent and policy

Get the policy

Get the policy assigned to the agent.

GET/v1/agent-api/policy

Responses

200

Assigned policy

404

No policy assigned

Response fields

policyobjectRequired

policy.idstringRequired

policy.namestringRequired

policy.descriptionstringRequired

policy.capabilitiesarray of stringRequired

policy.accountAccessobject or nullRequired

Accounts the policy permits for each capability; null when the policy is invalid

policy.rulesobject or nullRequired

Every rule that limits sends and transfers, each scoped to one account or to all of the capability's accounts together; null when the policy is invalid

policy.invalidReasonstring or nullRequired

Why the stored policy cannot be read as account access and scoped rules; null when it can

policy.versionnumberRequired

policy.kind"base" | "override"Required

policy.expiresAtstringOptional

Updated October 29, 2026 Generated from the agent API's published OpenAPI document View as Markdown

import { createCatenaClient } from "@catena/sdk"

// Reads CATENA_SECRET_KEY
const client = createCatenaClient()

const policy = await client.getPolicy()

catena policy show

Response 200

{
  "policy": {
    "id": "pol_01JC2Y5N2Q4S6U8W0Y3A5C7E9G",
    "name": "Accounts payable",
    "description": "Pay approved vendors from the operating account.",
    "capabilities": ["read", "send"],
    "accountAccess": {
      "read": ["acct_01JC2Y6ZQ8R4M7N9P3S5T6V8WX"],
      "send": ["acct_01JC2Y6ZQ8R4M7N9P3S5T6V8WX"],
      "transfer": []
    },
    "rules": {
      "send": [
        {
          "id": "rule_01JC2Y5P8R1T3V5X7Z9B2D4F6H",
          "scope": {
            "accounts": {
              "type": "all"
            },
            "counterparties": {
              "type": "all"
            }
          },
          "limit": {
            "type": "per_transaction_amount",
            "threshold": {
              "amount": "2000.00",
              "assetId": "USD"
            }
          },
          "action": {
            "type": "require_approval",
            "requiredApprovals": 1
          }
        },
        {
          "id": "rule_01JC2Y5Q2S4U6W8Y0A3C5E7G9J",
          "scope": {
            "accounts": {
              "type": "all"
            },
            "counterparties": {
              "type": "all"
            }
          },
          "limit": {
            "type": "daily_amount",
            "threshold": {
              "amount": "25000.00",
              "assetId": "USD"
            }
          },
          "action": {
            "type": "block"
          }
        }
      ],
      "transfer": []
    },
    "invalidReason": null,
    "version": 3,
    "kind": "base"
  }
}