Start a new, empty CV under a name of your choosing.

Pick a short name you will use for the rest of the conversation, such as the surname of the person the CV is for. A name already in use is refused rather than replaced.

Record who the CV is about, replacing anything set before.

This is the one section a finished CV cannot leave out. Send it again with the full details whenever you learn more; it overwrites rather than merges.

Add one job to the CV, after the jobs already added.

Add jobs in the order they should be printed, which for a Europass CV is most recent first.

Add one qualification or training period, after those already added.

Add one language the person speaks, with how well they speak it.

Add every language separately, mother tongues included. Look the language code up with lookup_language if you are not certain of it.

Add one digital or computer skill, after those already added.

Add every skill as its own call. Europass prints these as free text, so a single call naming several skills is recorded as one skill with a long name rather than as the list it reads like.

Check the draft against the Europass schema and report what is wrong.

Safe to call at any point: an unfinished CV is expected to have issues, and each one says where it is and, for a value drawn from a code list, what valid values are spelled most like the one refused.

Write the finished CV as Europass XML.

A draft that would not validate is refused rather than exported, so what comes back is always a schema-valid Europass document. Call validate_cv first to find out what is still missing.

Lay the finished CV out as a PDF, with its Europass XML inside it.

Refuses a draft that would not validate, exactly as export_xml does, and refuses where this server cannot make PDFs at all; the message says what to do instead. The XML travels inside the PDF as an attachment, so the document a reader receives is still the document a machine can read back.

What comes back is a link rather than the file, because a CV is hundreds of kilobytes and would crowd out the rest of this conversation. Give the link to the user, or read the resource it names if you need the bytes yourself.

Refuses a draft whose name cannot be read back out of that link, which is why a draft meant for a PDF wants an ordinary name.

Find the country codes Europass recognises for a country you can name.

Answers a country in any of the languages the schema documents, so both Italy and Italien find IT. Each match is a [code, label] pair, the likeliest first, and a query close to nothing returns nothing.

Find the language codes Europass recognises for a language you can name.

Each match is a [code, label] pair, the likeliest first. The search covers every language Europass knows; a few of them are not accepted as a mother tongue, which validation will say.

Find the occupation codes for a job you can describe.

These are job titles as the ISCO-88 classification words them, so search for the profession rather than the person's own job title. Each match is a [code, label] pair, the likeliest first.