Sign in

v1

latestOpenAPI 3.0.12026-07-243124341009.5 KB
Talent

Add Company Experience

Adds a company experience tag or a custom tag the company would like to use for the specified talent record. Added tag is displayed on the Tags tab of the talent profile page.

post/v1/talent/{talentId}/company

Path parameters

talentIdstring required

The identifier for the talent record to which the company experience tag is being added.

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 Company Experience Tag.

talentIdinteger required

The identifier for the talent.

companyIdinteger

The identifier for the company.

companyNamestring required

The name of the company.

expirationDatestring date-time

The expiration date of the talent's Company Experience Tag. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats. For example, 2024-12-01, 2024-12-01T14:30:00.

Example request

{
  "id": 299825,
  "talentId": 183992,
  "companyId": 25998,
  "companyName": "ABC Corp"
}

Response

The created company experience tag.

idinteger

The identifier for the Company Experience Tag.

talentIdinteger required

The identifier for the talent.

companyIdinteger

The identifier for the company.

companyNamestring required

The name of the company.

expirationDatestring date-time

The expiration date of the talent's Company Experience Tag. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats. For example, 2024-12-01, 2024-12-01T14:30:00.

Example response

{
  "id": 299825,
  "talentId": 183992,
  "companyId": 25998,
  "companyName": "ABC Corp"
}