v1

latestOpenAPI 3.0.12026-07-243124341009.5 KB
Talent

Add Talent Skills

Adds talent skill tags. Added tags are displayed on the Tags tab of the talent’s profile page.

post/v1/talent/{talentId}/skills/add

Path parameters

talentIdstring required

The identifier for the talent whose skills are 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

skillIdinteger

The identifier for the talent skill.

talentIdinteger

The identifier for the talent.

positionIdinteger

The identifier for the position option.

descriptionIdinteger

The identifier for the description option.

skillPositionstring

The talent skill position option.

skillDescriptionstring

The talent skill description option.

skillTalentFacingboolean

An indication of whether a skill is visible and applicable to talent users.

Example request

[
  {
    "skillId": 2847,
    "talentId": 29384,
    "positionId": 643,
    "descriptionId": 7221,
    "skillPosition": "Clerical",
    "skillDescription": "Data Entry",
    "skillTalentFacing": true
  }
]

Response

The response containing the added talent skills.

errorsstring[]

A list of errors and their details.

Example response

{
  "talentSkills": [
    {
      "skillId": 2847,
      "talentId": 29384,
      "positionId": 643,
      "descriptionId": 7221,
      "skillPosition": "Clerical",
      "skillDescription": "Data Entry",
      "skillTalentFacing": true
    }
  ]
}