PATCH : Update job

This endpoint lets you update one job for a given company, inside media.

This endpoint requires :

brand_admin, media_admin or media_partner roles.

r_w_jobs scope.

Important informations

  • This endpoint have a short rate limits → Rate limits

  • For SEO reason, you cannot update job's name

  • By default, all job published have a maximum duration time of 90 days. After this period they are automatically pass to archived

  • For Data management reason, you can create job only on company currently published inside a media. The error retrieve in this case company-not-published

Update job

PATCH https://api.piloty.fr/jobs/job-public-id

Path Parameters

Name
Type
Description

job-public-id*

String

Public id of the job

Request Body - required

Name
Type
Description

media_public_id*

string

eg: 'acme_media'

company_public_id*

string

eg: 'acme_company'

Request Body - other

Name
Type
Description

contract_id

string

job_category_id

string

localisation

string

eg: "Paris, Ile de France, France"

description_job

string

eg: "We are looking for ...."

application_method

enum

external_apply | internal_apply

application_url

url

Required if application_method === external_apply

state

enum

draftpublished | archived

worktime_id

string

remote_policy_id

string

education_id

string

experience_id

string

salary

string

max 30 characters

description_company

string

eg: "ACME company is ...."

description_profile

string

eg: "As a ...."

description_benefits

string

eg: "At ACME Company ...."

description_process

string

eg: "Hiring process ..."

manager_emails

string

The email list will be notified when an automatic action is performed on the job. Separator: ;

Limit: 4 emails.

recruiter_emails

string

The email list will be notified when an application is made on the job.

Separator: ;

Limit: 4 emails.

Request example

Last updated