Get Policy - Saturn

curl https://api.saturn-pay.com/v1/agents/agt_abc123/policy \
  -H "Authorization: Bearer sk_agt_..."

{
  "maxPerCallUsdCents": 50,
  "maxPerDayUsdCents": 500,
  "allowedCapabilities": ["reason", "search", "read"],
  "dailySpentUsdCents": 127
}

GET

agents

{id}

policy

curl https://api.saturn-pay.com/v1/agents/agt_abc123/policy \
  -H "Authorization: Bearer sk_agt_..."

{
  "maxPerCallUsdCents": 50,
  "maxPerDayUsdCents": 500,
  "allowedCapabilities": ["reason", "search", "read"],
  "dailySpentUsdCents": 127
}

Returns the policy (budget caps, allowed capabilities) for a specific agent.

Path Parameters

string

required

The agent ID (e.g., agt_abc123)

maxPerCallUsdCents

number

Maximum cost allowed per single API call (in USD cents)

maxPerDayUsdCents

number

Maximum total spend allowed per day (in USD cents). Resets at midnight UTC.

allowedCapabilities

array

List of capabilities this agent can use. If empty or null, all capabilities are allowed.

dailySpentUsdCents

number

Amount spent today (in USD cents)

curl https://api.saturn-pay.com/v1/agents/agt_abc123/policy \
  -H "Authorization: Bearer sk_agt_..."

{
  "maxPerCallUsdCents": 50,
  "maxPerDayUsdCents": 500,
  "allowedCapabilities": ["reason", "search", "read"],
  "dailySpentUsdCents": 127
}