ReferenceAdmin
Set or clear a team's retention overrides (platform admins); If-Match is the team's revision
PUT
/v1/admin/teams/{team}/retentionEach listed kind is replaced (days null inherits the platform period); kinds not listed are kept. Only call_metadata and captured_payloads can be overridden. 422 invalid_period with details.kind and details.reason (not_overridable, out_of_range, duplicate). Audited as team.retention_update.
Path Parameters
team*string
Team slug or ID
Header Parameters
If-Match*string
The resource's revision, as returned in ETag (for example "3"). Missing returns 428; stale returns 412.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PUT "https://example.com/v1/admin/teams/string/retention" \ -H "If-Match: string" \ -H "Content-Type: application/json" \ -d '{ "periods": [ { "kind": "call_metadata", "days": 1 } ] }'{ "data": { "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec", "teamSlug": "string", "revision": null, "periods": [ { "kind": "call_metadata", "override": 0, "default": 0, "effective": 0, "minDays": 0, "maxDays": 0 } ] }}