List data retention categories.

GET

/api/admin/data-retention/categories

Code sample: Shell / cURL

curl --request GET \
  --url https://auth.example.com/api/admin/data-retention/categories \
  --header 'Authorization: Bearer <token>'

Returns all built-in data retention categories with the tenant-specific retention period when configured, or the implementation default when no override exists.

Authorizations

• adminBearer
• adminSessionCookie

Responses

200

Data retention category list response.

Media type application/json

object

categories

required

Array<object>

object

category

required

string

retention_days

required

integer

updated_at

required

One of:

string

string format: date-time

string

string

Allowed values: default

key

additional properties

key

additional properties

Example

{
  "categories": [
    {
      "updated_at": "default"
    }
  ]
}

400

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

401

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

403

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

500

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}