code field with one of the values below. Use this field for programmatic error matching.
The RFC 7807 type URI in each error response links directly to the corresponding section on this page.
For retry strategies and example code, see the Error Handling guide.
Auth
UNAUTHORIZED
Invalid or missing API key
FORBIDDEN
You do not have permission to access this resource
Validation
VALIDATION_ERROR
Request validation failed
ANSWER_MISMATCH
Provided answers do not match question set
CRITERIA_INVALID
Criteria configuration is invalid
CRITERIA_REVISION_CONFLICT
Criteria changed before the write was applied
Not Found
NOT_FOUND
Resource not found
TENANT_NOT_FOUND
Tenant not found
JOB_NOT_FOUND
Job not found
APPLICATION_NOT_FOUND
Application not found
QUESTION_SET_NOT_FOUND
Question set not found or expired
CRITERIA_NOT_FOUND
No criteria found for this job
CRITERION_NOT_FOUND
Criterion not found
CRITERIA_VERSION_NOT_FOUND
Criteria version not found
SCORING_JOB_NOT_FOUND
Scoring job not found
BATCH_NOT_FOUND
Batch not found
LIBRARY_CRITERION_NOT_FOUND
Library criterion not found
Rate Limiting
RATE_LIMITED
Rate limit exceeded. Please retry after the reset time.
MONTHLY_TRIAL_QUOTA_EXCEEDED
Monthly trial quota exceeded. Contact your Nova account manager or nova@dweet.com to upgrade your plan.
Idempotency
These errors apply to criteria and library mutations that use the HTTPIdempotency-Key replay layer. Scoring submissions use built-in scoring idempotency instead.
IDEMPOTENCY_KEY_ALREADY_USED
Idempotency-Key has already been used with different request parameters
IDEMPOTENCY_REQUEST_IN_PROGRESS
A request with this Idempotency-Key is currently being processed
Resume
RESUME_FETCH_FAILED
Failed to fetch resume from provided URL
RESUME_CONVERSION_FAILED
Failed to convert resume document to a supported format
RESUME_ENCRYPTED
Resume is password-protected or encrypted
RESUME_CORRUPTED
Resume file appears to be corrupted
RESUME_PARSE_FAILED
Failed to parse resume content
RESUME_TOO_LARGE
Resume file exceeds maximum size limit
RESUME_EMPTY
Resume file is empty or contains no extractable content
RESUME_URL_BLOCKED
Resume URL is not allowed: internal or private addresses are blocked
Processing
AI_PROCESSING_FAILED
AI processing failed unexpectedly
AI_GENERATION_FAILED
Failed to generate content. Please try again.
AI_SCORING_FAILED
Failed to score application. Please try again.
MISSING_JOB_DESCRIPTION
Job description is required for AI scoring
TIMEOUT
Request timed out
MAX_RETRIES_EXCEEDED
Job exceeded maximum retry attempts
TASK_STUCK
Task did not complete within expected time
System
INTERNAL_ERROR
An unexpected error occurred
SERVICE_UNAVAILABLE
Service is temporarily unavailable
UNKNOWN
Unknown error