v1

latestOpenAPI 3.0.12026-07-243124341009.5 KB
Talent

Add Talent Source

Adds a talent source tag. Added tag is displayed on the Tags tab of the talent profile page under Applicant Source.

post/v1/talent-source

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 Source Tag.

talentIdinteger required

The identifier for the talent.

sourceIdinteger

The identifier for the Talent Source option.

sourceNamestring

The name of the Talent Source option.

expirationDatestring date-time

The expiration date of the Talent Source Tag. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats, for example, 2024-12-01 or 2024-12-01T00:00:00.

Example request

{
  "id": 28942,
  "talentId": 19390,
  "sourceId": 284,
  "sourceName": "LinkedIn"
}

Response

The talent source was successfully added.

idinteger

The identifier for the Talent Source Tag.

talentIdinteger required

The identifier for the talent.

sourceIdinteger

The identifier for the Talent Source option.

sourceNamestring

The name of the Talent Source option.

expirationDatestring date-time

The expiration date of the Talent Source Tag. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats, for example, 2024-12-01 or 2024-12-01T00:00:00.

Example response

{
  "id": 28942,
  "talentId": 19390,
  "sourceId": 284,
  "sourceName": "LinkedIn"
}