# Skills

Skills are used in Kantata OX to describe capabilities of users for the purposes of resource planning.
They can be associated with a user through a Skill Membership.
A user can be associated with up to 200 skills.
This model includes categories such as 'Skill', 'Language', 'Certification' and 'Other'.

## Fetching a list of Skills

 - [GET /skills](https://developer.kantata.com/kantata/specification/skills/get-skills.md): The Skills endpoint provides a list of every Skill that belongs to the Account of the User making the request.
The response will contain an array of Skill objects, sorted alphabetically by the name attribute.

NOTE: You cannot create more than 5000 skills per account.


This endpoint returns structured Skill objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the skills top-level JSON key.
Please see our Response Format section for more information.

## Creating a new Skill

 - [POST /skills](https://developer.kantata.com/kantata/specification/skills/create-skill.md): Adds a new skill to the account.

Note: You cannot create more than 5000 skills per account.

Bulk Create

This endpoint supports bulk creating up to 200 objects. In the request body, set the top-level key to its plural form and place the objects in an array. Example:


  {
  "skills": [
    {
      "name": "Skill",
      "skill_category_id": 123
    },
    {
      "name": "Skill 2",
      "skill_category_id": 456
    }
  ]
}



This endpoint returns structured Skill objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the skills top-level JSON key.
Please see our Response Format section for more information.

## Fetching a single Skill

 - [GET /skills/{id}](https://developer.kantata.com/kantata/specification/skills/get-skill.md): This endpoint returns structured Skill objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the skills top-level JSON key.
Please see our Response Format section for more information.

## Updating an existing Skill

 - [PUT /skills/{id}](https://developer.kantata.com/kantata/specification/skills/update-skill.md): This endpoint returns structured Skill objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the results array
and will be indexed by ID in the skills top-level JSON key.
Please see our Response Format section for more information.

## Deleting an existing Skill

 - [DELETE /skills/{id}](https://developer.kantata.com/kantata/specification/skills/delete-skill.md): The response will contain no content and an HTTP 204 status code if the request was
successful, or a standard Kantata OX error message explaining why the object could not be deleted.