List All Agent Policy Rules Configured for Your Tenant

Use this endpoint to retrieve all policy rules currently configured for your tenant. Policy rules define the conditions under which agent-originated transactions are permitted — for example, capping transaction amounts, restricting allowed tokens or chains, or limiting which accounts an agent can debit or credit. Reviewing your active rules regularly helps ensure your agent guardrails remain intentional and up to date.

Endpoint

GET /api/v1/admin/policy-rules

Authorization

Requires an API key with ADMIN scope.

Request Example

curl --request GET \
  --url https://api.your-domain.com/api/v1/admin/policy-rules \
  --header 'Authorization: Bearer <api-key>'

Response

A successful response returns an array of policy rule objects.

string

required

Unique identifier (UUID) for the policy rule.

string

required

The rule type, which determines how the rule is evaluated. One of MAX_DEBIT_PER_SESSION, MAX_DEBIT_PER_HOUR, REQUIRE_HUMAN_APPROVAL_ABOVE, FORBIDDEN_ACCOUNT_PAIR, ALLOWED_TOKENS, or ALLOWED_CHAINS — see Policy Rules.

string

An optional prefix used to scope the rule to a specific agent or group of agents. When present, the rule applies only to API keys whose prefix matches this value.

object

required

A type-specific parameters object containing the rule’s configuration values (for example, amount, tokens, chains, debitAccountId, creditAccountId).

string (datetime)

required

ISO 8601 timestamp of when the rule was created.

Response Example

[
  {
    "id": "3f5a7c91-12bc-4d8e-a6f0-9b2e1d4c7a88",
    "type": "MAX_DEBIT_PER_SESSION",
    "agentKeyPrefix": "agent_payments_",
    "params": {
      "amount": "5000.00"
    },
    "createdAt": "2024-11-20T08:45:00Z"
  },
  {
    "id": "7a2b91e4-3c5d-4f6a-8b9c-1d2e3f4a5b6c",
    "type": "ALLOWED_TOKENS",
    "agentKeyPrefix": "agent_payments_",
    "params": {
      "tokens": ["USDC", "USDT"]
    },
    "createdAt": "2024-11-20T08:46:00Z"
  }
]

Error Codes

Code	Meaning
`401`	Missing or invalid API key.
`403`	The provided API key does not have `ADMIN` scope.

Accounts

Transactions

Settlements

Reconciliation

Compliance

Administration

List All Agent Policy Rules Configured for Your Tenant

Endpoint

Authorization

Request Example

Response

Response Example

Error Codes

​Endpoint

​Authorization

​Request Example

​Response

​Response Example

​Error Codes

Endpoint

Authorization

Request Example

Response

Response Example

Error Codes