API / Competencies
With /competencies endpoint you can manage the competencies in Silverbucket and these competencies can be used to represent users' competencies.
https://<your_environment_url>/customer-api/1.0/competencies/
GET
When you call /competencies endpoint GET method without any parameters you will get all the competencies in the Silverbucket's database. You can expect to get result like this:
{ "next": "null", "previous": null, "current": 1, "itemsPerPage": 500, "count": 1744, "lastPage": 4, "data": [ { "id": 1765, "created": "2020-06-09T13:24:15.214647", "modified": "2020-06-09T13:24:15.282382", "name": "Project management", "category": 17, "type": null } ], "excelUrl": "/customer-api/1.0/competencies/?excel=true", "csvUrl": "/customer-api/1.0/competencies/?csv=true" }
POST
You can add new competencies with the POST method. Message body should contain these fields:
{ "name": "<string>", "category": <competency_category_id> }
PATCH
You can modify competency's name and category with PATCH method. Add the id of competency in the endpoint URL when using PATCH:
https://<your_environment_url>/customer-api/1.0/competencies/<id>/
Add the new name and/or category id to message body.
How did we do with this article?