---
title: "Update skills"
method: PUT
path: "/candidates/{candidateId}/skills"
tags: ["Candidate API:Skills"]
---

# Update skills

`PUT /candidates/{candidateId}/skills`

## Path parameters

- `candidateId` integer, required

## Request body

- UpdateCandidateSkillsCommand
  - `categories` SubmitCategoriesModel[], nullable — Skill categories to update for this candidate.<br /> Only skills and sub-categories for the submitted categories will be modified.
    - `categoryId` integer, required — Category to add or update in the skill coding.<br /> Specify a categoryId without subCategories for a broad classification. This will remove all previously linked sub-categories associated with the category.
    - `subCategories` SubmitSubCategoriesModel[], nullable — Optional list of sub-categories and skills for detailed skill classification
      - `subCategoryId` integer, required — Sub-category for detailed skill classification.<br /> Specify a subCategoryId without skills for a broad classification. This will remove all previously linked skills associated with the sub-category.
      - `skills` SubmitSkillsModel[], nullable — Optional list of skills associated with the sub-category for detailed classification
        - `skillId` integer, required — Skill for detailed skill classification.

## Response `200`

List of skills for the specified candidate

- CategoryListRepresentation
  - `items` CategoryModel[], nullable
    - `categoryId` integer, required
    - `name` string, required
    - `subCategories` SubCategoryModel[], nullable
      - `subCategoryId` integer, required
      - `name` string, required
      - `skills` SkillCategoryModel[], nullable
        - `skillId` integer, required
        - `name` string, required
  - `links` ModelLinks
    - `self` string, uri, nullable

---

[API](https://skmtc.net/jobadder/apis/jobadder-api.md) · [All operations](https://skmtc.net/jobadder/apis/jobadder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jobadder/jobadder-api/revisions/9f43f6a6ee6e/schema)