Skip to main content
PUT
Update a job

Authorizations

x-api-key
string
header
required

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

Path Parameters

id
string
required

Body

application/json
companyId
string
Minimum string length: 1
description
string | null
employmentType
enum<string> | null
Available options:
fullTime,
partTime,
temporary,
internship,
permanent,
fixedTermContract,
interimOrTemporary,
contract
locationType
enum<string> | null
Available options:
remote,
hybrid,
onsite
restricted
boolean
location
object | null
deprecated

Deprecated: use locations instead. A single physical location for the job. Ignored when locations is provided.

locations
object[]

Physical locations for the job (0 to 15). Takes precedence over the deprecated location field. Omit to leave unchanged; send an empty array to clear all.

Maximum array length: 15
languages
object[]

Languages required for the job (0 to 100). Omit to leave unchanged; send an empty array to clear all.

Maximum array length: 100
salaryRange
object | null
startAt
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
endAt
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
teamUserIds
string[]
Minimum string length: 1
clientContactIds
string[]
Minimum string length: 1
stageId
string
Minimum string length: 1
name
string
Minimum string length: 1
scorecard
object[]
dealValue
object | null
targetCompanyId
string | null
Minimum string length: 1

Response

Job updated successfully