v1

latestOpenAPI 3.1.02026-07-228814.1 KB

Jobs

Publish a draft

DRAFT → ACTIVE. Runs the three publish gates: completeness (422 with a field map), terms accepted in the dashboard (409 AGREEMENT_OUTDATED), and a card on file (402). The listing runs for 30 days.

post/jobs/{id}/publish

Path parameters

idinteger required

The job's stable cross-service id (svcAtsId).

Response

The job, now ACTIVE.

idinteger

Stable cross-service job id (svcAtsId).

titlestring

status'DRAFT' | 'ACTIVE' | 'PAUSED' | 'CLOSED' | 'EXPIRED'

descriptionstring

remoteOption'REMOTE' | 'HYBRID' | 'IN_PERSON' | 'null' nullable

remoteCountrystring nullable

jobType'FULL_TIME' | 'PART_TIME' | 'CONTRACT' | 'INTERNSHIP' | 'null' nullable

jobLevel'ENTRY' | 'MID' | 'SENIOR' | 'null' nullable

salaryMininteger nullable

salaryMaxinteger nullable

salaryPeriod'ANNUAL' | 'HOURLY' | 'null' nullable

bidPerQualifiedApplicantCentsinteger nullable

opportunityIdstring nullable

Partner id for this opening on the source ATS.

atsJobUrlstring uri nullable

Canonical job URL on the source ATS.

companyIdstring

isFrozenboolean

True once the job has applications. Qualifications/questions locked.

newApplicantCountinteger

publishedAtstring date-time nullable

expiresAtstring date-time nullable

closedAtstring date-time nullable

Example response

{
  "locations": [
    {
      "locationId": 17024,
      "displayName": "San Francisco, California, United States",
      "city": "San Francisco",
      "stateProvince": "California",
      "country": "United States"
    }
  ],
  "qualifications": [
    {
      "text": "5+ years of product design experience"
    }
  ],
  "questions": [
    {
      "prompt": "Why do you want to work here?"
    }
  ],
  "budgets": [
    {
      "budgetCents": 50000
    }
  ]
}