Skip to content

Update Policy

PUT
/api/v1/retention/policies/{category}
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.
category
required
Category

Retention category to override

string

Retention category to override

Media typeapplication/json
RetentionPolicyOverrideRequest

Request body for PUT /policies/{category}.

object
default_days
required
Default Days
integer
Examplegenerated
{
"default_days": 1
}

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>
ValidationError
object
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"
}
]
}