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
}