Sign in

v1

latestOpenAPI 3.0.12026-07-243124341009.5 KB
Jobs

Add Job Skills

Adds new skills to the skill set for a particular job. Skills are displayed in the Position Categories and Skill Set section of the job profile page.

post/v1/job/{jobId}/skills/add

Path parameters

jobIdstring required

The identifier for the job for which the 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

jobSkillIdinteger

The identifier for the job skill.

jobIdinteger required

The identifier for the job.

descriptionIdinteger

The identifier for the skill description option.

positionIdinteger

The identifier for the skill position option.

skillDescriptionstring

The skill description option.

skillPositionstring

The skill position option.

skillTalentFacingboolean

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

Example request

[
  {
    "jobSkillId": 184928,
    "jobId": 1578224,
    "descriptionId": 7735,
    "positionId": 643,
    "skillDescription": "Data Entry",
    "skillPosition": "Clerical",
    "skillTalentFacing": true
  }
]

Response

A list of all job skills for the specified job.

errorsstring[]

A list of validation errors generated while attempting to modify the skills associated with a job.

Example response

{
  "jobSkills": [
    {
      "jobSkillId": 184928,
      "jobId": 1578224,
      "descriptionId": 7735,
      "positionId": 643,
      "skillDescription": "Data Entry",
      "skillPosition": "Clerical",
      "skillTalentFacing": true
    }
  ]
}