The Roles API is for administering Role records in Skills Base which includes adding, retrieving, updating and deleting records.

Endpoint

/1.0/roles


Objects used by this API

Role 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.
name string No Role name

Methods

GET /roles

Returns all Roles in the instance.


GET /roles/:id

Returns a Role matching the given id


POST /roles/search

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

The available search parameters are:

Name Arrays Wildcards
id Yes No
name No Yes


POST /roles

Creates a new Role record.

The following parameters can be POSTed

Name Required
name Yes


PUT /roles/:id

Updates an existing Role record.

The following fields can be updated:

Name
name


DELETE /roles/:id

Deletes a Role