v1

latestOpenAPI 3.0.12026-07-245752052.0 MB
talent

Update one or multiple talent

Partially update multiple existing talents

patch/api/servicepool/talents

Request body

OR

Example request

{
  "prospects": [
    {
      "email": "john.doe@example.com",
      "firstName": "John",
      "middleName": "William",
      "lastName": "Doe",
      "phone": "+1234567890",
      "homeAddress": {
        "address1": "275 Sacramento St.",
        "address2": "Building 5, Apt B",
        "city": "San Francisco",
        "zip": "94105",
        "state": "CA",
        "country": "US"
      },
      "csvImportFileUuid": "123e4567-e89b-12d3-a456-426614174000",
      "customAttributes": [
        {
          "customAttributeUuid": "123e4567-e89b-12d3-a456-426614174000"
        }
      ],
      "dateOfBirth": "1990-01-01",
      "filename": "prospects.csv",
      "homePhone": "+1234567890",
      "source": "csv",
      "timezone": "America/New_York",
      "onetV2Skills": [
        {
          "skill": "Skill 1",
          "category": "Category 1",
          "Element ID": "Element 1",
          "frequency": 1,
          "dataValue": 0.8,
          "evidence": "Evidence text"
        }
      ],
      "schemaVersion": 1
    }
  ],
  "wxWorkers": [
    {
      "wxWorkerUuid": "123e4567-e89b-12d3-a456-426614174000",
      "startDate": "2025-09-09T10:58:17.451+00:00",
      "hireDate": "2025-09-09T10:58:17.451+00:00",
      "terminationDate": "2025-09-09T10:58:17.451+00:00",
      "jobUuid": "123e4567-e89b-12d3-a456-426614174000",
      "employmentStatus": {
        "type": "created",
        "subtype": "applicant",
        "lastStatusUpdateDate": "2025-09-08T21:22:26.958+00:00"
      },
      "rehireEligible": true,
      "customAttributes": [
        {
          "customAttributeUuid": "123e4567-e89b-12d3-a456-426614174000",
          "value": "San Francisco"
        }
      ],
      "onetV2Skills": [
        {
          "skill": "Skill 1",
          "category": "Category 1",
          "Element ID": "Element 1",
          "frequency": 1,
          "dataValue": 0.8,
          "evidence": "Evidence text"
        }
      ],
      "schemaVersion": 1
    }
  ],
  "firstName": "William",
  "middleName": "William",
  "lastName": "Doe",
  "displayFullName": "John Doe",
  "dateOfBirth": "1990-01-01",
  "mobilePhone": {
    "number": "2484345508",
    "countryCode": "+1",
    "verified": true
  },
  "homeAddress": {
    "address1": "275 Sacramento St.",
    "address2": "Building 5, Apt B",
    "city": "San Francisco",
    "zip": "94105",
    "state": "CA",
    "country": "US",
    "location": {
      "type": "Point",
      "coordinates": [
        -122.39862,
        37.79438
      ]
    }
  },
  "lastActivityAt": "2025-09-09T10:58:17.451+00:00",
  "availability": {
    "monday": [
      "morning",
      "afternoon"
    ],
    "tuesday": [
      "morning",
      "afternoon"
    ],
    "wednesday": [
      "morning",
      "afternoon"
    ],
    "thursday": [
      "morning",
      "afternoon"
    ],
    "friday": [
      "morning",
      "afternoon"
    ],
    "saturday": [
      "morning",
      "afternoon"
    ],
    "sunday": [
      "morning",
      "afternoon"
    ]
  },
  "primaryCustomValues": {
    "customAttributes": [
      {
        "type": "concept",
        "conceptName": "Gender",
        "dataKey": "gender",
        "values": [
          {
            "rawValue": "MALE",
            "conceptOptionUuid": "123e4567-e89b-12d3-a456-426614174000",
            "label": "Male"
          }
        ],
        "customAttributeUuid": "123e4567-e89b-12d3-a456-426614174000",
        "value": "San Francisco",
        "uploadedAt": "2025-09-09T10:58:17.451+00:00"
      }
    ]
  }
}

Response

updated talent.

Example response

