Arvexa OS
Get API key

Revenue

Operator override for pre-routing trust block

Overrides a persisted CallTrustDecision to OVERRIDDEN_ALLOW before routing starts. Requires a reason code; records AuditLog and emits trust.overridden. Blocked when call status advances beyond RECEIVED (routing started). Trust-blocked REJECTED calls are reopened and routing is re-triggered. Requires TRUST_OS_ENABLED=true. Operator accountability: when x-user-id resolves to a tenant user, overriddenByUserId is persisted; omitted actors remain null until trusted auth (issue #37) is deployed and all clients send an authenticated actor.

POSThttps://api.thearvexa.com/api/calls/{callId}/trust/override

Calls

Recent Requests

Log in to see full request history
TimeStatusUser Agent
Make a request to see history.

Path Params

callIdstringrequired

Headers

x-organization-idstringrequired

Tenant organization identifier

x-user-rolestringrequired

Development RBAC role (for example SUPER_ADMIN, ORG_ADMIN, OPS_MANAGER, VIEWER)

x-user-idstring

Trusted authenticated actor id (interim header auth). Recorded as the actor on sensitive writes such as finance adjustments and their approve/reject decisions. Ignored when header auth is disabled.

x-organization-idstringrequired

Body Params

reasonCodestring enumrequired

Required operator reason code for the trust override

notestring

Optional operator note (PII-safe; stored in audit trail only)

Responses

200Trust override applied

Trust override applied

Schema

object
okbooleanrequired

example: true

callTrustDecisionIdstringrequired
callIdstringrequired
previousStatusenum(ALLOW | BLOCK | OVERRIDDEN_ALLOW) | nullrequired
statusenum(OVERRIDDEN_ALLOW)required

example: "OVERRIDDEN_ALLOW"

reasonCodeenum(OPERATOR_DISCRETION | DNC_FALSE_POSITIVE | CONSENT_VERIFIED_OFFLINE | VELOCITY_FALSE_POSITIVE | BLOCKLIST_FALSE_POSITIVE | PUBLISHER_TRUST_EXCEPTION | OTHER)required

example: "OPERATOR_DISCRETION"

callStatusenum(RECEIVED | ROUTING | RINGING | CONNECTED | COMPLETED | FAILED | NO_BUYER | REJECTED)required

Call status after override (may differ when routing re-triggered)

eventsEmittedarrayrequired

example: ["trust.overridden"]

itemsstring
routingTriggeredbooleanrequired

True when routing handoff was attempted after override (pre-routing only).

idempotentbooleanrequired

True when the trust decision was already OVERRIDDEN_ALLOW (no second write/event).

Example

{
  "ok": true,
  "callTrustDecisionId": "string",
  "callId": "string",
  "previousStatus": "ALLOW",
  "status": "OVERRIDDEN_ALLOW",
  "reasonCode": "OPERATOR_DISCRETION",
  "callStatus": "RECEIVED",
  "eventsEmitted": [
    "trust.overridden"
  ],
  "routingTriggered": true,
  "idempotent": true
}
400Validation error

Validation error

No response body schema in OpenAPI

This status is documented, but the operation did not publish a response schema or example. The HTTP status and description above are still authoritative.

403Forbidden for the supplied role

Forbidden for the supplied role

No response body schema in OpenAPI

This status is documented, but the operation did not publish a response schema or example. The HTTP status and description above are still authoritative.

404Resource not found

Resource not found

No response body schema in OpenAPI

This status is documented, but the operation did not publish a response schema or example. The HTTP status and description above are still authoritative.

← Return to API Reference