API Reference/Endpoints

Edit a job posting

PATCH/api/linkedin/gateway/linkedin/jobs/{job_id}

Updates fields on an existing draft or already-published posting. Send only the fields you want changed — everything else is left as-is.

Authentication

Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.

Path parameters

FieldTypeDescription

job_id *stringThe job posting's id.

Body parameters

FieldTypeDescription

account_id *stringThe connected account the posting belongs to.

job_titleobject{ id } or { text } to change the title.

companyobjectSame shape, to change the hiring company.

workplace"ON_SITE" | "HYBRID" | "REMOTE"Change the work arrangement.

locationstringA new location id.

employment_statusstringOne of FULL_TIME, PART_TIME, CONTRACT, TEMPORARY, OTHER, VOLUNTEER, INTERNSHIP.

descriptionstringReplaces the posting body. Basic HTML markup is allowed.

auto_rejection_templatestringReplaces the auto-rejection message.

screening_questionsarrayReplaces the qualifying questions.

apply_methodobject{ type: "linkedin" } or { type: "external" }.

recruiterobjectAdvanced settings — must include the existing project_id when changing anything here.

Response fields

FieldTypeDescription

job_idstringEchoes the posting's id.

Editing a posting doesn't change its state — a published posting stays published with the new content applied. Use Publish a job posting to move a draft live, or Close a job posting to take one down.

Errors

·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. account_id doesn't belong to this key.·404 Not Found. No job posting with that id belongs to this account.