Skip to content
Docs

Add a skill from the catalog

POST
/api/workspaces/{ws}/skills/from-catalog

Copies it into the library (or reuses the copy there) and, with hireId, turns it on for that hire.

Authorization

session
cookiebetter-auth.session_token<token>

Set by POST /api/auth/sign-in/email.

Path Parameters

ws*string

The workspace id (from GET /api/me).

Request Body

application/json
  1. body
catalogId*string
Length1 <= length <= 100
hireId?string
Length1 <= length <= 100

Response Body

{ skill, added }; 200 when the library already had it.

Example Request
curl -X POST 'https://app.useroster.work/api/workspaces/string/skills/from-catalog' \  -H 'Content-Type: application/json' \  -d '{  "catalogId": "string"}'
Example Response
Empty

Import a skill from GitHub POST

`url` is a public GitHub folder holding a `SKILL.md`.

Browse the catalog GET

Skills Roster's admins picked, A to Z. Each says `librarySkillId` when the library has it.