Add a Talent Nomination Stage

post

https://api.avionte.com/front-office/v1/talent/stage

Adds a talent nomination stage for a job. This information is displayed on the talent profile page.

Body Params

int32

The identifier for the talent nomination stage.

talentId

int32

required

The identifier for the talent.

jobId

int32

required

The identifier for the job.

jobActivityId

int32

The identifier for the job activity.

jobActivityName

string

length ≤ 255

The name of the job activity/talent nomination stage.

stagedDate

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.

jobActivityStartDate

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.

jobActivityEndDate

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.

declinedStageDate

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.

startedStageDate

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.

stageType

string

length ≤ 255

The type of the nomination stage.

creditTo

int32

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

Headers

RequestId

uuid

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

FrontOfficeTenantId

integer

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

Tenant

string

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

Responses

401

Unauthorized

403

Access Denied

405

Unsupported method

406

Unsupported format(s) indicated by Accept header

415

Unsupported format(s) indicated by the Content-Type header

429

Too many requests

500

An unexpected error occurred

502

Service Unavailable

504

Gateway Timeout

201The Talent Nomination Stage that was successfully added.

400Bad Request

404Not found