Skill Plugins

Manage skill plugins for an instance.

Skill Plugins object

Attributes

object

String

id

String

status

Enum

sync_status

Enum

image_url

String

name

String

description

StringNullable

long_description

StringNullable

category

StringNullable

slug

String

skill_configuration_id

StringNullable

skills

Object

created_at

Date

updated_at

Date
{
  "object": "skill.plugin",
  "status": "active",
  "sync_status": "pending",
  "skills": [
    {
      "object": "skill.plugin_skill",
      "status": "active",
      "client_metadata": {}
    },
    {
      "object": "skill.plugin_skill",
      "status": "active",
      "client_metadata": {}
    }
  ]
}

List skill plugins

Returns a paginated list of skill plugins.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

id

UnionOptional

skill_marketplace_id

UnionOptional

status

UnionOptional

category

StringOptional

search

StringOptional

skill_configuration_id

UnionOptional

created_at

ObjectOptional

Filter skill plugin creation time by date range

updated_at

ObjectOptional

Filter skill plugin last update time by date range

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

Get skill plugin

Retrieves a skill plugin.

URL Parameters

skill_plugin_id

String

The unique identifier for the skill_plugin

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

Create skill plugin

Creates a skill plugin.

Request Body

name

String

description

StringOptionalNullable

long_description

StringOptionalNullable

category

StringOptionalNullable

image_file_id

StringOptionalNullable

skill_configuration_id

StringOptionalNullable
POSThttp://api.metorial.com/skill-plugins
curl -X POST "https://api.metorial.com/skill-plugins" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "long_description": "example_long_description",
  "category": "example_category",
  "image_file_id": "example_image_file_id",
  "skill_configuration_id": "example_skill_configuration_id"
}'

Update skill plugin

Updates a skill plugin.

URL Parameters

skill_plugin_id

String

The unique identifier for the skill_plugin

Request Body

name

StringOptional

description

StringOptionalNullable

long_description

StringOptionalNullable

category

StringOptionalNullable

image_file_id

StringOptionalNullable

skill_configuration_id

StringOptionalNullable
PATCHhttp://api.metorial.com/skill-plugins/:skill_plugin_id
curl -X PATCH "https://api.metorial.com/skill-plugins/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "long_description": "example_long_description",
  "category": "example_category",
  "image_file_id": "example_image_file_id",
  "skill_configuration_id": "example_skill_configuration_id"
}'

Archive skill plugin

Archives a skill plugin.

URL Parameters

skill_plugin_id

String

The unique identifier for the skill_plugin

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

Sync skill plugin

Forces a skill plugin sync.

URL Parameters

skill_plugin_id

String

The unique identifier for the skill_plugin

POSThttp://api.metorial.com/skill-plugins/:skill_plugin_id/sync
curl -X POST "https://api.metorial.com/skill-plugins/ski_Rm4Mnheq2bfEPhBhP7SY/sync" \
  -H "Authorization: Bearer metorial_sk_..."