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

Create and manage positions and position restrictions within the position management staffing model.

Workday Recruiting Positions 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 Positions. 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 2 operations across 1 path, 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.

2 operations 1 paths 4 schemas 1 GET1 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 Positions 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 2

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

Positions 2

Create and manage positions and position restrictions within the position management staffing model.

GET
/positions
Workday Recruiting List Positions
listPositions 2 params → 200401
POST
/positions
Workday Recruiting Create a Position
createPosition body → 201400401

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are Position (11 properties), PositionCreate (7 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
PositionCreate
object
Request body for creating a position
7 properties 2 required
Reference
object
A reference to a related Workday resource
2 properties
Position
object
A position in the position management staffing model representing an allocated headcount within a supervisory organization.
11 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

workday-recruiting-positions-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 Job Requisitions API
Workday Recruiting Recruiting Agencies API