{
"info": {
"_postman_id": "46ed48c1-a1f9-4595-9c24-48f3631b0e15",
"name": "Workday Payroll Input Deductions agentDefinition API",
"description": "API for submitting and managing payroll input data within the Workday platform, including one-time payments, payroll adjustments, supplemental earnings, and batch input submissions.\n\nContact Support:\n Name: Workday Support\n Email: support@workday.com",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
"createdAt": "2026-07-28T03:32:00.000Z",
"updatedAt": "2026-07-28T03:32:00.000Z",
"lastUpdatedBy": "35240",
"uid": "35240-46ed48c1-a1f9-4595-9c24-48f3631b0e15"
},
"item": [
{
"name": "agentDefinition",
"item": [
{
"name": "This operation returns the specific Agent Definition including Skills and certain Tools used in those Skills.",
"id": "ed12160b-485b-4ec2-b411-340132ef2602",
"protocolProfileBehavior": {
"disableBodyPruning": true
},
"request": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/agentDefinition",
"host": [
"{{baseUrl}}"
],
"path": [
"agentDefinition"
]
},
"description": "This operation returns the specific Agent Definition including Skills and certain Tools used in those Skills. Each definition can contain many Skills, and in those Skills they *may* contain Tools based on the Invocation / Execution Type. Generally REST APIs will be listed here.\n\nSecured by: Development, Setup: Agents"
},
"response": [
{
"id": "3a71cf97-1175-4f0e-ba2c-4ced3397963c",
"name": "Successful response. A successful response can return no matched data.",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: bearer",
"key": "Authorization",
"value": "Bearer "
}
],
"url": {
"raw": "{{baseUrl}}/agentDefinition",
"host": [
"{{baseUrl}}"
],
"path": [
"agentDefinition"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"total\": \"\",\n \"data\": [\n {\n \"description\": \"\",\n \"name\": \"\",\n \"skills\": [\n {\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"tags\": [\n {\n \"tag\": \"\",\n \"id\": \"\"\n },\n {\n \"tag\": \"\",\n \"id\": \"\"\n }\n ],\n \"inputModes\": [\n {\n \"type\": \"\",\n \"id\": \"\"\n },\n {\n \"type\": \"\",\n \"id\": \"\"\n }\n ],\n \"outputModes\": [\n {\n \"type\": \"\",\n \"id\": \"\"\n },\n {\n \"type\": \"\",\n \"id\": \"\"\n }\n ]\n },\n {\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"tags\": [\n {\n \"tag\": \"\",\n \"id\": \"\"\n },\n {\n \"tag\": \"\",\n \"id\": \"\"\n }\n ],\n \"inputModes\": [\n {\n \"type\": \"\",\n \"id\": \"\"\n },\n {\n \"type\": \"\",\n \"id\": \"\"\n }\n ],\n \"outputModes\": [\n {\n \"type\": \"\",\n \"id\": \"\"\n },\n {\n \"type\": \"\",\n \"id\": \"\"\n }\n ]\n }\n ],\n \"url\": \"\",\n \"version\": \"\",\n \"overview\": \"\",\n \"defaultInputModes\": [\n {\n \"type\": \"\",\n \"id\": \"\"\n },\n {\n \"type\": \"\",\n \"id\": \"\"\n }\n ],\n \"id\": \"\",\n \"documentationUrl\": \"\",\n \"capabilities\": {\n \"pushNotifications\": \"\",\n \"stateTransitionHistory\": \"\",\n \"streaming\": \"\"\n },\n \"externalTenantID\": \"\",\n \"externalAgentID\": \"\",\n \"provider\": {\n \"id\": \"46a825aec28a7c549f3cb01b25f2df19\",\n \"descriptor\": \"\",\n \"href\": \"\"\n },\n \"iconUrl\": \"\",\n \"workdayConfig\": [\n {\n \"workdayResources\": [\n {\n \"description\": \"\",\n \"tool_name\": \"\",\n \"agent_resource\": {\n \"descriptor\": \"\",\n \"id\": \"\"\n },\n \"tools\": [\n {\n \"id\": \"\",\n \"descriptor\": \"\"\n },\n {\n \"id\": \"\",\n \"descriptor\": \"\"\n }\n ],\n \"id\": \"\"\n },\n {\n \"description\": \"\",\n \"tool_name\": \"\",\n \"agent_resource\": {\n \"descriptor\": \"\",\n \"id\": \"\"\n },\n \"tools\": [\n {\n \"id\": \"\",\n \"descriptor\": \"\"\n },\n {\n \"id\": \"\",\n \"descriptor\": \"\"\n }\n ],\n \"id\": \"\"\n }\n ],\n \"skillId\": \"\",\n \"executionMode\": {\n \"id\": \"c{J=IMFmd=]x(\",\n \"descriptor\": \"\",\n \"href\": \"\"\n },\n \"id\": \"\"\n },\n {\n \"workdayResources\": [\n {\n \"description\": \"\",\n \"tool_name\": \"\",\n \"agent_resource\": {\n \"descriptor\": \"\",\n \"id\": \"\"\n },\n \"tools\": [\n {\n \"id\": \"\",\n \"descriptor\": \"\"\n },\n {\n \"id\": \"\",\n \"descriptor\": \"\"\n }\n ],\n \"id\": \"\"\n },\n {\n \"description\": \"\",\n \"tool_name\": \"\",\n \"agent_resource\": {\n \"descriptor\": \"\",\n \"id\": \"\"\n },\n \"tools\": [\n {\n \"id\": \"\",\n \"descriptor\": \"\"\n },\n {\n \"id\": \"\",\n \"descriptor\": \"\"\n }\n ],\n \"id\": \"\"\n }\n ],\n \"skillId\": \"\",\n \"executionMode\": {\n \"id\": \"7d8d8d08a60b93c65de6ff7c808e21ea\",\n \"descriptor\": \"\",\n \"href\": \"\"\n },\n \"id\": \"\"\n }\n ],\n \"supportsAuthenticatedExtendedCard\": \"\",\n \"platform\": {\n \"reference_id\": \"\",\n \"descriptor\": \"\",\n \"id\": \"\"\n },\n \"defaultOutputModes\": [\n {\n \"type\": \"\",\n \"id\": \"\"\n },\n {\n \"type\": \"\",\n \"id\": \"\"\n }\n ]\n },\n {\n \"description\": \"\",\n \"name\": \"\",\n \"skills\": [\n {\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"tags\": [\n {\n \"tag\": \"\",\n \"id\": \"\"\n },\n {\n \"tag\": \"\",\n \"id\": \"\"\n }\n ],\n \"inputModes\": [\n {\n \"type\": \"\",\n \"id\": \"\"\n },\n {\n \"type\": \"\",\n \"id\": \"\"\n }\n ],\n \"outputModes\": [\n {\n \"type\": \"\",\n \"id\": \"\"\n },\n {\n \"type\": \"\",\n \"id\": \"\"\n }\n ]\n },\n {\n \"description\": \"\",\n \"id\": \"\",\n \"name\": \"\",\n \"tags\": [\n {\n \"tag\": \"\",\n \"id\": \"\"\n },\n {\n \"tag\": \"\",\n \"id\": \"\"\n }\n ],\n \"inputModes\": [\n {\n \"type\": \"\",\n \"id\": \"\"\n },\n {\n \"type\": \"\",\n \"id\": \"\"\n }\n ],\n \"outputModes\": [\n {\n \"type\": \"\",\n \"id\": \"\"\n },\n {\n \"type\": \"\",\n \"id\": \"\"\n }\n ]\n }\n ],\n \"url\": \"\",\n \"version\": \"\",\n \"overview\": \"\",\n \"defaultInputModes\": [\n {\n \"type\": \"\",\n \"id\": \"\"\n },\n {\n \"type\": \"\",\n \"id\": \"\"\n }\n ],\n \"id\": \"\",\n \"documentationUrl\": \"\",\n \"capabilities\": {\n \"pushNotifications\": \"\",\n \"stateTransitionHistory\": \"\",\n \"streaming\": \"\"\n },\n \"externalTenantID\": \"\",\n \"externalAgentID\": \"\",\n \"provider\": {\n \"id\": \"5rsrr_Cg)=U$])BDVp\",\n \"descriptor\": \"\",\n \"href\": \"\"\n },\n \"iconUrl\": \"\",\n \"workdayConfig\": [\n {\n \"workdayResources\": [\n {\n \"description\": \"\",\n \"tool_name\": \"\",\n \"agent_resource\": {\n \"descriptor\": \"\",\n \"id\": \"\"\n },\n \"tools\": [\n {\n \"id\": \"\",\n \"descriptor\": \"\"\n },\n {\n \"id\": \"\",\n \"descriptor\": \"\"\n }\n ],\n \"id\": \"\"\n },\n {\n \"description\": \"\",\n \"tool_name\": \"\",\n \"agent_resource\": {\n \"descriptor\": \"\",\n \"id\": \"\"\n },\n \"tools\": [\n {\n \"id\": \"\",\n \"descriptor\": \"\"\n },\n {\n \"id\": \"\",\n \"descriptor\": \"\"\n }\n ],\n \"id\": \"\"\n }\n ],\n \"skillId\": \"\",\n \"executionMode\": {\n \"id\": \"6ab3be45b0d1bc1d992d56ef9e78cf24\",\n \"descriptor\": \"\",\n \"href\": \"\"\n },\n \"id\": \"\"\n },\n {\n \"workdayResources\": [\n {\n \"description\": \"\",\n \"tool_name\": \"\",\n \"agent_resource\": {\n \"descriptor\": \"\",\n \"id\": \"\"\n },\n \"tools\": [\n {\n \"id\": \"\",\n \"descriptor\": \"\"\n },\n {\n \"id\": \"\",\n \"descriptor\": \"\"\n }\n ],\n \"id\": \"\"\n },\n {\n \"description\": \"\",\n \"tool_name\": \"\",\n \"agent_resource\": {\n \"descriptor\": \"\",\n \"id\": \"\"\n },\n \"tools\": [\n {\n \"id\": \"\",\n \"descriptor\": \"\"\n },\n {\n \"id\": \"\",\n \"descriptor\": \"\"\n }\n ],\n \"id\": \"\"\n }\n ],\n \"skillId\": \"\",\n \"executionMode\": {\n \"id\": \"lFjj=yr4\",\n \"descriptor\": \"\",\n \"href\": \"\"\n },\n \"id\": \"\"\n }\n ],\n \"supportsAuthenticatedExtendedCard\": \"\",\n \"platform\": {\n \"reference_id\": \"\",\n \"descriptor\": \"\",\n \"id\": \"\"\n },\n \"defaultOutputModes\": [\n {\n \"type\": \"\",\n \"id\": \"\"\n },\n {\n \"type\": \"\",\n \"id\": \"\"\n }\n ]\n }\n ]\n}",
"createdAt": "2026-07-28T03:32:00.000Z",
"updatedAt": "2026-07-28T03:32:00.000Z",
"uid": "35240-3a71cf97-1175-4f0e-ba2c-4ced3397963c"
},
{
"id": "3804e156-1f46-4abd-96d7-9c36e91061c0",
"name": "Invalid request. (https://community.workday.com/rest/error-messages)",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: bearer",
"key": "Authorization",
"value": "Bearer "
}
],
"url": {
"raw": "{{baseUrl}}/agentDefinition",
"host": [
"{{baseUrl}}"
],
"path": [
"agentDefinition"
]
}
},
"status": "Bad Request",
"code": 400,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"error\": \"\",\n \"errors\": [\n {\n \"error\": \"\",\n \"code\": \"\",\n \"field\": \"\",\n \"path\": \"\"\n },\n {\n \"error\": \"\",\n \"code\": \"\",\n \"field\": \"\",\n \"path\": \"\"\n }\n ]\n}",
"createdAt": "2026-07-28T03:32:00.000Z",
"updatedAt": "2026-07-28T03:32:00.000Z",
"uid": "35240-3804e156-1f46-4abd-96d7-9c36e91061c0"
},
{
"id": "d67146c5-e609-418e-915c-243fc5248b53",
"name": "Unauthorized: Missing or invalid credentials. (https://community.workday.com/rest/error-messages)",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: bearer",
"key": "Authorization",
"value": "Bearer "
}
],
"url": {
"raw": "{{baseUrl}}/agentDefinition",
"host": [
"{{baseUrl}}"
],
"path": [
"agentDefinition"
]
}
},
"status": "Unauthorized",
"code": 401,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"error\": \"\",\n \"errors\": [\n {\n \"error\": \"\",\n \"code\": \"\",\n \"field\": \"\",\n \"path\": \"\"\n },\n {\n \"error\": \"\",\n \"code\": \"\",\n \"field\": \"\",\n \"path\": \"\"\n }\n ]\n}",
"createdAt": "2026-07-28T03:32:00.000Z",
"updatedAt": "2026-07-28T03:32:00.000Z",
"uid": "35240-d67146c5-e609-418e-915c-243fc5248b53"
},
{
"id": "15e2fbc7-52c0-41ce-b082-44d6c3b38d67",
"name": "User has insufficient permissions. (https://community.workday.com/rest/error-messages)",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: bearer",
"key": "Authorization",
"value": "Bearer "
}
],
"url": {
"raw": "{{baseUrl}}/agentDefinition",
"host": [
"{{baseUrl}}"
],
"path": [
"agentDefinition"
]
}
},
"status": "Forbidden",
"code": 403,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"error\": \"\",\n \"errors\": [\n {\n \"error\": \"\",\n \"code\": \"\",\n \"field\": \"\",\n \"path\": \"\"\n },\n {\n \"error\": \"\",\n \"code\": \"\",\n \"field\": \"\",\n \"path\": \"\"\n }\n ]\n}",
"createdAt": "2026-07-28T03:32:00.000Z",
"updatedAt": "2026-07-28T03:32:00.000Z",
"uid": "35240-15e2fbc7-52c0-41ce-b082-44d6c3b38d67"
},
{
"id": "cd403a65-4a97-4915-b897-9ab6e107e45f",
"name": "Resource not found. (https://community.workday.com/rest/error-messages)",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: bearer",
"key": "Authorization",
"value": "Bearer "
}
],
"url": {
"raw": "{{baseUrl}}/agentDefinition",
"host": [
"{{baseUrl}}"
],
"path": [
"agentDefinition"
]
}
},
"status": "Not Found",
"code": 404,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"error\": \"\",\n \"errors\": [\n {\n \"error\": \"\",\n \"code\": \"\",\n \"field\": \"\",\n \"path\": \"\"\n },\n {\n \"error\": \"\",\n \"code\": \"\",\n \"field\": \"\",\n \"path\": \"\"\n }\n ]\n}",
"createdAt": "2026-07-28T03:32:00.000Z",
"updatedAt": "2026-07-28T03:32:00.000Z",
"uid": "35240-cd403a65-4a97-4915-b897-9ab6e107e45f"
},
{
"id": "ef594e30-1532-40c3-9cbd-3d756311e64c",
"name": "An error occurred.",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
},
{
"description": "Added as a part of security scheme: bearer",
"key": "Authorization",
"value": "Bearer "
}
],
"url": {
"raw": "{{baseUrl}}/agentDefinition",
"host": [
"{{baseUrl}}"
],
"path": [
"agentDefinition"
]
}
},
"status": "Internal Server Error",
"code": 500,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"cookie": [],
"responseTime": null,
"body": "{\n \"error\": \"\",\n \"code\": \"\",\n \"field\": \"\",\n \"path\": \"\"\n}",
"createdAt": "2026-07-28T03:32:00.000Z",
"updatedAt": "2026-07-28T03:32:00.000Z",
"uid": "35240-ef594e30-1532-40c3-9cbd-3d756311e64c"
}
],
"createdAt": "2026-07-28T03:32:00.000Z",
"updatedAt": "2026-07-28T03:32:00.000Z",
"uid": "35240-ed12160b-485b-4ec2-b411-340132ef2602"
},
{
"name": "Based on the A2A Agent Card specification, this REST operation allows you to create an Agent Definition in Workday.",
"id": "9bb1fa9a-2328-4c20-9c36-514f9686dd51",
"protocolProfileBehavior": {
"disableBodyPruning": true
},
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "multipart/form-data"
},
{
"key": "Accept",
"value": "application/json"
}
],
"body": {
"mode": "formdata",
"formdata": [
{
"description": "(Required) A human-readable description of the agent. Used to assist users and other agents in understanding what the agent can do.",
"key": "description",
"value": "",
"type": "text"
},
{
"description": "(Required) Human readable name of the agent.",
"key": "name",
"value": "",
"type": "text"
},
{
"description": "(Required) Skills are a unit of capability that an agent can perform.",
"key": "skills",
"value": "[object Object],[object Object]",
"type": "text"
},
{
"description": "(Required) A URL to the address the agent is hosted at.",
"key": "url",
"value": "",
"type": "text"
},
{
"description": "(Required) The version of the agent - format is up to the provider.",
"key": "version",
"value": "",
"type": "text"
},
{
"description": "The overview message for the agent.",
"key": "overview",
"value": "",
"type": "text"
},
{
"description": "The set of interaction modes that the agent supports across all skills. This can be overridden per-skill. Supported media types for input.",
"key": "defaultInputModes",
"value": "[object Object],[object Object]",
"type": "text"
},
{
"description": "Agent Definition ID. Used to link Agent Versions.",
"key": "id",
"value": "