Update Policy
PUT
/api/v1/retention/policies/{category}
const url = 'https://api.ultimateteam.ai/api/v1/retention/policies/example';const options = { method: 'PUT', headers: {'X-API-Key': '<X-API-Key>', 'Content-Type': 'application/json'}, body: '{"default_days":1}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://api.ultimateteam.ai/api/v1/retention/policies/example \ --header 'Content-Type: application/json' \ --header 'X-API-Key: <X-API-Key>' \ --data '{ "default_days": 1 }'Update per-tenant retention override (Enterprise chairman only).
Validates that:
- The caller has current human chairman authority over tenant data.
- The category exists and is overridable (rejects audit_logs, pii).
- The requested days are at or above the GDPR floor.
- The caller’s tenant is on the Enterprise plan.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”category
required
Category
Retention category to override
string
Retention category to override
Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
RetentionPolicyOverrideRequest
Request body for PUT /policies/{category}.
object
default_days
required
Default Days
integer
Examplegenerated
{ "default_days": 1}Responses
Section titled “ Responses ”Successful Response
Media typeapplication/json
Response Update Policy Api V1 Retention Policies Category Put
object
key
additional properties
any
Examplegenerated
{}Validation Error
Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationErrorobject
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{ "detail": [ { "ctx": {}, "input": "example", "loc": [ "example" ], "msg": "example", "type": "example" } ]}