curl "http://localhost:8000/api/v2/agents/my-agent/policy/presets" \
-H "X-Session-Token: your_session_token"
{
"presets": [
{
"name": "conservative",
"description": "Expire only fast-rotting state. Nothing durable ages out, and nothing is ever purged.",
"retention": { "context": "30d", "event": "90d", "error": "90d" },
"rule_count": 1,
"purge_expired_after": "never"
},
{
"name": "balanced",
"description": "Sensible defaults for a working agent: transient state ages out in weeks, semantic knowledge in months, durable truths never.",
"retention": {
"context": "7d",
"event": "30d",
"error": "30d",
"observation": "60d",
"commitment": "90d",
"artifact": "180d"
},
"rule_count": 3,
"purge_expired_after": "never"
},
{
"name": "aggressive",
"description": "Keep the working set tight. Most types age out quickly and expired memories are purged after a year.",
"retention": {
"context": "3d",
"event": "14d",
"error": "14d",
"observation": "30d",
"commitment": "30d",
"artifact": "60d",
"fact": "180d",
"decision": "180d",
"goal": "180d",
"learning": "180d"
},
"rule_count": 3,
"purge_expired_after": "365d"
}
]
}
{
"detail": "Missing session token. Use X-Session-Token header."
}
Expiry Policy
List Policy Presets
List the predefined expiry policy bundles.
GET
/
api
/
v2
/
agents
/
{agent_id}
/
policy
/
presets
curl "http://localhost:8000/api/v2/agents/my-agent/policy/presets" \
-H "X-Session-Token: your_session_token"
{
"presets": [
{
"name": "conservative",
"description": "Expire only fast-rotting state. Nothing durable ages out, and nothing is ever purged.",
"retention": { "context": "30d", "event": "90d", "error": "90d" },
"rule_count": 1,
"purge_expired_after": "never"
},
{
"name": "balanced",
"description": "Sensible defaults for a working agent: transient state ages out in weeks, semantic knowledge in months, durable truths never.",
"retention": {
"context": "7d",
"event": "30d",
"error": "30d",
"observation": "60d",
"commitment": "90d",
"artifact": "180d"
},
"rule_count": 3,
"purge_expired_after": "never"
},
{
"name": "aggressive",
"description": "Keep the working set tight. Most types age out quickly and expired memories are purged after a year.",
"retention": {
"context": "3d",
"event": "14d",
"error": "14d",
"observation": "30d",
"commitment": "30d",
"artifact": "60d",
"fact": "180d",
"decision": "180d",
"goal": "180d",
"learning": "180d"
},
"rule_count": 3,
"purge_expired_after": "365d"
}
]
}
{
"detail": "Missing session token. Use X-Session-Token header."
}
Overview
Returns a summary of every shipped policy preset. Each is a complete policy meant as a starting point. To see a preset’s full contents without adopting it, use Get Policy Preset.Authentication
API clients do not send an API key orAuthorization header.
string
required
Session token from Activate Agent. Must match
agent_id.Path Parameters
string
required
The unique identifier of the agent.
curl "http://localhost:8000/api/v2/agents/my-agent/policy/presets" \
-H "X-Session-Token: your_session_token"
{
"presets": [
{
"name": "conservative",
"description": "Expire only fast-rotting state. Nothing durable ages out, and nothing is ever purged.",
"retention": { "context": "30d", "event": "90d", "error": "90d" },
"rule_count": 1,
"purge_expired_after": "never"
},
{
"name": "balanced",
"description": "Sensible defaults for a working agent: transient state ages out in weeks, semantic knowledge in months, durable truths never.",
"retention": {
"context": "7d",
"event": "30d",
"error": "30d",
"observation": "60d",
"commitment": "90d",
"artifact": "180d"
},
"rule_count": 3,
"purge_expired_after": "never"
},
{
"name": "aggressive",
"description": "Keep the working set tight. Most types age out quickly and expired memories are purged after a year.",
"retention": {
"context": "3d",
"event": "14d",
"error": "14d",
"observation": "30d",
"commitment": "30d",
"artifact": "60d",
"fact": "180d",
"decision": "180d",
"goal": "180d",
"learning": "180d"
},
"rule_count": 3,
"purge_expired_after": "365d"
}
]
}
{
"detail": "Missing session token. Use X-Session-Token header."
}
Notes
- In every preset,
preference,instructionandrelationshipare absent from the retention table, so they never expire on a timer. - Every preset includes a
pinnedrule exempting anything taggedpinned. - Only
aggressiveenables purging.
Next Steps
- Get Policy Preset for one preset’s full policy
- Apply Policy Preset to adopt one