Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Workday Recruiting Job Postings API

Post, update, and unpost jobs to internal and external career sites, and manage job posting site configurations.

Workday Recruiting Job Postings API is one of 13 APIs that Workday Recruiting publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 56 JSON Schema definitions.

Tagged areas include Job Postings. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, rate-limit docs, a JSON-LD context, and 56 JSON Schemas.

This API exposes 5 operations across 4 paths, and defines 3 schemas. It is described by OpenAPI 3.1.0, at version v41.2.

Requests are made against a single base URL, https://{tenant}.workday.com/ccx/api/recruiting/v41.2.

5 operations 4 paths 3 schemas 2 GET1 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
v41.2
Base URL
https://wd2-impl-services1.workday.com/ccx/api/recruiting/
Authentication
OAuth 2.0
Terms of Service
Resource Areas
1

Authentication & Security 1

Workday Recruiting Job Postings API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oauth2) using the authorizationCode flow, exposing 2 scopes. By default, every request must be authenticated.

  • oauth2 — OAuth 2.0 authentication. Register an API client in Workday, grant recruiting scopes, and obtain access tokens.

Paths & Operations 5

Across 4 paths, the API surfaces 5 operations — 2 GET, 1 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Job Postings 5

Post, update, and unpost jobs to internal and external career sites, and manage job posting site configurations.

GET
/jobPostings
Workday Recruiting List Job Postings
listJobPostings 5 params → 200401
GET
/jobPostings/{id}
Workday Recruiting Get a Job Posting
getJobPosting 1 param → 200401404
PATCH
/jobPostings/{id}
Workday Recruiting Update a Job Posting
updateJobPosting 1 param body → 200400401404
POST
/jobPostings/{id}/post
Workday Recruiting Post a Job to Career Sites
postJob 1 param body → 200400401404
POST
/jobPostings/{id}/unpost
Workday Recruiting Unpost a Job
unpostJob 1 param → 200401404

Schemas 3

The contract defines 3 schemas that model the data the API accepts and returns. The most detailed are JobPosting (13 properties), Error (3 properties), Reference (2 properties). Each schema is shown below with its type and property counts.

Error
object
API error response
3 properties
Reference
object
A reference to a related Workday resource
2 properties
JobPosting
object
A job posting is a public-facing representation of a job requisition published to internal or external career sites for candidate attraction.
13 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

workday-recruiting-job-postings-api-openapi.yml Raw ↑

Other APIs Workday Recruiting publishes across the network.

Workday Recruiting SOAP Web Services API
Workday Recruiting agentDefinition API
Workday Recruiting Applicants API
Workday Recruiting Background Checks API
Workday Recruiting Candidates API
Workday Recruiting Configuration API
Workday Recruiting Evergreen Requisitions API
Workday Recruiting Interviews API
Workday Recruiting Job Applications API
Workday Recruiting Job Requisitions API
Workday Recruiting Positions API
Workday Recruiting Recruiting Agencies API