Revenue

Operator override for call qualification (pre-settlement)

Overrides a persisted CallQualification to OVERRIDDEN before settlement. Requires a reason code; records AuditLog and emits call.qualification.overridden. Blocked when the linked Charge is POSTED. Re-evaluates finance adapter eligibility without mutating Charge/Payout/Ledger rows. Does not emit call.qualified. Requires QUALIFICATION_ENGINE_ENABLED=true. Response settlementEligibility is nullable: SettlementQualificationResult when the post-commit re-check succeeds, or null when eligibility could not be evaluated (override still succeeded). Clients must handle null.

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

Calls

Recent Requests

Time	Status	User 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 override

notestring

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

Responses

200Qualification overridden. settlementEligibility may be null when the post-commit finance eligibility re-check fails; the override itself still succeeded.application/json

Qualification overridden. settlementEligibility may be null when the post-commit finance eligibility re-check fails; the override itself still succeeded.

Schema

object

okbooleanrequired

example: true

callQualificationIdstringrequired

callIdstringrequired

previousStatusenum(PENDING | PASS | FAIL | OVERRIDDEN)required

statusenum(OVERRIDDEN)required

example: "OVERRIDDEN"

example: "OPERATOR_DISCRETION"

settlementEligibilityobject | nullrequired

SettlementQualificationResult when the post-commit finance eligibility re-check succeeds. Null when that re-check could not be evaluated; the override still succeeded and the AuditLog / call.qualification.overridden event were still written. Clients must handle null.

eventsEmittedarrayrequired

example: ["call.qualification.overridden"]

itemsstring

idempotentbooleanrequired

True when the qualification was already OVERRIDDEN (no second write/event).

Example

{
  "ok": true,
  "callQualificationId": "string",
  "callId": "string",
  "previousStatus": "PENDING",
  "status": "OVERRIDDEN",
  "reasonCode": "OPERATOR_DISCRETION",
  "eventsEmitted": [
    "call.qualification.overridden"
  ],
  "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