VocalDocscontracts 1.65.0

Read the Organization's Compliance profile

GET /v1/compliance-profile

PropertyValue
Operationget_compliance_profile
GroupCompliance profile
Scopeorganization:read
Route classread
IdempotencyNo Idempotency-Key
AuditNot audited: A configuration read; the Compliance profile is not Call content.
Released in1.32.0
Phase 0 hostServed (the hosted api pins 1.65.0)

Answers the version of the caller's Organization's Compliance profile in force, whose number is also the ETag (1.32.0, workspace ADR 0082). Before the owner first changes it, the answer is version 0, the defaults: recording with the announcement, Providers in us only, no BAA required and no fallback from the Organization's own key to Vocal's. Every Member role holds organization:read.

Request

Set VOCAL_API to the base URL of your API and VOCAL_API_KEY to an API key with the organization:read scope (Authentication and keys). Replace each placeholder, such as agt_... or <name>, with your own value.

curl "$VOCAL_API/v1/compliance-profile" \
  -H "Authorization: Bearer $VOCAL_API_KEY"

Responses

StatusContent typeShapeError codes
200application/jsonComplianceProfile
400application/jsonErrorEnvelopeinvalid_request
401application/jsonErrorEnvelopeunauthenticated
403application/jsonErrorEnvelopeforbidden
429application/jsonErrorEnveloperate_limited
500application/jsonErrorEnvelopeinternal_error

Fields of the 200 answer

The shape is ComplianceProfile.

FieldTypeRequiredDescription
byok_platform_fallbackByokPlatformFallbackyesWhether a stage on the Organization's own key may fall back to Vocal's; forbidden by default.
contact_inactivity_daysintegernoDays without a Call, a message, an enrollment or an API write after which a Contact is deleted by the daily retention.scrub job (1.61.0): 30 to 365, 365 by default (targets). Absent, from an api before 1.61.0, 365.
content_visibilityContentVisibilitynoThe visibility matrix of the content classes by role (1.57.0), checked at read time against the profile in force. Absent from an api older than 1.57.0; a reader treats its absence as the default.
export_contentExportContentnoWhether an S3 export may carry content (1.57.0, not built); off by default. Absent from an api older than 1.57.0; a reader treats its absence as the default.
live_call_judgingLiveCallJudgingnoWhether live Calls may be judged (1.63.0); off by default. Absent from an api before 1.63.0, which a reader treats as the default.
live_call_judging_sample_ratenumbernoThe share of eligible Calls a judge reads while live_call_judging is on (1.63.0): 0.01 to 1, 0.1 by default (a target), drawn at finalize. Absent from an api before 1.63.0, which a reader treats as the default.
object"compliance_profile"yes
provider_regionsarray of ProviderRegionyesThe regions where the Organization's Providers may process, one to as many as ProviderRegion holds (four from 1.38.0, three before), each once; us by default. Admission and publish apply the intersection with the cell's own set, and a Provider whose descriptor names a region outside it is dropped from every chain (region_not_allowed).
recording_policyRecordingPolicyyesThe recording policy; on_with_announcement by default.
require_baabooleanyesWhen true, the chain resolver drops every Provider whose descriptor baa_available is neither yes nor not_applicable (baa_not_stated). Every real descriptor of 1.32.0 reads unknown, so an Organization that sets it runs only mock Providers, in test. False by default.
reveal_approvalRevealApprovalnoWhether a reveal grant needs a second approver (1.57.0); none by default. Absent from an api older than 1.57.0; a reader treats its absence as the default.
revocation_scopeRevocationScopenoHow far an opt-out reaches (1.61.0): all_channels (the default) or per_channel. Absent, from an api before 1.61.0, all_channels.
trace_retention_daysinteger or nullnoShortens the retention of stage traces below the Call row's (1.57.0): 1 day up to the platform ceiling, or null, the default, to keep them with the Call row. The api refuses a value above the ceiling with the issue trace_retention_above_ceiling. Absent from an api older than 1.57.0; a reader treats its absence as the default.
updated_atTimestamp or nullyesWhen the version was written; null for version 0.
updated_byActorRef or nullyesThe Member who wrote the version, always an owner; null for version 0.
verbose_captureVerboseCapturenoWhere verbose capture may run (1.57.0); allowed by default. Absent from an api older than 1.57.0; a reader treats its absence as the default.
versionintegeryesThe version in force: 0 for the defaults before the first update, then one more per update. Returned as the ETag and required in the If-Match of PATCH /v1/compliance-profile.