Error Code Reference - Nova Documentation

Every error response includes a 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

Property	Value
HTTP Status	401
Retryable	No
Surfaces	HTTP API

Invalid or missing API key

FORBIDDEN

Property	Value
HTTP Status	403
Retryable	No
Surfaces	HTTP API

You do not have permission to access this resource

Validation

VALIDATION_ERROR

Property	Value
HTTP Status	400
Retryable	No
Surfaces	HTTP API

Request validation failed

ANSWER_MISMATCH

Property	Value
HTTP Status	400
Retryable	No
Surfaces	HTTP API

Provided answers do not match question set

CRITERIA_INVALID

Property	Value
HTTP Status	400
Retryable	No
Surfaces	HTTP API

Criteria configuration is invalid

Not Found

NOT_FOUND

Property	Value
HTTP Status	404
Retryable	No
Surfaces	HTTP API

Resource not found

TENANT_NOT_FOUND

Property	Value
HTTP Status	404
Retryable	No
Surfaces	HTTP API

Tenant not found

JOB_NOT_FOUND

Property	Value
HTTP Status	404
Retryable	No
Surfaces	HTTP API

Job not found

APPLICATION_NOT_FOUND

Property	Value
HTTP Status	404
Retryable	No
Surfaces	HTTP API

Application not found

QUESTION_SET_NOT_FOUND

Property	Value
HTTP Status	404
Retryable	No
Surfaces	HTTP API

Question set not found or expired

CRITERIA_NOT_FOUND

Property	Value
HTTP Status	404
Retryable	No
Surfaces	HTTP API, Scoring Jobs

No criteria found for this job

CRITERION_NOT_FOUND

Property	Value
HTTP Status	404
Retryable	No
Surfaces	HTTP API

Criterion not found

CRITERIA_VERSION_NOT_FOUND

Property	Value
HTTP Status	404
Retryable	No
Surfaces	HTTP API

Criteria version not found

SCORING_JOB_NOT_FOUND

Property	Value
HTTP Status	404
Retryable	No
Surfaces	HTTP API

Scoring job not found

BATCH_NOT_FOUND

Property	Value
HTTP Status	404
Retryable	No
Surfaces	HTTP API

Batch not found

LIBRARY_CRITERION_NOT_FOUND

Property	Value
HTTP Status	404
Retryable	No
Surfaces	HTTP API

Library criterion not found

Rate Limiting

RATE_LIMITED

Property	Value
HTTP Status	429
Retryable	Yes
Surfaces	HTTP API

Rate limit exceeded. Please retry after the reset time.

Resume

RESUME_FETCH_FAILED

Property	Value
HTTP Status	422
Retryable	Yes (may vary per instance)
Surfaces	HTTP API, Scoring Jobs, Webhooks

Failed to fetch resume from provided URL

RESUME_ENCRYPTED

Property	Value
HTTP Status	422
Retryable	No
Surfaces	HTTP API, Scoring Jobs, Webhooks

Resume is password-protected or encrypted

RESUME_CORRUPTED

Property	Value
HTTP Status	422
Retryable	No
Surfaces	HTTP API, Scoring Jobs, Webhooks

Resume file appears to be corrupted

RESUME_PARSE_FAILED

Property	Value
HTTP Status	422
Retryable	No
Surfaces	HTTP API, Scoring Jobs, Webhooks

Failed to parse resume content

RESUME_TOO_LARGE

Property	Value
HTTP Status	422
Retryable	No
Surfaces	HTTP API, Scoring Jobs, Webhooks

Resume file exceeds maximum size limit

RESUME_EMPTY

Property	Value
HTTP Status	422
Retryable	No
Surfaces	HTTP API, Scoring Jobs, Webhooks

Resume file is empty or contains no extractable content

RESUME_URL_BLOCKED

Property	Value
HTTP Status	400
Retryable	No
Surfaces	HTTP API

Resume URL is not allowed: internal or private addresses are blocked

Processing

AI_PROCESSING_FAILED

Property	Value
HTTP Status	500
Retryable	Yes
Surfaces	HTTP API

AI processing failed unexpectedly

AI_GENERATION_FAILED

