MetorialDocs

Skill Plugin Skills

Manage skill links for skill plugins.

The Skill Plugin Skill object

skill_plugin_skill.json
{
  "object": "skill.plugin_skill",
  "id": "example_id",
  "identifier": "example_identifier",
  "status": "active",
  "client_name": "example_client_name",
  "client_description": "example_client_description",
  "client_metadata": {},
  "license": "example_license",
  "compatibility": "example_compatibility",
  "skill_configuration_id": "example_skill_configuration_id",
  "skill_id": "example_skill_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.681Z",
    "updated_at": "2026-10-17T09:50:02.681Z"
  },
  "created_at": "2026-10-17T09:50:02.681Z",
  "updated_at": "2026-10-17T09:50:02.681Z"
}
object"skill.plugin_skill"required
idstringrequired
identifierstringrequired
status"active" | "archived" | "deleted"required
client_namestringrequirednullable
client_descriptionstringrequirednullable
client_metadataRecord<string, any>requirednullable
licensestringrequirednullable
compatibilitystringrequirednullable
skill_configuration_idstringrequirednullable
skill_idstringrequired
created_atdaterequired
updated_atdaterequired

Endpoints

List skill plugin skills

GET/skill-plugins/:skill_plugin_id/skills

Returns skills linked to a skill plugin.

Path parameters

skill_plugin_idstringrequired

The unique identifier for the skill_plugin

Query parameters

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

Example request

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

Add skill plugin skill

POST/skill-plugins/:skill_plugin_id/skills

Adds a skill to a skill plugin.

Path parameters

skill_plugin_idstringrequired

The unique identifier for the skill_plugin

Request body

skill_idstringrequired
identifierstringoptional
client_namestringoptionalnullable
client_descriptionstringoptionalnullable
client_metadataRecord<string, any>optionalnullable
licensestringoptionalnullable
compatibilitystringoptionalnullable
skill_configuration_idstringoptionalnullable

Example request

curl -X POST "https://api.metorial.com/skill-plugins/ski_Rm4Mnheq2bfEPhBhP7SY/skills" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_io2h4..." \
  -d '{
  "skill_id": "example_skill_id",
  "identifier": "example_identifier",
  "client_name": "example_client_name",
  "client_description": "example_client_description",
  "client_metadata": {},
  "license": "example_license",
  "compatibility": "example_compatibility",
  "skill_configuration_id": "example_skill_configuration_id"
}'

Get skill plugin skill

GET/skill-plugins/:skill_plugin_id/skills/:skill_plugin_skill_id

Retrieves a skill plugin skill link.

Path parameters

skill_plugin_idstringrequired

The unique identifier for the skill_plugin

skill_plugin_skill_idstringrequired

The unique identifier for the skill_plugin_skill

Example request

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

Update skill plugin skill

PATCH/skill-plugins/:skill_plugin_id/skills/:skill_plugin_skill_id

Updates a skill plugin skill link.

Path parameters

skill_plugin_idstringrequired

The unique identifier for the skill_plugin

skill_plugin_skill_idstringrequired

The unique identifier for the skill_plugin_skill

Request body

client_namestringoptionalnullable
client_descriptionstringoptionalnullable
client_metadataRecord<string, any>optionalnullable
licensestringoptionalnullable
compatibilitystringoptionalnullable
skill_configuration_idstringoptionalnullable

Example request

curl -X PATCH "https://api.metorial.com/skill-plugins/ski_Rm4Mnheq2bfEPhBhP7SY/skills/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_io2h4..." \
  -d '{
  "client_name": "example_client_name",
  "client_description": "example_client_description",
  "client_metadata": {},
  "license": "example_license",
  "compatibility": "example_compatibility",
  "skill_configuration_id": "example_skill_configuration_id"
}'

Remove skill plugin skill

DELETE/skill-plugins/:skill_plugin_id/skills/:skill_plugin_skill_id

Removes a skill from a skill plugin.

Path parameters

skill_plugin_idstringrequired

The unique identifier for the skill_plugin

skill_plugin_skill_idstringrequired

The unique identifier for the skill_plugin_skill

Example request

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