1. Retention
Cognita
  • Introduction
  • Auth
    • register
      POST
    • login
      POST
    • callback
      GET
    • profile
      GET
    • verify email
      POST
    • refresh
      POST
    • logout
      POST
    • forgot password
      POST
    • reset password
      POST
    • request reset password
      POST
    • update-profile
      PATCH
  • Meetings
    • Transcripts
      • Retrieve transcripts for a meeting
    • upload init
    • Get meeting details
  • Transcription
    • live
    • Get Transcript segments
    • Create translation for transcript
  • Organization
    • Billing
      • Get Billing Details
      • Update Plan
    • Org
      • Create Organization
      • Get Organization
      • Get Organizations
      • update organization
      • update settings
      • Delete Organization
      • get organization settings
      • Suspend
      • Resume
    • Retention
      • Set Retention Policy
        POST
      • Get Retention Policy
        GET
      • Update Retention Policy
        PATCH
    • Domains
      • Allowed Domains
      • Allowed Domains
      • Domain verfying
  • Workspaces
    • Org
      • Get Organization Workspaces
    • Workspace
      • Create Workspace
      • Get Workspace
      • Update Workspace
      • Delete Workspace
    • Users
      • Get Workspace Members
      • Delete Member from Workspace
    • Meetings
      • Start a meeting in workspace
  • configurations
    • feature-flags
    • configs
    • tenant-defaults
  • Schemas
    • Organization
      • OrganizationSettings
      • FeatureFlags
      • RetentionPolicy
      • Organization
      • CreateOrgRequestBody
    • Billing & Subscriptions
      • BillingAccount
      • SubscriptionEntitlements
      • SubscriptionPlan
      • Subscription
      • PaymentMethod
      • Invoice
      • UsageRecords
      • Bill
    • Roles & permissions
      • Permissions
    • Workspace
      • Workspaces
    • Meeting & Recordings
      • Meetings
    • Trascriptions & Summaries
    • Integrations
    • Notifications & Audit logs
    • AI Services
    • Localization
    • Auth & Users
      • user
      • AccessToken
    • ErrorResponse
    • SuccessResponse
    • DeviceInfo
    • Session
  1. Retention

Get Retention Policy

Developing
Develop Env
http://localhost:3000/api
Develop Env
http://localhost:3000/api
GET
http://localhost:3000/api
/orgs/{orgId}/retention
organization
Maintainer:Abdelrhman Moataz

Purpose#

Return current retention configuration.

Auth / Scope#

org:read or org:write (admin)

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Responses

🟢200Success
application/json
Body

🟠404Not Found
🟠403Forbidden
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://localhost:3000/api/orgs//retention' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Example 1
{
    "status": "ok",
    "message": "Organization retention policies fetched successfully",
    "data": {
        "transcripts": "730d",
        "recordings": "365d",
        "chatLogs": "365d",
        "userData": "1825d",
        "examData": "3650d"
    }
}
Modified at 2025-10-16 11:55:39
Previous
Set Retention Policy
Next
Update Retention Policy
Built with