Property	Value
HTTP Status	502
Retryable	Yes (may vary per instance)
Surfaces	HTTP API

Failed to generate content. Please try again.

AI_SCORING_FAILED

Property	Value
HTTP Status	502
Retryable	Yes (may vary per instance)
Surfaces	HTTP API, Scoring Jobs, Webhooks

Failed to score candidate. Please try again.

MISSING_JOB_DESCRIPTION

Property	Value
HTTP Status	400
Retryable	No
Surfaces	HTTP API, Scoring Jobs, Webhooks

Job description is required for AI scoring

TIMEOUT

Property	Value
HTTP Status	504
Retryable	Yes
Surfaces	HTTP API, Scoring Jobs

Request timed out

MAX_RETRIES_EXCEEDED

Property	Value
HTTP Status	500
Retryable	No
Surfaces	Scoring Jobs, Webhooks

Job exceeded maximum retry attempts

TASK_STUCK

Property	Value
HTTP Status	500
Retryable	No
Surfaces	Scoring Jobs, Webhooks

Task did not complete within expected time

System

INTERNAL_ERROR

Property	Value
HTTP Status	500
Retryable	Yes
Surfaces	HTTP API, Scoring Jobs, Webhooks

An unexpected error occurred

SERVICE_UNAVAILABLE

Property	Value
HTTP Status	503
Retryable	Yes
Surfaces	HTTP API

Service is temporarily unavailable

UNKNOWN

Property	Value
HTTP Status	500
Retryable	No
Surfaces	None

Unknown error

Getting started

Core concepts

API endpoints

Integration guides

​Auth

​UNAUTHORIZED

​FORBIDDEN

​Validation

​VALIDATION_ERROR

​ANSWER_MISMATCH

​CRITERIA_INVALID

​Not Found

​NOT_FOUND

​TENANT_NOT_FOUND

​JOB_NOT_FOUND

​APPLICATION_NOT_FOUND

​QUESTION_SET_NOT_FOUND

​CRITERIA_NOT_FOUND

​CRITERION_NOT_FOUND

​CRITERIA_VERSION_NOT_FOUND

​SCORING_JOB_NOT_FOUND

​BATCH_NOT_FOUND

​LIBRARY_CRITERION_NOT_FOUND

​Rate Limiting

​RATE_LIMITED

​Resume

​RESUME_FETCH_FAILED

​RESUME_ENCRYPTED

​RESUME_CORRUPTED

​RESUME_PARSE_FAILED

​RESUME_TOO_LARGE

​RESUME_EMPTY

​RESUME_URL_BLOCKED

​Processing

​AI_PROCESSING_FAILED

​AI_GENERATION_FAILED

​AI_SCORING_FAILED

​MISSING_JOB_DESCRIPTION

​TIMEOUT

​MAX_RETRIES_EXCEEDED

​TASK_STUCK

​System

​INTERNAL_ERROR

​SERVICE_UNAVAILABLE

​UNKNOWN

Auth

UNAUTHORIZED

FORBIDDEN

Validation

VALIDATION_ERROR

ANSWER_MISMATCH

CRITERIA_INVALID

Not Found

NOT_FOUND

TENANT_NOT_FOUND

JOB_NOT_FOUND

APPLICATION_NOT_FOUND

QUESTION_SET_NOT_FOUND

CRITERIA_NOT_FOUND

CRITERION_NOT_FOUND

CRITERIA_VERSION_NOT_FOUND

SCORING_JOB_NOT_FOUND

BATCH_NOT_FOUND

LIBRARY_CRITERION_NOT_FOUND

Rate Limiting

RATE_LIMITED

Resume

RESUME_FETCH_FAILED

RESUME_ENCRYPTED

RESUME_CORRUPTED

RESUME_PARSE_FAILED

RESUME_TOO_LARGE

RESUME_EMPTY

RESUME_URL_BLOCKED

Processing

AI_PROCESSING_FAILED

AI_GENERATION_FAILED

AI_SCORING_FAILED

MISSING_JOB_DESCRIPTION

TIMEOUT

MAX_RETRIES_EXCEEDED

TASK_STUCK

System

INTERNAL_ERROR

SERVICE_UNAVAILABLE

UNKNOWN