Skip to main content
PATCH
/
v1
/
agents
/
{id}
/
policy
curl -X PATCH https://api.saturn-pay.com/v1/agents/agt_abc123/policy \
  -H "Authorization: Bearer sk_agt_..." \
  -H "Content-Type: application/json" \
  -d '{
    "maxPerCallUsdCents": 50,
    "maxPerDayUsdCents": 500
  }'

{
  "maxPerCallUsdCents": 50,
  "maxPerDayUsdCents": 500,
  "allowedCapabilities": ["reason", "search", "read"],
  "dailySpentUsdCents": 127
}
Updates the policy (budget caps, allowed capabilities) for a specific agent. Only the fields you include will be updated.

​
Path Parameters

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

​
Request

​
maxPerCallUsdCents
number
Maximum cost allowed per single API call (in USD cents). Set to 0 or null for no limit.
​
maxPerDayUsdCents
number
Maximum total spend allowed per day (in USD cents). Resets at midnight UTC. Set to 0 or null for no limit.
​
allowedCapabilities
array
List of capabilities this agent can use. Set to null or empty array to allow all capabilities.

​
Response

Returns the updated policy object. 
curl -X PATCH https://api.saturn-pay.com/v1/agents/agt_abc123/policy \
  -H "Authorization: Bearer sk_agt_..." \
  -H "Content-Type: application/json" \
  -d '{
    "maxPerCallUsdCents": 50,
    "maxPerDayUsdCents": 500
  }'

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