Skill Group Items

Skill group items link groups to skills.

Skill Group Items object

Attributes

object

String

id

String

status

Enum

skill_group_id

String

skill

Object

created_at

Date
{
  "object": "skill.group.item",
  "status": "active",
  "skill": {
    "object": "skill",
    "status": "active",
    "client_metadata": {},
    "metadata": {}
  }
}

List skill group items

Returns a paginated list of items for a skill group.

URL Parameters

skill_group_id

String

The unique identifier for the skill_group

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

status

UnionOptional

id

UnionOptional

skill_id

UnionOptional

created_at

ObjectOptional

Filter skill group item creation time by date range

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

Get skill group item

Retrieves a specific skill group item.

URL Parameters

skill_group_id

String

The unique identifier for the skill_group

skill_group_item_id

String

The unique identifier for the skill_group_item

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

Create skill group item

Adds a skill to a skill group.

URL Parameters

skill_group_id

String

The unique identifier for the skill_group

Request Body

skill_id

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

Delete skill group item

Archives a skill group item.

URL Parameters

skill_group_id

String

The unique identifier for the skill_group

skill_group_item_id

String

The unique identifier for the skill_group_item

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