{
  "data": [
    {
      "prospects": [
        {
          "email": "john.doe@example.com",
          "firstName": "John",
          "middleName": "William",
          "lastName": "Doe",
          "phone": "+1234567890",
          "homeAddress": {
            "address1": "275 Sacramento St.",
            "address2": "Building 5, Apt B",
            "city": "San Francisco",
            "zip": "94105",
            "state": "CA",
            "country": "US"
          },
          "csvImportFileUuid": "123e4567-e89b-12d3-a456-426614174000",
          "customAttributes": [
            {
              "customAttributeUuid": "123e4567-e89b-12d3-a456-426614174000"
            }
          ],
          "dateOfBirth": "1990-01-01",
          "filename": "prospects.csv",
          "homePhone": "+1234567890",
          "source": "csv",
          "timezone": "America/New_York",
          "onetV2Skills": [
            {
              "skill": "Skill 1",
              "category": "Category 1",
              "Element ID": "Element 1",
              "frequency": 1,
              "dataValue": 0.8,
              "evidence": "Evidence text"
            }
          ],
          "schemaVersion": 1
        }
      ],
      "wxWorkers": [
        {
          "wxWorkerUuid": "123e4567-e89b-12d3-a456-426614174000",
          "startDate": "2025-09-09T10:58:17.451+00:00",
          "hireDate": "2025-09-09T10:58:17.451+00:00",
          "terminationDate": "2025-09-09T10:58:17.451+00:00",
          "jobUuid": "123e4567-e89b-12d3-a456-426614174000",
          "employmentStatus": {
            "type": "created",
            "subtype": "applicant",
            "lastStatusUpdateDate": "2025-09-08T21:22:26.958+00:00"
          },
          "rehireEligible": true,
          "customAttributes": [
            {
              "customAttributeUuid": "123e4567-e89b-12d3-a456-426614174000",
              "value": "San Francisco"
            }
          ],
          "onetV2Skills": [
            {
              "skill": "Skill 1",
              "category": "Category 1",
              "Element ID": "Element 1",
              "frequency": 1,
              "dataValue": 0.8,
              "evidence": "Evidence text"
            }
          ],
          "schemaVersion": 1
        }
      ],
      "firstName": "William",
      "middleName": "William",
      "lastName": "Doe",
      "displayFullName": "John Doe",
      "dateOfBirth": "1990-01-01",
      "mobilePhone": {
        "number": "2484345508",
        "countryCode": "+1",
        "verified": true
      },
      "homeAddress": {
        "address1": "275 Sacramento St.",
        "address2": "Building 5, Apt B",
        "city": "San Francisco",
        "zip": "94105",
        "state": "CA",
        "country": "US",
        "location": {
          "type": "Point",
          "coordinates": [
            -122.39862,
            37.79438
          ]
        }
      },
      "lastActivityAt": "2025-09-09T10:58:17.451+00:00",
      "availability": {
        "monday": [
          "morning",
          "afternoon"
        ],
        "tuesday": [
          "morning",
          "afternoon"
        ],
        "wednesday": [
          "morning",
          "afternoon"
        ],
        "thursday": [
          "morning",
          "afternoon"
        ],
        "friday": [
          "morning",
          "afternoon"
        ],
        "saturday": [
          "morning",
          "afternoon"
        ],
        "sunday": [
          "morning",
          "afternoon"
        ]
      },
      "primaryCustomValues": {
        "customAttributes": [
          {
            "type": "concept",
            "conceptName": "Gender",
            "dataKey": "gender",
            "values": [
              {
                "rawValue": "MALE",
                "conceptOptionUuid": "123e4567-e89b-12d3-a456-426614174000",
                "label": "Male"
              }
            ],
            "customAttributeUuid": "123e4567-e89b-12d3-a456-426614174000",
            "value": "San Francisco",
            "uploadedAt": "2025-09-09T10:58:17.451+00:00"
          }
        ]
      }
    }
  ],
  "meta": {
    "timestamp": "2021-05-05T09:47:58.924Z",
    "verb": "GET",
    "path": "/api/structure/resources/5949cf7c-fec6-4b31-947c-3aceabff58c5",
    "jti": "%cQN3RIGp",
    "rid": "$2d2zkHZ5",
    "count": 1,
    "status": "200",
    "duration": 17,
    "size": 1234
  }
}