Update Job

patch

https://api.getkini.com/jobs/{id}

Update a specific Job detail identified by its unique ID.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

This endpoint partially updates an existing job belonging to the company selected via the Company-Id header.

Use the id path parameter to update the job; if the job does not belong to the scoped company, the API responds with a permission denied error.

Path Params

string

required

ID of the Job

Body Params

external_id

string

Job's ID in external ATS systems, used for integrations

company

integer

Kini ID of the company offering the job

title

string

length ≤ 255

Title of the job

description

string

Detailed description of the job's responsibilities and requirements

posting_url

uri

URL of the job posted on the company's career page

application_url

uri

URL through which applicants can apply on the company's career page

status

string

enum

Posting status of the job (active, deleted, archived)

Allowed:

remote

string

enum

Work mode of the job (remote, hybrid, on-site)

Allowed:

language

string

Language of the job posting

category

string

enum

Category of the job, e.g. 'sales'

employment_type

string

enum

Employment type of the job (permanent, contract, minijob, etc.)

work_schedule

string

enum

Work schedule type for the position (full-time, part-time, flexible)

Allowed:

senority

string

enum

Required or expected seniority level

start_date

string

Required or expected start date

contract_limitation

string

Contractual limitations or terms associated with the job

location_name

string

Full-text location of where the job is based

street

string

Street of the job's location

city

string

City of the job's location

country

string

Country of the job's location

postcode

string

Postal code of the job's location

longitude

string

^-?\d{0,3}(?:\.\d{0,6})?$

Longitude coordinate of the job's location

latitude

string

^-?\d{0,3}(?:\.\d{0,6})?$

Latitude coordinate of the job's location

salary

string

General description of the salary package

salary_from

integer

Starting salary range

salary_to

integer

Maximum salary range

salary_currency

string

Currency of the stated salary

salary_frequency

string

Payout frequency of the stated salary (annual, monthly, etc.)

contact_name

string

Name of the contact person responsible for the job posting

contact_email

string

E-Mail Address of the contact person responsible for the job posting

contact_title

string

Work title of the contact person responsible for the job posting

contact_phone

string

Phone Number of the contact person responsible for the job posting

banner_image

string

Banner Image URL

screening_questions

array of objects

screening_questions

description_sections

array of objects

description_sections

custom_fields

object

Custom fields for the job posting as key-value pairs

Headers

Company-Id

string

required

ID of the Company

Response

200