curl https://api.saturn-pay.com/v1/agents/agt_abc123/policy \
-H "Authorization: Bearer sk_agt_..."
const response = await fetch('https://api.saturn-pay.com/v1/agents/agt_abc123/policy', {
headers: { 'Authorization': 'Bearer sk_agt_...' }
});
const policy = await response.json();
console.log(`Daily cap: $${policy.maxPerDayUsdCents / 100}`);
console.log(`Spent today: $${policy.dailySpentUsdCents / 100}`);
{
"maxPerCallUsdCents": 50,
"maxPerDayUsdCents": 500,
"allowedCapabilities": ["reason", "search", "read"],
"dailySpentUsdCents": 127
}
Policies
Get Policy
Get an agent’s policy configuration
GET
/
v1
/
agents
/
{id}
/
policy
curl https://api.saturn-pay.com/v1/agents/agt_abc123/policy \
-H "Authorization: Bearer sk_agt_..."
const response = await fetch('https://api.saturn-pay.com/v1/agents/agt_abc123/policy', {
headers: { 'Authorization': 'Bearer sk_agt_...' }
});
const policy = await response.json();
console.log(`Daily cap: $${policy.maxPerDayUsdCents / 100}`);
console.log(`Spent today: $${policy.dailySpentUsdCents / 100}`);
{
"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)Response
number
Maximum cost allowed per single API call (in USD cents)
number
Maximum total spend allowed per day (in USD cents). Resets at midnight UTC.
array
List of capabilities this agent can use. If empty or null, all capabilities are allowed.
number
Amount spent today (in USD cents)
curl https://api.saturn-pay.com/v1/agents/agt_abc123/policy \
-H "Authorization: Bearer sk_agt_..."
const response = await fetch('https://api.saturn-pay.com/v1/agents/agt_abc123/policy', {
headers: { 'Authorization': 'Bearer sk_agt_...' }
});
const policy = await response.json();
console.log(`Daily cap: $${policy.maxPerDayUsdCents / 100}`);
console.log(`Spent today: $${policy.dailySpentUsdCents / 100}`);
{
"maxPerCallUsdCents": 50,
"maxPerDayUsdCents": 500,
"allowedCapabilities": ["reason", "search", "read"],
"dailySpentUsdCents": 127
}