Bulk Ingest (REST)

Upcoming as a key-authenticated partner API. This page defines the surface. Bulk resume and job upload are available today in the Exterview app. See Authentication & Scopes.

Purpose

Typed REST routes for loading candidates and jobs in bulk, plus a status route to poll progress.

Published routes

Endpoint	Why
`GET /api/health`	Liveness check, no auth required
`POST /api/candidates/bulk-upload-resumes`	Typed candidate ingest, `write` scope
`GET /api/candidates/bulk-upload-status/{jobId}`	Poll bulk-upload progress
`POST /api/jobs/add-by-file`	Typed job ingest from a JD file, `write` scope

POST /api/upload is not published. Generic blob upload is an abuse and quota risk. Partners must ingest through the typed routes above.

FAQs

How do we track a bulk upload?

Poll GET /api/candidates/bulk-upload-status/{jobId} until it reports complete.

Can we upload arbitrary files?

No. The generic upload route is not published. Use the typed candidate and job ingest routes.

What scope do ingest routes need?

The write scope. The health check needs no auth.

Jobs & Candidates. The single-record CRUD behind these batch routes.
Developer API. The pattern for polling asynchronous results.

​Purpose

​Published routes

​FAQs

​Related

Purpose

Published routes

FAQs

Related