POST
/
v1
/
reviews
{
  "404": {},
  "409": {},
  "422": {},
  "reviewId": "<string>",
  "analysisId": "<string>",
  "assignedTo": {
    "userId": "<string>",
    "email": "<string>",
    "name": "<string>"
  },
  "status": "<string>",
  "createdAt": "<string>",
  "deadline": "<string>"
}

​
Create Review

Assign a call analysis for review by creating a new review task.

​
Request

​
analysisId
string
required
The ID of the analysis to review
​
assignedTo
string
User ID to assign the review to. If not specified, uses auto-assignment
​
priority
string
default:"normal"
Review priority: low, normal, high, urgent
​
deadline
string
Review deadline (ISO 8601 timestamp)
​
instructions
string
Special instructions for the reviewer
​
reviewType
string
default:"standard"
Type of review: standard, detailed, compliance, quality
​
requireSecondReview
boolean
default:false
Whether a second reviewer is required

​
Response

​
reviewId
string
Unique identifier for the review
​
analysisId
string
Associated analysis ID
​
assignedTo
object
Assigned reviewer information
​
status
string
Review status: pending, in_progress, completed, escalated
​
createdAt
string
ISO 8601 timestamp
​
deadline
string
Review deadline if set

​
Examples

curl -X POST https://api.authentivoice.com/v1/reviews \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "analysisId": "ana_1234567890abcdef",
    "priority": "high",
    "deadline": "2024-01-16T17:00:00Z",
    "instructions": "Please verify the caller identity claims",
    "reviewType": "detailed"
  }'

​
Response Example

{
  "reviewId": "rev_abc123def456",
  "analysisId": "ana_1234567890abcdef",
  "assignedTo": {
    "userId": "user_789012",
    "email": "reviewer@company.com",
    "name": "Jane Reviewer"
  },
  "status": "pending",
  "priority": "high",
  "reviewType": "detailed",
  "createdAt": "2024-01-15T12:00:00Z",
  "deadline": "2024-01-16T17:00:00Z"
}

​
Auto-Assignment

When assignedTo is not specified, the system uses intelligent assignment: 
{
  "analysisId": "ana_1234567890abcdef",
  "priority": "high",
  "reviewType": "standard"
}
The system will:
  1. Check reviewer availability
  2. Match expertise to call type
  3. Balance workload
  4. Consider priority and deadline

​
Error Responses

​
404
Not Found
Analysis not found
{
  "error": {
    "code": "ANALYSIS_NOT_FOUND",
    "message": "The specified analysis was not found"
  }
}
​
409
Conflict
Review already exists
{
  "error": {
    "code": "REVIEW_EXISTS",
    "message": "A review already exists for this analysis",
    "existingReviewId": "rev_existing123"
  }
}
​
422
Unprocessable Entity
Invalid assignment
{
  "error": {
    "code": "INVALID_ASSIGNMENT",
    "message": "The specified user cannot be assigned reviews"
  }
}