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 Payroll agentDefinition API

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

Workday Payroll agentDefinition API is one of 21 APIs that Workday Payroll publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 138 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 138 JSON Schemas.

This API exposes 2 operations across 1 path, and defines 27 schemas. It is described by OpenAPI 3.1.0, at version v1.

Requests are made against 2 base URLs: https://api.workday.com/payroll-input/v1, https://{tenant}.workday.com/api/payroll-input/v1.

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
v1
Base URL
https://api.workday.com/payroll/v1
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

Workday Payroll agentDefinition API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — OAuth 2.0 bearer token obtained through Workday authentication.

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.

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

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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

Other APIs Workday Payroll publishes across the network.

Workday Payroll Deductions API
Workday Payroll Earnings API
Workday Payroll Input Batches API
Workday Payroll One-Time Payments API
Workday Payroll Pay Groups API
Workday Payroll Pay Runs API
Workday Payroll Payment Elections API
Workday Payroll Payment Results API
Workday Payroll Payroll Adjustments API
Workday Payroll Payroll Calculations API
Workday Payroll Payroll Summaries API
Workday Payroll Payslips API