MetorialDocs

Skill Group Items

Skill group items link groups to skills.

The Skill Group Item object

skill_group_item.json
{
  "object": "skill.group.item",
  "id": "example_id",
  "status": "active",
  "skill_group_id": "example_skill_group_id",
  "skill": {
    "object": "skill",
    "id": "example_id",
    "status": "active",
    "slug": "example_slug",
    "name": "example_name",
    "description": "example_description",
    "image_url": "example_image_url",
    "client_name": "example_client_name",
    "client_description": "example_client_description",
    "client_metadata": {},
    "license": "example_license",
    "compatibility": "example_compatibility",
    "metadata": {},
    "created_at": "2026-10-17T09:50:02.667Z",
    "updated_at": "2026-10-17T09:50:02.667Z"
  },
  "created_at": "2026-10-17T09:50:02.667Z"
}
object"skill.group.item"required
idstringrequired
status"active" | "archived" | "deleted"required
skill_group_idstringrequired
created_atdaterequired

Endpoints

List skill group items

GET/skill-groups/:skill_group_id/items

Returns a paginated list of items for a skill group.

Path parameters

skill_group_idstringrequired

The unique identifier for the skill_group

Query parameters

status"active" | "archived" | "deleted" or "active" | "archived" | "deleted"[]optional
idstring or string[]optional
skill_idstring or string[]optional

Example request

curl -X GET "https://api.metorial.com/skill-groups/ski_Rm4Mnheq2bfEPhBhP7SY/items" \
  -H "Authorization: Bearer metorial_sk_io2h4..."

Get skill group item

GET/skill-groups/:skill_group_id/items/:skill_group_item_id

Retrieves a specific skill group item.

Path parameters

skill_group_idstringrequired

The unique identifier for the skill_group

skill_group_item_idstringrequired

The unique identifier for the skill_group_item

Example request

curl -X GET "https://api.metorial.com/skill-groups/ski_Rm4Mnheq2bfEPhBhP7SY/items/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_io2h4..."

Create skill group item

POST/skill-groups/:skill_group_id/items

Adds a skill to a skill group.

Path parameters

skill_group_idstringrequired

The unique identifier for the skill_group

Request body

skill_idstringrequired

Example request

curl -X POST "https://api.metorial.com/skill-groups/ski_Rm4Mnheq2bfEPhBhP7SY/items" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_io2h4..." \
  -d '{
  "skill_id": "example_skill_id"
}'

Delete skill group item

DELETE/skill-groups/:skill_group_id/items/:skill_group_item_id

Archives a skill group item.

Path parameters

skill_group_idstringrequired

The unique identifier for the skill_group

skill_group_item_idstringrequired

The unique identifier for the skill_group_item

Example request

curl -X DELETE "https://api.metorial.com/skill-groups/ski_Rm4Mnheq2bfEPhBhP7SY/items/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_io2h4..."