{
  "opencollection": "1.0.0",
  "info": {
    "name": "Workday Recruiting REST Applicants Candidates API",
    "version": "v41.2"
  },
  "request": {
    "auth": {
      "type": "oauth2",
      "flow": "authorization_code",
      "authorizationUrl": "https://{tenant}.workday.com/authorize",
      "accessTokenUrl": "https://{tenant}.workday.com/ccx/oauth2/token",
      "credentials": {
        "clientId": "{{clientId}}",
        "clientSecret": "{{clientSecret}}"
      }
    }
  },
  "items": [
    {
      "info": {
        "name": "Candidates",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Workday Recruiting List Candidates",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{tenant}.workday.com/ccx/api/recruiting/v41.2/candidates",
            "params": [
              {
                "name": "limit",
                "value": "20",
                "type": "query",
                "description": "Maximum number of results to return per page"
              },
              {
                "name": "offset",
                "value": "0",
                "type": "query",
                "description": "Number of results to skip for pagination"
              },
              {
                "name": "updatedFrom",
                "value": "2026-05-03T14:30:00Z",
                "type": "query",
                "description": "Return candidates updated on or after this date-time"
              },
              {
                "name": "name",
                "value": "Senior Software Engineer",
                "type": "query",
                "description": "Filter candidates by name (partial match supported)"
              },
              {
                "name": "email",
                "value": "candidate@example.com",
                "type": "query",
                "description": "Filter candidates by email address"
              }
            ]
          },
          "docs": "Retrieve a collection of candidates with optional filtering. Returns candidate profile information including name, contact details, source, and associated job applications."
        },
        {
          "info": {
            "name": "Workday Recruiting Create a Candidate",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{tenant}.workday.com/ccx/api/recruiting/v41.2/candidates",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Add a new candidate record to the Workday recruiting system. Includes personal information, contact details, and optionally associates the candidate with a job application."
        },
        {
          "info": {
            "name": "Workday Recruiting Get a Candidate",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{tenant}.workday.com/ccx/api/recruiting/v41.2/candidates/:id",
            "params": [
              {
                "name": "id",
                "value": "11111111-2222-3333-4444-555555555555",
                "type": "path",
                "description": "Workday ID (WID) of the resource"
              }
            ]
          },
          "docs": "Retrieve detailed information for a specific candidate including personal information, contact details, source, tags, and associated job applications."
        },
        {
          "info": {
            "name": "Workday Recruiting Update a Candidate",
            "type": "http"
          },
          "http": {
            "method": "PATCH",
            "url": "https://{tenant}.workday.com/ccx/api/recruiting/v41.2/candidates/:id",
            "params": [
              {
                "name": "id",
                "value": "11111111-2222-3333-4444-555555555555",
                "type": "path",
                "description": "Workday ID (WID) of the resource"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Update an existing candidate record with new personal information, contact details, or other profile attributes."
        },
        {
          "info": {
            "name": "Workday Recruiting List Candidate Attachments",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{tenant}.workday.com/ccx/api/recruiting/v41.2/candidates/:id/attachments",
            "params": [
              {
                "name": "id",
                "value": "11111111-2222-3333-4444-555555555555",
                "type": "path",
                "description": "Workday ID (WID) of the resource"
              }
            ]
          },
          "docs": "Retrieve attachments associated with a candidate, including resumes, cover letters, and other supporting documents."
        },
        {
          "info": {
            "name": "Workday Recruiting Add a Candidate Attachment",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{tenant}.workday.com/ccx/api/recruiting/v41.2/candidates/:id/attachments",
            "params": [
              {
                "name": "id",
                "value": "11111111-2222-3333-4444-555555555555",
                "type": "path",
                "description": "Workday ID (WID) of the resource"
              }
            ],
            "body": {
              "type": "multipart-form",
              "data": [
                {
                  "name": "file",
                  "type": "text",
                  "value": ""
                },
                {
                  "name": "category",
                  "type": "text",
                  "value": ""
                }
              ]
            }
          },
          "docs": "Upload an attachment such as a resume, cover letter, or portfolio document to a candidate record."
        },
        {
          "info": {
            "name": "Workday Recruiting Get a Candidate Photo",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{tenant}.workday.com/ccx/api/recruiting/v41.2/candidates/:id/photo",
            "params": [
              {
                "name": "id",
                "value": "11111111-2222-3333-4444-555555555555",
                "type": "path",
                "description": "Workday ID (WID) of the resource"
              }
            ]
          },
          "docs": "Retrieve the photo associated with a candidate record."
        },
        {
          "info": {
            "name": "Workday Recruiting Update a Candidate Photo",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://{tenant}.workday.com/ccx/api/recruiting/v41.2/candidates/:id/photo",
            "params": [
              {
                "name": "id",
                "value": "11111111-2222-3333-4444-555555555555",
                "type": "path",
                "description": "Workday ID (WID) of the resource"
              }
            ]
          },
          "docs": "Upload or replace the photo for a candidate record."
        },
        {
          "info": {
            "name": "Workday Recruiting Assess a Candidate",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{tenant}.workday.com/ccx/api/recruiting/v41.2/candidates/:id/assess",
            "params": [
              {
                "name": "id",
                "value": "11111111-2222-3333-4444-555555555555",
                "type": "path",
                "description": "Workday ID (WID) of the resource"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create or modify a candidate assessment and optionally advance the candidate through job application stages based on the assessment outcome."
        },
        {
          "info": {
            "name": "Workday Recruiting Refer a Candidate",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://{tenant}.workday.com/ccx/api/recruiting/v41.2/candidates/:id/refer",
            "params": [
              {
                "name": "id",
                "value": "11111111-2222-3333-4444-555555555555",
                "type": "path",
                "description": "Workday ID (WID) of the resource"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Submit a candidate referral from an existing worker. Associates the referred candidate with a job requisition and records the referral source."
        }
      ]
    }
  ],
  "bundled": true
}