v1

latestOpenAPI 3.0.12026-07-243124341009.5 KB

Talent

Update a Talent Nomination Stage

Updates the specified talent nomination stage.

put/v1/talent/stage/{nominationId}

Path parameters

nominationIdstring required

The identifier for the talent nomination stage that should be updated.

Headers

RequestIdstring uuid

The unique request identifier used to correlate request data with log entries and events, formatted as a UUID.

Unique request identifier (UUID) used to correlate request data with log entries and events.

FrontOfficeTenantIdinteger

An integer identifier for the tenant that the request is being made for. Required when Tenant header is not provided.

Tenantstring

Tenant company code that determines data access scope during the request. Required when FrontOfficeTenantId header is not provided.

Request body

idinteger

The identifier for the talent nomination stage.

talentIdinteger required

The identifier for the talent.

jobIdinteger required

The identifier for the job.

jobActivityIdinteger

The identifier for the job activity.

jobActivityNamestring

The name of the job activity/talent nomination stage.

stagedDatestring date-time

The UTC date-time the talent moved to the most current stage. The field follows the YYYY-MM-DDTHH:mm:ss.sssZ format for UTC time. For example, 2024-12-01T14:30:00.546Z.

jobActivityStartDatestring date-time

The UTC start date-time of the job activity. The field follows the YYYY-MM-DDTHH:mm:ss.sssZ format for UTC time. For example, 2024-12-01T14:30:00.546Z.

jobActivityEndDatestring date-time

The UTC end date-time of the job activity. The field follows the YYYY-MM-DDTHH:mm:ss.sssZ format for UTC time. For example, 2024-12-01T14:30:00.546Z.

declinedStageDatestring date-time

The UTC date-time the talent declined the job. The field follows the YYYY-MM-DDTHH:mm:ss.sssZ format for UTC time. For example, 2024-12-01T14:30:00.546Z.

startedStageDatestring date-time

The UTC date-time the talent accepted the talent nomination stage. The field follows the YYYY-MM-DDTHH:mm:ss.sssZ format for UTC time. For example, 2024-12-01T14:30:00.546Z.

stageTypestring

The type of the nomination stage.

creditTointeger

The identifier for the talent's representative or recruiter user record.

Example request

{
  "id": 42280,
  "talentId": 189482,
  "jobId": 175529,
  "jobActivityId": 7382,
  "jobActivityName": "Offer Accepted",
  "stagedDate": "2024-12-01T14:30:00.546Z",
  "jobActivityStartDate": "2024-12-01T14:30:00.546Z",
  "jobActivityEndDate": "2024-12-01T14:30:00.546Z",
  "declinedStageDate": "2024-12-01T14:30:00.546Z",
  "startedStageDate": "2024-12-01T14:30:00.546Z",
  "stageType": "General",
  "creditTo": 24398
}

Response

The updated talent nomination stage.