Skill Categories API

The Skill Categories API is for administering Skill Category records in Skills Base which includes adding, retrieving, updating and deleting records.

Endpoint

/1.0/skillcategories


Objects used by this API

Skill Category object

Name Data type Read only Description
id integer Yes The unique identifier for the record, used to reference the record in other API interactions.
parent_id integer No Parent Skill Category id
name string No Skill Category name


Methods

GET /skillcategories

Returns all Skill Categories in the instance.


GET /skillcategories/:id

Returns a Skill Category matching the given id


POST /skillcategories/search

Searches Skill Category records. See Search APIs for a description of search functionality.

The available search parameters are:

Name Arrays Wildcards
id Yes No
parent_id Yes No
name No Yes


POST /skillcategories

Creates a new Skill Category record.

The following parameters can be POSTed

Name Required
name Yes
parent_id No


PUT /skillcategories/:id

Updates an existing Skill Category record.

The following fields can be updated:

Name
parent_id
name


DELETE /skillcategories/:id

Deletes a Skill Category. Note that only empty Skill Categories can be deleted. That is, you cannot delete a Skill Category via this API if it contains other Skill Categories or Skills. You must remove each item before invoking this method, or alternatively delete the Skill Category via the Skills Base web application.