v1

latestOpenAPI 3.0.12026-07-243124341009.5 KB
Talent

Remove Talent Skills

Permanently deletes talent skills tags of the specified talent record.

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

Path parameters

talentIdstring required

An identifier for the talent whose skills are to be removed.

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 results of the attempt to remove the specified 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
    }
  ]
}