Skip to main content
GET
/
v1
/
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

id
string
required
The agent ID (e.g., agt_abc123)

Response

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
}