A skill is an entry in Bob's company skills framework. Skills can be created in Bob’s UI or pushed via the Public API from an external taxonomy (for example, SharePoint or an LMS).

Before you begin

• Read Explore Skills API to learn how skills and proficiency levels work in Bob and how to integrate with the API.
• Decide on a stable /skill/source value for your integration and map each skill to a unique /skill/externalId in that system.
• List company proficiency levels before attaching per-skill proficiency descriptions.

What you can do

• Proficiency levels — List the company-level proficiency scale via List proficiency levels.
• Search — Page through API-origin skills with filters via Search skills.
• Create — Bulk-create skills from an external taxonomy via Create skills.
• Update — Bulk-update API-origin skills by source + externalId via Update skills.
• Archive — Bulk soft-delete API-origin skills by source + externalId via Archive skills.

Required permissions

To use the Skills API, make sure the service user or OAuth app has the following access:

If the caller lacks the required permission or scope, or its source IP is not on the company IP trust list, the API returns 403 Forbidden. To learn more, see Permissions.

Skills API endpoints

Rate limiting

Rate limits restrict how many requests you can make within a time window. To learn more, see Rate limiting.