Skill Groups

Skill groups organize skills into reusable collections.

Skill Groups object

Attributes

object

String

id

String

status

Enum

name

String

description

StringNullable

metadata

ObjectNullable

A key-value map

skills

Object

created_at

Date

updated_at

Date
{
  "object": "skill.group",
  "status": "active",
  "metadata": {},
  "skills": [
    {
      "object": "skill",
      "status": "active",
      "client_metadata": {},
      "metadata": {}
    },
    {
      "object": "skill",
      "status": "active",
      "client_metadata": {},
      "metadata": {}
    }
  ]
}

List skill groups

Returns a paginated list of skill groups.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

search

StringOptional

status

UnionOptional

id

UnionOptional

skill_id

UnionOptional

created_at

ObjectOptional

Filter skill group creation time by date range

updated_at

ObjectOptional

Filter skill group last update time by date range

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

Get skill group

Retrieves a specific skill group.

URL Parameters

skill_group_id

String

The unique identifier for the skill_group

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

Create skill group

Creates a skill group.

Request Body

name

String

description

StringOptional

metadata

ObjectOptional

A key-value map

skill_ids

Array of StringsOptional
POSThttp://api.metorial.com/skill-groups
curl -X POST "https://api.metorial.com/skill-groups" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "skill_ids": [
    "example_item"
  ]
}'

Update skill group

Updates a skill group.

URL Parameters

skill_group_id

String

The unique identifier for the skill_group

Request Body

name

StringOptional

description

StringOptionalNullable

metadata

ObjectOptionalNullable

A key-value map

skill_ids

Array of StringsOptional
PATCHhttp://api.metorial.com/skill-groups/:skill_group_id
curl -X PATCH "https://api.metorial.com/skill-groups/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "skill_ids": [
    "example_item"
  ]
}'

Delete skill group

Archives a skill group.

URL Parameters

skill_group_id

String

The unique identifier for the skill_group

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