ApiOrganization

Update organization retention

PATCH
/organizations

Set how long your organization's calls are kept. Content covers the transcript, summary, analysis result and recording; metadata covers the caller's phone number, the campaign link and the call events. Content cannot be kept longer than metadata.

Shortening a period destroys data: the nightly cleanup erases everything older than the new period, and that cannot be undone. Both fields are required, because they are validated against each other.

Unlimited retention is a contractual exception and is not available through this endpoint. See Privacy & compliance.

Authorization

BearerAuth
AuthorizationBearer <token>

API key authentication. Get your key from the dashboard.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X PATCH "https://example.com/organizations" \  -H "Content-Type: application/json" \  -d '{    "content_retention_days": 90,    "metadata_retention_days": 730  }'
{
  "content_retention_days": 90,
  "metadata_retention_days": 730
}
{
  "error": "Invalid API key",
  "message": "string"
}
{
  "error": "Invalid API key",
  "message": "string"
}

Create organization POST

Create a new organization. If `parent_org_id` is provided, creates a child organization that bills to the parent (for whitelabel use cases). The API key for the new organization is only returned once at creation time.

Health check GET

Returns the current health status of the API and its dependencies. No authentication required.