opening

Change a job

Changes a job's fields, closes it (status closed: its page says it no longer takes applications) or reopens a closed job as a draft. An open job's new title, place, pay or benefits show on its page at once, and its history keeps every version it was published with.

patch/openings/{opening_id}

Request

  • Base URL: https://localhost:4410/api/v1
  • URL: https://localhost:4410/api/v1/openings/{opening_id}
  • Auth: HTTP bearer

Path parameters

opening_idstring required

Request body

titlestring
employment_type'full_time' | 'part_time' | 'contract' | 'internship' | 'temporary'
descriptionstring
benefitsstring
equity_notestring nullable
closing_datestring date nullable
daily_limitinteger nullable
confirm_emailboolean
status'closed' | 'draft'

Response

The result.

idstring required
public_idstring required
status'draft' | 'open' | 'closed' required
titlestring required
employment_type'full_time' | 'part_time' | 'contract' | 'internship' | 'temporary' required
benefitsstring required
urlstring required
published_atstring date-time nullable required
closed_atstring date-time nullable required
created_atstring date-time required
descriptionstring required
description_source'typed' | 'outline' | 'ai_draft' required
equity_notestring nullable required
closing_datestring date nullable required
daily_limitinteger nullable required
confirm_emailboolean required
eeoboolean required
published_bystring nullable required
closed_bystring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.