Import Resumes in bulk
/resumes/bulkImports up to 50 Resume documents in one request. Multipart requests may mix repeated files parts and repeated urls fields (reported in wire order); JSON requests carry a urls array. The whole batch shares one Import Activity (provided or a single auto-created validated disk Import Activity) and one processing trigger.
One bad document never fails the batch: each document resolves to exactly one entry in data.items (input order), and data.summary carries the counts. The response is 201 when at least one document was accepted, or 422 when every document failed (nothing created or published — the per-item reasons are still in data.items). Whole-request validation (empty/over-cap batch, foreign import_activity_id, insufficient credits for the full batch, unsupported Content-Type) fails up front with a 4xx.
Authorization
ApiKeyBearer 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
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
curl -X POST "https://example.com/resumes/bulk" \ -H "Content-Type: application/json" \ -d '{ "urls": [ "https://files.example.com/cv/a.pdf", "https://files.example.com/cv/b.docx" ], "import_activity_id": 1234 }'{ "message": "Bulk resume import started", "success": true, "data": { "items": [ { "index": 0, "source": "url", "filename_or_url": "https://files.example.com/cv/a.pdf", "status": "accepted", "resume_id": 90872, "import_activity_id": 1234 }, { "index": 1, "source": "url", "filename_or_url": "https://files.example.com/cv/b.docx", "status": "failed", "error": "DocumentTooLarge: document exceeds the 5MB limit" } ], "summary": { "total": 2, "accepted": 1, "failed": 1 }, "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": "Invalid or revoked API key", "success": false}{ "message": "All documents in the batch failed", "success": false, "data": { "items": [ { "index": 0, "source": "url", "filename_or_url": "https://files.example.com/cv/a.pdf", "status": "failed", "error": "UnsupportedDocumentType: text/plain is not accepted" } ], "summary": { "total": 1, "accepted": 0, "failed": 1 }, "import_activity_id": null, "import_activity_created": false }}{ "error": "Rate limit exceeded for partner API", "success": false}{ "error": "Invalid or revoked API key", "success": false}