Jobs

Create and manage your jobs to link candidates and interviews to them.

Required scope: jobs:read for reading, jobs:write for creating and updating.

List jobs

GET/api/v1/jobs

Returns the list of active jobs for the organization.

Query Parameters

Paramètre	Type	Requis	Description
`page`	integer	Non	Page number (default: 1).
`pageSize`	integer	Non	Results per page (default: 20).
`status`	string	Non	Filter by status: DRAFT \| ACTIVE \| PAUSED \| CLOSED.
`department`	string	Non	Filter by department.
`workMode`	string	Non	Filter by work mode: ONSITE \| REMOTE \| HYBRID.

Request

200 Response

GET/api/v1/jobs/:id

Returns the details of a job.

Path Parameters

Paramètre	Type	Requis	Description
`id`	string	Oui	Unique identifier of the job.

Request

200 Response

POST/api/v1/jobs

Creates a new job.

Body Parameters

Paramètre	Type	Requis	Description
`title`	string	Oui	Job title.
`description`	string	Non	Detailed job description.
`department`	string	Non	Department or team (e.g. Engineering, Sales).
`location`	string	Non	Job location (e.g. Paris, France).
`workMode`	string	Non	Work mode: ONSITE \| REMOTE \| HYBRID.
`seniority`	string	Non	Seniority level: INTERN \| JUNIOR \| MID \| SENIOR \| LEAD \| MANAGER \| DIRECTOR.
`contractType`	string	Non	Contract type: CDI \| CDD \| FREELANCE \| INTERNSHIP \| APPRENTICESHIP.
`salaryMin`	integer	Non	Minimum annual salary in K€ (e.g. 40 for 40,000 €).
`salaryMax`	integer	Non	Maximum annual salary in K€.
`dailyRate`	integer	Non	Daily rate in € for freelance positions.
`skills`	string[]	Non	List of required skills.
`status`	string	Non	Initial status: DRAFT (default) \| ACTIVE.

Request

201 Response