MetorialDocs

Skill Marketplaces

Manage skill marketplaces for an instance.

The Skill Marketplace object

skill_marketplace.json
{
  "object": "skill.marketplace",
  "id": "example_id",
  "status": "active",
  "repository_access_mode": "pull_request",
  "force_merge_or_push": false,
  "merge_before_checks_pass": false,
  "sync_status": "pending",
  "image_url": "example_image_url",
  "name": "example_name",
  "description": "example_description",
  "slug": "example_slug",
  "skill_configuration_id": "example_skill_configuration_id",
  "plugins": [
    {
      "object": "skill.marketplace_plugin",
      "status": "active",
      "skill_plugin": {
        "object": "skill.plugin",
        "status": "active",
        "sync_status": "pending",
        "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": {}
            }
          }
        ]
      }
    },
    {
      "object": "skill.marketplace_plugin",
      "status": "active",
      "skill_plugin": {
        "object": "skill.plugin",
        "status": "active",
        "sync_status": "pending",
        "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.673Z",
  "updated_at": "2026-10-17T09:50:02.673Z"
}
object"skill.marketplace"required
idstringrequired
status"active" | "archived" | "deleted"required
repository_access_mode"pull_request" | "default_branch"required
force_merge_or_pushbooleanrequired
merge_before_checks_passbooleanrequired
sync_status"pending" | "processing" | "synced"required
image_urlstringrequired
namestringrequired
descriptionstringrequirednullable
slugstringrequired
skill_configuration_idstringrequirednullable
created_atdaterequired
updated_atdaterequired

Endpoints

List skill marketplaces

GET/skill-marketplaces

Returns a paginated list of skill marketplaces.

Query parameters

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

Example request

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

Get skill marketplace

GET/skill-marketplaces/:skill_marketplace_id

Retrieves a skill marketplace.

Path parameters

skill_marketplace_idstringrequired

The unique identifier for the skill_marketplace

Example request

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

Create skill marketplace

POST/skill-marketplaces

Creates a skill marketplace.

Request body

namestringrequired
descriptionstringoptionalnullable
image_file_idstringoptionalnullable
skill_configuration_idstringoptionalnullable
repository_access_mode"pull_request" | "default_branch"optional
force_merge_or_pushbooleanoptional
merge_before_checks_passbooleanoptional

Example request

curl -X POST "https://api.metorial.com/skill-marketplaces" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_io2h4..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "image_file_id": "example_image_file_id",
  "skill_configuration_id": "example_skill_configuration_id",
  "repository_access_mode": "pull_request",
  "force_merge_or_push": false,
  "merge_before_checks_pass": false
}'

Update skill marketplace

PATCH/skill-marketplaces/:skill_marketplace_id

Updates a skill marketplace.

Path parameters

skill_marketplace_idstringrequired

The unique identifier for the skill_marketplace

Request body

namestringoptional
descriptionstringoptionalnullable
image_file_idstringoptionalnullable
skill_configuration_idstringoptionalnullable
repository_access_mode"pull_request" | "default_branch"optional
force_merge_or_pushbooleanoptional
merge_before_checks_passbooleanoptional

Example request

curl -X PATCH "https://api.metorial.com/skill-marketplaces/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_io2h4..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "image_file_id": "example_image_file_id",
  "skill_configuration_id": "example_skill_configuration_id",
  "repository_access_mode": "pull_request",
  "force_merge_or_push": false,
  "merge_before_checks_pass": false
}'

Archive skill marketplace

DELETE/skill-marketplaces/:skill_marketplace_id

Archives a skill marketplace.

Path parameters

skill_marketplace_idstringrequired

The unique identifier for the skill_marketplace

Example request

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

Sync skill marketplace

POST/skill-marketplaces/:skill_marketplace_id/sync

Forces a skill marketplace sync.

Path parameters

skill_marketplace_idstringrequired

The unique identifier for the skill_marketplace

Example request

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