---
title: "Add a Talent Nomination Stage"
method: POST
path: "/v1/talent/stage"
tags: ["Talent"]
---

# Add a Talent Nomination Stage

`POST /v1/talent/stage`

## Request

- Base URL: `https://api.avionte.com/front-office`
- URL: `https://api.avionte.com/front-office/v1/talent/stage`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

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

## Headers

- `RequestId` string, uuid: Unique request identifier in UUID format used to correlate request data to log entries and events.
- `FrontOfficeTenantId` integer
- `Tenant` string

## Request body

- TalentStage
  - `id` integer: The identifier for the talent nomination stage.
  - `talentId` integer, required: The identifier for the talent.
  - `jobId` integer, required: The identifier for the job.
  - `jobActivityId` integer: The identifier for the job activity.
  - `jobActivityName` string: The name of the job activity/talent nomination stage.
  - `stagedDate` string, 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` string, 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` string, 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` string, 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` string, 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: The type of the nomination stage.
  - `creditTo` integer: The identifier for the talent's representative or recruiter user record.

## Response `201`

The Talent Nomination Stage that was successfully added.

- TalentStage
  - `id` integer: The identifier for the talent nomination stage.
  - `talentId` integer, required: The identifier for the talent.
  - `jobId` integer, required: The identifier for the job.
  - `jobActivityId` integer: The identifier for the job activity.
  - `jobActivityName` string: The name of the job activity/talent nomination stage.
  - `stagedDate` string, 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` string, 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` string, 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` string, 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` string, 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: The type of the nomination stage.
  - `creditTo` integer: The identifier for the talent's representative or recruiter user record.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Access Denied
- `404`: Not found
- `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

---

[API](https://skmtc.dev/avionte/apis/bold-front-office-api.md) - [All operations](https://skmtc.dev/avionte/apis/bold-front-office-api/llms.txt) - [OpenAPI document](https://skmtc.dev/avionte/apis/bold-front-office-api/revisions/bd5996cbaa0f?raw)