MetorialDocs

Skill Marketplace Plugins

Manage plugin links for skill marketplaces.

The Skill Marketplace Plugin object

skill_marketplace_plugin.json
{
  "object": "skill.marketplace_plugin",
  "id": "example_id",
  "status": "active",
  "identifier": "example_identifier",
  "skill_configuration_id": "example_skill_configuration_id",
  "skill_marketplace_id": "example_skill_marketplace_id",
  "skill_plugin": {
    "object": "skill.plugin",
    "id": "example_id",
    "status": "active",
    "sync_status": "pending",
    "image_url": "example_image_url",
    "name": "example_name",
    "description": "example_description",
    "long_description": "example_long_description",
    "category": "example_category",
    "slug": "example_slug",
    "skill_configuration_id": "example_skill_configuration_id",
    "skills": [
      {
        "object": "skill.plugin_skill",
        "status": "active",
        "client_metadata": {},
        "skill": {
          "object": "skill",
          "status": "active",
          "client_metadata": {},
          "metadata": {}
        }
      },
      {
        "object": "skill.plugin_skill",
        "status": "active",
        "client_metadata": {},
        "skill": {
          "object": "skill",
          "status": "active",
          "client_metadata": {},
          "metadata": {}
        }
      }
    ],
    "created_at": "2026-10-17T09:50:02.677Z",
    "updated_at": "2026-10-17T09:50:02.677Z"
  },
  "created_at": "2026-10-17T09:50:02.677Z",
  "updated_at": "2026-10-17T09:50:02.677Z"
}
object"skill.marketplace_plugin"required
idstringrequired
status"active" | "archived" | "deleted"required
identifierstringrequired
skill_configuration_idstringrequirednullable
skill_marketplace_idstringrequirednullable
created_atdaterequired
updated_atdaterequired

Endpoints

List skill marketplace plugins

GET/skill-marketplaces/:skill_marketplace_id/plugins

Returns plugins linked to a skill marketplace.

Path parameters

skill_marketplace_idstringrequired

The unique identifier for the skill_marketplace

Query parameters

idstring or string[]optional
skill_plugin_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-marketplaces/ski_Rm4Mnheq2bfEPhBhP7SY/plugins" \
  -H "Authorization: Bearer metorial_sk_io2h4..."

Add skill marketplace plugin

POST/skill-marketplaces/:skill_marketplace_id/plugins

Adds a skill plugin to a skill marketplace.

Path parameters

skill_marketplace_idstringrequired

The unique identifier for the skill_marketplace

Request body

skill_plugin_idstringrequired
skill_configuration_idstringoptionalnullable
identifierstringoptional

Example request

curl -X POST "https://api.metorial.com/skill-marketplaces/ski_Rm4Mnheq2bfEPhBhP7SY/plugins" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_io2h4..." \
  -d '{
  "skill_plugin_id": "example_skill_plugin_id",
  "skill_configuration_id": "example_skill_configuration_id",
  "identifier": "example_identifier"
}'

Get skill marketplace plugin

GET/skill-marketplaces/:skill_marketplace_id/plugins/:skill_marketplace_plugin_id

Retrieves a skill marketplace plugin link.

Path parameters

skill_marketplace_idstringrequired

The unique identifier for the skill_marketplace

skill_marketplace_plugin_idstringrequired

The unique identifier for the skill_marketplace_plugin

Example request

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

Remove skill marketplace plugin

DELETE/skill-marketplaces/:skill_marketplace_id/plugins/:skill_marketplace_plugin_id

Removes a skill plugin from a skill marketplace.

Path parameters

skill_marketplace_idstringrequired

The unique identifier for the skill_marketplace

skill_marketplace_plugin_idstringrequired

The unique identifier for the skill_marketplace_plugin

Example request

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