Post a Job

POST /v1/careers/jobs
{
  "title": "Senior Backend Engineer",
  "department": "Engineering",
  "location": "Remote — EU",
  "employment_type": "full_time",
  "description": "<h2>About the Role</h2><p>We are looking for a senior engineer to join our platform team...</p>",
  "requirements": ["5+ years backend experience", "Proficiency in Go or Rust"],
  "pipeline_id": "cpl_01HXYZ1111"
}

{
  "id": "job_01HXYZJOB1",
  "title": "Senior Backend Engineer",
  "status": "draft",
  "created_at": "2026-07-10T09:00:00Z",
  "application_url": "https://careers.example.com/jobs/job_01HXYZJOB1"
}

POST /v1/careers/jobs/job_01HXYZJOB1/publish
{
  "channels": ["careers_site", "linkedin", "indeed"]
}

# Pause a live job
POST /v1/careers/jobs/job_01HXYZJOB1/pause

# Close a job (stops applications)
POST /v1/careers/jobs/job_01HXYZJOB1/close
{ "close_reason": "Position filled" }

PATCH /v1/careers/jobs/job_01HXYZJOB1
{
  "application_form": {
    "fields": [
      { "name": "cover_letter", "required": true },
      { "name": "cv", "required": true },
      { "name": "portfolio_url", "required": false },
      { "name": "linkedin_url", "required": false }
    ],
    "custom_questions": [
      { "question": "What draws you to this role?", "type": "text", "required": true }
    ]
  }
}