How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Workday Recruiting agentDefinition API

To view and maintain Agent Definitions with the Agent System of Record.

Workday Recruiting agentDefinition 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.

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 27 schemas. It is described by OpenAPI 3.2.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 27 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.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 agentDefinition 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.

agentDefinition 2

To view and maintain Agent Definitions with the Agent System of Record.

GET
/agentDefinition
This operation returns the specific Agent Definition including Skills and certain Tools used in those Skills.
→ 200400401403404default
POST
/agentDefinition
Based on the A2A Agent Card specification, this REST operation allows you to create an Agent Definition in Workday.
body → 201400401403404default

Schemas 27

The contract defines 27 schemas that model the data the API accepts and returns. The most detailed are ERROR_MODEL_REFERENCE (4 properties), INSTANCE_MODEL_REFERENCE (3 properties). Each schema is shown below with its type and property counts.

ERROR_MODEL_REFERENCE
object
4 properties 1 required
tags_71f49719113310002d148ce3f5370002
provider_799da24a09dd10000b827743c6f40000
The service provider of the agent
defaultInputModes_71f497191133100013c9a17716d50000
agentSkill_881e3f87712810000d0bf06dae650000
agent_resource_2e69afd4e86c10001ad2755763bc0000
The Workday Resource for this Tools if applicable.
platform_ca94626efa9010003262e35486130000
The platform of the agent.
agentCapabilites_799da24a09dd10000e37766515630000
defaultOutputModes_71f497191133100013c9a17716d50001
skillTools_881e3f877128100010f2ba3820a20000
skills_881e3f87712810000d1cfd55ee0d0000
executionMode_d785eba56e9c10003761356522e00000
The Execution Mode this Skill is operating in. Either Ambient, or Delegate.
tools_a81e152b86021000158c36e9bbdc0001
workdayResources_881e3f877128100010fb617ba5260000
outputModes_71f49719113310002d148ce3f5370000
workdayConfig_881e3f87712810000d1cfd55ee0d0001
agentPlatform_aa793a5c168d1000143f8b9f05c50000
mimeType_71f4971911331000139693324a560000
inputModes_71f49719113310002d148ce3f5370001
workdayResource_2e69afd4e86c10001fae2831c6da0000
workdayTool_a81e152b86021000158aa15c84900000
agentSkillTag_71f49719113310002d130aa875ca0000
agentSkillResource_881e3f87712810000d1ba8a0a0510000
agentCardAndTools_a5967cb3b88b10001f7a6900b0d90000
VALIDATION_ERROR_MODEL_REFERENCE
INSTANCE_MODEL_REFERENCE
object
3 properties 1 required
capabilities_799da24a09dd10000e3a424ec7340000
Optional capabilities supported by the agent.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

workday-recruiting-agentdefinition-api-openapi.yml Raw ↑

Other APIs Workday Recruiting publishes across the network.

Workday Recruiting SOAP Web Services 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 Positions API
Workday Recruiting Recruiting Agencies API
Where this information came from

This is an independent, third-party profile of Workday Recruiting agentDefinition API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.