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 Requisitions API

Create, retrieve, edit, close, freeze, and manage job requisitions for open positions within Workday recruiting workflows.

Workday Recruiting Job Requisitions 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 Requisitions. 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 6 operations across 4 paths, and defines 4 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.

6 operations 4 paths 4 schemas 2 GET1 PATCH3 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 Requisitions 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 6

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

Job Requisitions 6

Create, retrieve, edit, close, freeze, and manage job requisitions for open positions within Workday recruiting workflows.

GET
/jobRequisitions
Workday Recruiting List Job Requisitions
listJobRequisitions 5 params → 200400401
POST
/jobRequisitions
Workday Recruiting Create a Job Requisition
createJobRequisition body → 201400401
GET
/jobRequisitions/{id}
Workday Recruiting Get a Job Requisition
getJobRequisition 1 param → 200401404
PATCH
/jobRequisitions/{id}
Workday Recruiting Edit a Job Requisition
editJobRequisition 1 param body → 200400401404
POST
/jobRequisitions/{id}/close
Workday Recruiting Close a Job Requisition
closeJobRequisition 1 param body → 200400401404
POST
/jobRequisitions/{id}/freeze
Workday Recruiting Freeze or Unfreeze a Job Requisition
manageJobRequisitionFreeze 1 param body → 200400401404

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are JobRequisition (20 properties), JobRequisitionCreate (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
JobRequisitionCreate
object
Request body for creating or updating a job requisition
13 properties 4 required
Reference
object
A reference to a related Workday resource
2 properties
JobRequisition
object
A job requisition represents a hiring need for a specific position within an organization, including the job profile, number of openings, compensation range, a…
20 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

workday-recruiting-job-requisitions-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 Postings API
Workday Recruiting Positions API
Workday Recruiting Recruiting Agencies API