Error Code Reference

Complete reference of public error codes returned by the Nova Embed API.

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

CRITERIA_REVISION_CONFLICT

Property	Value
HTTP Status	409
Retryable	No
Surfaces	HTTP API

Criteria changed before the write was applied

---

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.

---

Idempotency

These errors apply to criteria and library mutations that use the HTTP Idempotency-Key replay layer. Scoring submissions use built-in scoring idempotency instead.

IDEMPOTENCY_KEY_ALREADY_USED

Property	Value
HTTP Status	422
Retryable	No
Surfaces	HTTP API

Idempotency-Key has already been used with different request parameters

IDEMPOTENCY_REQUEST_IN_PROGRESS

Property	Value
HTTP Status	409
Retryable	Yes
Surfaces	HTTP API

A request with this Idempotency-Key is currently being processed

---

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_CONVERSION_FAILED

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

Failed to convert resume document to a supported format

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 application. 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