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 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.

Tagged areas include agentDefinition. 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.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 27 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 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.

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

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