Update by Job Reference

patch

https://yourdomain.jobboard.io/api/v1/jobs_by_reference/{reference}

Use the JobBoard.io API to update jobs from your job board

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

API requests are made via HTTPS using your account’s unique API key. Each request must be authenticated by including this API key in the request header as X-Api-Key. You can find your API token in Site Config.

The request header must contain your X-Api-Key, available in Site Config. Each request header must also contain "Content-Type: application/json".

The request body can contain:

Request Key	Request Value Example
title	Developer
company	Apple
location	London
apply_url	http://careers.apple.com
apply_email	[email protected]
description	We are building a new platform for linking virtual content to locations. We use QR codes, low energy bluetooth, and other hardware. Join our team today!
contact_email	[email protected]
company_url	http://apple.com
published	true or false
featured	true or false

Path Params

reference

string

required

Required - specify the job you would like to edit

Body Params

title

string

required

Job Name

company

string

required

Company Name

location

string

required

Location

remote

string

Is the job remote? Options are "full", "hybrid" and "onsite". Full - Job is 100% Remote. Location is not required if Remote is set to "Full". Hybrid - Job is both on site and remote. Onsite - Work must be conducted at the location specified in the "location" field.

description

string

required

Description

contact_email

string

required

Contact email for poster

apply_email

string

required

Apply Email (Either Apply Email or Apply URL is required)

apply_url

string

required

Apply URL (Either Apply Email or Apply URL is required)

how_to_apply

string

Additional Application Instructions

employer_id

string

36 character string identifying an employer. Can be found in the URL of the Employer of your admin panel. If an employer does not have an Active Package, the request will fail.

company_url

string

Company URL

logo

string

A direct URL link to an image - for example - http://jobboard.io/logo.png

featured

boolean

Defaults to false

Feature the job?

published_at

date

Published Date, desired format is YYYY-MM-DD HH:MM

published

string

Defaults to false

To automatically publish jobs, send true.

expiration_date

string

Expiration Date, desired format is YYYY-MM-DD HH:MM

job_type

string

Accepts String Values of Job Type - For example: "Full Time", "Part Time"

taxonomy

string

Add a taxonomy to the job posting. A semicolon separate list of taxonomy values is supported. Eg: "my_taxonomy_name": "value1;value2;value4",

salary_min

int32

The minimum salary for the job posting

salary_max

int32

The maximum salary for the position salary_currency

salary_currency

string

Pick one: USD CAD GBP EUR AUD NZD DKK SEK SGD ZAR HKD

salary_timeframe

string

Defaults to Annually

Pick one: Annually, Monthly, Hourly, Weekly

salary_display

string

Defaults to 0

Show the salary in the public job description (True = 1, False - 0)

salary_description

string

Additional compensation information (benefits, etc.)

urgent

boolean

Defaults to false

Mark the job Urgent?

source_name

string

Where is the job from? This will be included in the job table in the admin panel.

custom_field_answers

string

Must be JSON. Please contact support for assistance and examples.

Responses

204204

404404