Skill Marketplaces

Manage skill marketplaces for an instance.

Skill Marketplaces object

Attributes

object

String

id

String

status

Enum

sync_status

Enum

image_url

String

name

String

description

StringNullable

slug

String

skill_configuration_id

StringNullable

plugins

Object

created_at

Date

updated_at

Date
{
  "object": "skill.marketplace",
  "status": "active",
  "sync_status": "pending",
  "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": {}
          },
          {
            "object": "skill.plugin_skill",
            "status": "active",
            "client_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": {}
          },
          {
            "object": "skill.plugin_skill",
            "status": "active",
            "client_metadata": {}
          }
        ]
      }
    }
  ]
}

List skill marketplaces

Returns a paginated list of skill marketplaces.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

id

UnionOptional

status

UnionOptional

skill_configuration_id

UnionOptional

search

StringOptional

created_at

ObjectOptional

Filter skill marketplace creation time by date range

updated_at

ObjectOptional

Filter skill marketplace last update time by date range

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

Get skill marketplace

Retrieves a skill marketplace.

URL Parameters

skill_marketplace_id

String

The unique identifier for the skill_marketplace

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

Create skill marketplace

Creates a skill marketplace.

Request Body

name

String

description

StringOptionalNullable

image_file_id

StringOptionalNullable

skill_configuration_id

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

Update skill marketplace

Updates a skill marketplace.

URL Parameters

skill_marketplace_id

String

The unique identifier for the skill_marketplace

Request Body

name

StringOptional

description

StringOptionalNullable

image_file_id

StringOptionalNullable

skill_configuration_id

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

Archive skill marketplace

Archives a skill marketplace.

URL Parameters

skill_marketplace_id

String

The unique identifier for the skill_marketplace

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

Sync skill marketplace

Forces a skill marketplace sync.

URL Parameters

skill_marketplace_id

String

The unique identifier for the skill_marketplace

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