Update Job

Update an existing job offer, or create it if it doesn’t exist (upsert).


PUT /api/integrations/job/{externalJobId}

Path Parameters

Parameter	Description
`externalJobId`	The job ID you provided when creating the job

Headers

Header	Required	Description
`x-api-key`	Yes	Your API key
`Content-Type`	Yes	`application/json`

Request Body

Send only the fields you want to update. Fields not included will remain unchanged.


{
  "job": {
    "title": "Senior Software Engineer",
    "description": "<p>Updated job description...</p>",
    "city": ["Casablanca", "Rabat"]
  }
}

All fields from the Create Job endpoint are accepted.

Response

Updated — `200`


{
  "jobId": 1234,
  "jobUrl": "https://www.jobzyn.com/fr/companies/your-company/jobs/software-engineer-abc123",
  "error": null
}

Created (upsert) — `201`

If no job with this externalJobId exists for your company, a new job is created.


{
  "jobId": 1235,
  "jobUrl": "https://www.jobzyn.com/fr/companies/your-company/jobs/senior-product-manager-def456",
  "error": null
}

Authentication Error — `403`


{
  "jobId": null,
  "error": {
    "message": "Invalid API key"
  }
}

Example


curl -X PUT https://www.jobzyn.com/api/integrations/job/REQ-2024-001 \
  -H "Content-Type: application/json" \
  -H "x-api-key: jz_your_api_key_here" \
  -d '{
    "job": {
      "title": "Senior Product Manager",
      "city": ["Casablanca", "Rabat"],
      "workMode": "REMOTE",
      "minSalary": 18000,
      "maxSalary": 25000,
      "displaySalary": true
    }
  }'