Skip to main content
POST
Create a job description

Authorizations

x-api-key
string
header
required

API key for authentication. Get your API key from Settings → API Keys in your Spott dashboard.

Body

application/json
vacancyId
string
required
Minimum string length: 1
language
enum<string>

The language of the job description to create. Defaults to the workspace default job description language when omitted.

Available options:
en-US,
en-GB,
es,
nl,
fr,
de,
hu,
cs,
pt,
no,
sv,
da,
fi,
pl,
ro,
it,
af,
cy,
ja
format
enum<string>
default:FREEFORM

The content format of the job description to create. FREEFORM stores a single HTML body; STRUCTURED stores separate blocks whose derived HTML is exposed on content. Defaults to FREEFORM when omitted.

Available options:
FREEFORM,
STRUCTURED

Response

Job description created successfully

id
string
required
Minimum string length: 1