Skip to main content
PUT
Replace RealCall settings

Authorizations

Authorization
string
header
required

JWT Bearer token. Obtain a token via your identity provider and pass it in the Authorization: Bearer <token> header.

Scopes

REAL_CALL_ADMIN_ACCESS

Body

application/json

Full-replace configuration update. aggregationMode is not accepted: it is not client-editable and the stored value is kept. Concurrent edits are last-write-wins.

retentionPolicy
enum<string>
required

Audio retention policy for the organization.

Available options:
DELETE,
LIFECYCLE,
RETAIN
Example:

"DELETE"

preprocessingMode
enum<string>
required

Which segments are preprocessed before detection.

Available options:
ALL,
DISABLE
Example:

"ALL"

operationMode
enum<string>
required

Whether the organization operates on live calls or static uploads.

Available options:
REALTIME,
STATIC
Example:

"REALTIME"

isCcfEnabled
boolean
required

Content classification for live calls. When true, calls that would be concluded as artificial are first checked for recognized pre-recorded synthetic audio, such as IVR menus, voicemail greetings and call screeners, before the final verdict.

Example:

true

retentionPeriod
integer | null

Retention window in seconds, from 60 s to 365 d. Required when retentionPolicy is LIFECYCLE, ignored otherwise. null is treated as absent.

Example:

604800

Response

The updated settings.

RealCall configuration for the calling organization.

organizationId
string
required

Owning organization.

Example:

"2nYn7qqkM5678Ks99ykvmZAr7pz"

retentionPolicy
enum<string>
required

Audio retention policy for the organization.

Available options:
DELETE,
LIFECYCLE,
RETAIN
Example:

"DELETE"

retentionPeriod
integer | null
required

Retention window in seconds. Meaningful only for the LIFECYCLE policy.

Example:

604800

preprocessingMode
enum<string>
required

Which segments are preprocessed before detection.

Available options:
ALL,
DISABLE
Example:

"ALL"

operationMode
enum<string>
required

Whether the organization operates on live calls or static uploads.

Available options:
REALTIME,
STATIC
Example:

"REALTIME"

aggregationMode
enum<string>
required

How per-segment results aggregate into a stream conclusion. Read-only: not client-editable.

Available options:
CONCLUSIVE,
PARTIAL
Example:

"CONCLUSIVE"

isCcfEnabled
boolean
required

Content classification for live calls. When true, calls that would be concluded as artificial are first checked for recognized pre-recorded synthetic audio, such as IVR menus, voicemail greetings and call screeners, before the final verdict.

Example:

true

createdAt
string<date-time>
required
Example:

"2026-07-01T12:00:00Z"

updatedAt
string<date-time>
required
Example:

"2026-07-01T12:00:00Z"