Prompt a résumé

POSThttps://api.curriculo.me/public/prompt/

GEThttps://api.curriculo.me/public/prompt/resumes

GEThttps://api.curriculo.me/public/prompt/resume

On this page

Request
Examples
Response
One résumé per end user
Saved résumés
Data handling

Stateful. Works on the résumé pinned to your credential, or on one résumé per end user: generate, edit, translate or ask a question in plain language, in any language. Attach a CV once, then send instructions without re-uploading the file.

Price: $0.01 per request, including a request that attaches a CV.

Request

multipart/form-data

Field	Type	Notes
`prompt_text` (required)	string	Your instruction, for example "add Python to my skills" or "make the summary more concise".
`language`	string	ISO 639-1 code to render the résumé in. Omit to keep the source language.
`file`	file	Optional PDF or DOCX, 10 MB max. Attach on the first call to seed the résumé from an existing CV. Later calls edit that same résumé.
`template_id`	string	Defaults to `default`.

To get a translated résumé, set language. That, rather than asking for a translation in prompt_text, is how translation is requested.

Examples

First call, seeding the résumé from a CV:

curl -X POST https://api.curriculo.me/public/prompt/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -F 'file=@candidate.pdf' \
  -F 'prompt_text=Make the summary more concise'

A later call on the same résumé, rendered in Korean:

curl -X POST https://api.curriculo.me/public/prompt/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -F 'prompt_text=Add Python to my skills' \
  -F 'language=ko'

Response

One JSON response: an assistant_message to show your user, plus the updated résumé as structured segments under ai_response when it changed. mode says what happened: qa (a question was answered, nothing changed), modification or add-on (the résumé changed), or qa_with_modification (both).

One résumé per end user

By default every call works on the one résumé pinned to your key. To keep a separate résumé for each of your own users, add one of these headers to POST /prompt/. Both need a Console key and work on /prompt/ only; any other path returns 400.

Header	Value	Effect
`X-Curriculo-User-Id`	Your own ID for the end user: 1 to 128 ASCII letters, digits, `_`, `.`, `:`, `@` or `-`, starting with a letter or digit. Case-sensitive.	A new ID creates a new résumé for that user; reuse the same ID for follow-ups. Omit it to use the résumé pinned to your key.
`X-Curriculo-Target-Resume-Id`	A `resume_id` from `GET /prompt/resumes`	Updates that saved résumé. It never creates one: an unknown id returns `404`.

Send one or the other, not both (400). When either is set, the response also carries customer_id and resume_id.

curl -X POST https://api.curriculo.me/public/prompt/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -H 'X-Curriculo-User-Id: user-123' \
  -F 'file=@candidate.pdf' \
  -F 'prompt_text=Make the summary more concise'

Saved résumés

Two read-only endpoints let you browse the résumés stored for your account. They are free and need no prepaid balance. Console keys only; you only ever see your own account's records.

Endpoint	Query parameters	Returns
`GET /prompt/resumes`	`search`, `limit`, `offset`, `cursor`	Your account's saved résumés in `items` (`resume_id`, `external_user_id`, `customer_id`, `name`, `version`, `updated_at`), plus `next_cursor` for the next page (`null` when finished). `search` matches name, `external_user_id` or `resume_id`, ignoring case.
`GET /prompt/resume`	`resume_id`	One saved résumé

curl 'https://api.curriculo.me/public/prompt/resumes?limit=20' \
  -H 'Authorization: Bearer key_abc123_yoursecret'

Data handling

The résumé assistant keeps a working copy of the résumé so it can act on it across a session. See Data handling.

New to the Curriculo API? Start with the Quickstart.

Updated 12 October 2026