Revenue

Mark call intelligence as reviewed

Sets reviewedAt, reviewedByUserId, and optional reviewNotes on the tenant-scoped CallIntelligence row. Writes AuditLog and emits call.intelligence.reviewed. ADMIN + OPERATOR roles (SUPER_ADMIN, ORG_ADMIN, OPS_MANAGER). Requires CALL_INTELLIGENCE_ENABLED=true. Returns 409 when status is PROCESSING. Cross-tenant or missing intelligence returns 404. Does not mutate M4 CallQualityScore, M9 CallQualification, or M10 CallTrustDecision.

POSThttps://api.thearvexa.com/api/calls/{id}/intelligence/review

Calls

Recent Requests

Time	Status	User Agent
Make a request to see history.

Path Params

idstringrequired

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

reviewNotesstring

Optional operator notes for the intelligence review acknowledgment. Operators must keep notes PII-safe by policy (no raw phone numbers, addresses, or other customer PII). Notes are stored on CallIntelligence and mirrored in AuditLog.afterJson; they are never written to AuditLog.reason and never included in event payloads (hasReviewNotes boolean only).

Responses

200Intelligence marked reviewedapplication/json

Intelligence marked reviewed

Schema

object

okbooleanrequired

callIntelligenceIdstringrequired

callIdstringrequired

organizationIdstringrequired

statusenum(PENDING | PROCESSING | COMPLETED | FAILED | SKIPPED)required

reviewedAtstringrequired

reviewedByUserIdstring | nullrequired

reviewNotesstring | nullrequired

eventsEmittedarrayrequired

itemsstring

Example

{
  "ok": true,
  "callIntelligenceId": "string",
  "callId": "string",
  "organizationId": "string",
  "status": "PENDING",
  "reviewedAt": "string",
  "reviewedByUserId": "string",
  "reviewNotes": "string",
  "eventsEmitted": [
    "string"
  ]
}

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.

409Intelligence is currently PROCESSING

Intelligence is currently PROCESSING

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