organizations

How long the organization's audit events are kept.

Organization admins only (403 organization_admin_required). API keys, connected apps and service accounts with audit:read can read and export where the organization has machine identities (otherwise 403 session_required); retention and legal holds change only with a person. Events come from the organization's log and its workspaces' logs and never hold secrets, codes or anything that identifies a head. Being introduced: 404 not_found until it is on for your organization. Six years until an admin sets a period; never less than one year.

get/v1/organizations/current/audit/retention

Request

  • Base URL: https://api.50heads.com
  • URL: https://api.50heads.com/v1/organizations/current/audit/retention
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://auth.50heads.com/authorize, token URL https://auth.50heads.com/token; client credentials, token URL https://auth.50heads.com/token, scopes: audit:read)

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.