Talentino Docs
API ReferencePartner API v1

Import a single Resume

POST/resumes

Imports one Resume document, supplied either as a multipart file part or as a JSON url. When import_activity_id is omitted a validated disk Import Activity is auto-created so processing runs straight through; when provided, the Resume is linked to that Import Activity (which must belong to the caller's Business Unit). candidate_id is resolved asynchronously by the pipeline and is therefore null in the response.

Authorization

ApiKeyBearer
AuthorizationBearer <token>

Business Unit-scoped Partner API Key, issued from Talentino settings and shown once at creation. Send it as Authorization: Bearer tlt_…. Limited to 60 requests per minute per key.

In: header

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/resumes" \  -H "Content-Type: application/json" \  -d '{    "url": "https://files.example.com/cv/jane-doe.pdf",    "import_activity_id": 1234  }'
{  "message": "Resume import started",  "success": true,  "data": {    "resume_id": 90871,    "candidate_id": null,    "import_activity_id": 1234,    "import_activity_created": false  }}
{  "error": "Invalid or revoked API key",  "success": false}
{  "error": "Invalid or revoked API key",  "success": false}
{  "error": "Insufficient credits to process this request",  "success": false}
{  "error": "Invalid or revoked API key",  "success": false}
{  "error": "A resume with identical content already exists in this business unit",  "success": false}
{  "error": "Invalid or revoked API key",  "success": false}
{  "error": "Invalid or revoked API key",  "success": false}
{  "error": "Rate limit exceeded for partner API",  "success": false}
{  "error": "Invalid or revoked API key",  "success": false}
{  "error": "Invalid or revoked API key",  "success": false}