API by router
Marketplace
PUT
HTTPBearerheader
AuthorizationBearer <token>publisher_id*Publisher IdFormat
uuidSuccessful Response
application/json- response
created_at*Created AtFormat
date-timedescription?string|nullid*IdFormat
uuidlogo_url?string|nullname*Nameslug*Slugstatus*Statusverified_at?|nullwebsite_url?string|nullcurl -X PUT 'https://example.com/v1/marketplace/admin/publishers/497f6eca-6276-4993-bfeb-53cbbbba6f08/approve'Example Response
{ "created_at": "2019-08-24T14:15:22Z", "description": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "logo_url": "string", "name": "string", "slug": "string", "status": "string", "verified_at": "2019-08-24T14:15:22Z", "website_url": "string"}PUT
HTTPBearerheader
AuthorizationBearer <token>skill_id*Skill IdFormat
uuidSuccessful Response
application/json- response
avg_rating?number|nullbilling_type*Billing Typecategory*Categorycreated_at*Created AtFormat
date-timecurrent_version?|nulldescription?string|nullemoji*Emojifeatured*Featuredhaldir_verified?Haldir VerifiedDefault
falseicon_url?string|nullid*IdFormat
uuidinstall_count*Install Countitem_type?Item TypeDefault
"skill"long_description?string|nullmcp_config?|nullmin_tier?string|nullname*Nameprice_cents*Price Centspublisher_id*Publisher IdFormat
uuidpublisher_name?string|nullpublisher_slug?string|nullscreenshots?array<string>slug*Slugsource_type*Source Typestatus*Statustags?array<string>updated_at*Updated AtFormat
date-timecurl -X PUT 'https://example.com/v1/marketplace/admin/skills/497f6eca-6276-4993-bfeb-53cbbbba6f08/approve'Example Response
{ "avg_rating": 0, "billing_type": "string", "category": "string", "created_at": "2019-08-24T14:15:22Z", "current_version": { "changelog": "string", "created_at": "2019-08-24T14:15:22Z", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "published_at": "2019-08-24T14:15:22Z", "status": "string", "version": "string" }, "description": "string", "emoji": "string", "featured": true, "haldir_verified": false, "icon_url": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "install_count": 0, "item_type": "skill", "long_description": "string", "mcp_config": {}, "min_tier": "string", "name": "string", "price_cents": 0, "publisher_id": "83ed281e-4f5b-486d-b81f-73c966460c55", "publisher_name": "string", "publisher_slug": "string", "screenshots": [ "string" ], "slug": "string", "source_type": "string", "status": "string", "tags": [ "string" ], "updated_at": "2019-08-24T14:15:22Z"}PUT
HTTPBearerheader
AuthorizationBearer <token>skill_id*Skill IdFormat
uuidreason?ReasonRejection reason
Default
""Successful Response
response?unknownapplication/jsoncurl -X PUT 'https://example.com/v1/marketplace/admin/skills/497f6eca-6276-4993-bfeb-53cbbbba6f08/reject'Example Response
nullcurl -X GET 'https://example.com/v1/marketplace/categories'Example Response200
[ {}]GET
HTTPBearerheader
AuthorizationBearer <token>instance_id*Instance IdFormat
uuidX-Api-Key?string|nullSuccessful Response
application/json- response
[index: integer]?curl -X GET 'https://example.com/v1/marketplace/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/skills'Example Response
[ { "expires_at": "2019-08-24T14:15:22Z", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "installed_at": "2019-08-24T14:15:22Z", "instance_id": "06587974-2dbe-4e10-8bf9-38cce0f5a366", "skill_emoji": "string", "skill_id": "3cd68bb3-8b7e-48be-8232-1b99b5b4b3aa", "skill_name": "string", "skill_slug": "string", "status": "string", "version": "string" }]POST
HTTPBearerheader
AuthorizationBearer <token>instance_id*Instance IdFormat
uuidX-Api-Key?string|nullapplication/json- body
skill_id*Skill IdFormat
uuidversion_id?|nullSuccessful Response
application/json- response
expires_at?|nullid*IdFormat
uuidinstalled_at*Installed AtFormat
date-timeinstance_id*Instance IdFormat
uuidskill_emoji?string|nullskill_id*Skill IdFormat
uuidskill_name?string|nullskill_slug?string|nullstatus*Statusversion?string|nullcurl -X POST 'https://example.com/v1/marketplace/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/skills/install' \ -H 'Content-Type: application/json' \ -d '{ "skill_id": "3cd68bb3-8b7e-48be-8232-1b99b5b4b3aa"}'Example Response
{ "expires_at": "2019-08-24T14:15:22Z", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "installed_at": "2019-08-24T14:15:22Z", "instance_id": "06587974-2dbe-4e10-8bf9-38cce0f5a366", "skill_emoji": "string", "skill_id": "3cd68bb3-8b7e-48be-8232-1b99b5b4b3aa", "skill_name": "string", "skill_slug": "string", "status": "string", "version": "string"}DELETE
HTTPBearerheader
AuthorizationBearer <token>instance_id*Instance IdFormat
uuidskill_id*Skill IdFormat
uuidX-Api-Key?string|nullSuccessful Response
curl -X DELETE 'https://example.com/v1/marketplace/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/skills/497f6eca-6276-4993-bfeb-53cbbbba6f08'Example Response
Empty
POST
HTTPBearerheader
AuthorizationBearer <token>X-Api-Key?string|nullapplication/json- body
description?string|nullname*NameLength
1 <= length <= 200slug*SlugLength
3 <= length <= 80website_url?|nullSuccessful Response
application/json- response
created_at*Created AtFormat
date-timedescription?string|nullid*IdFormat
uuidlogo_url?string|nullname*Nameslug*Slugstatus*Statusverified_at?|nullwebsite_url?string|nullcurl -X POST 'https://example.com/v1/marketplace/publishers' \ -H 'Content-Type: application/json' \ -d '{ "name": "string", "slug": "string"}'Example Response
{ "created_at": "2019-08-24T14:15:22Z", "description": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "logo_url": "string", "name": "string", "slug": "string", "status": "string", "verified_at": "2019-08-24T14:15:22Z", "website_url": "string"}GET
HTTPBearerheader
AuthorizationBearer <token>X-Api-Key?string|nullSuccessful Response
application/json- response
created_at*Created AtFormat
date-timedescription?string|nullid*IdFormat
uuidlogo_url?string|nullname*Nameslug*Slugstatus*Statusverified_at?|nullwebsite_url?string|nullcurl -X GET 'https://example.com/v1/marketplace/publishers/me'Example Response
{ "created_at": "2019-08-24T14:15:22Z", "description": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "logo_url": "string", "name": "string", "slug": "string", "status": "string", "verified_at": "2019-08-24T14:15:22Z", "website_url": "string"}PUT
HTTPBearerheader
AuthorizationBearer <token>X-Api-Key?string|nullapplication/json- body
description?string|nulllogo_url?|nullname?|nullwebsite_url?|nullSuccessful Response
application/json- response
created_at*Created AtFormat
date-timedescription?string|nullid*IdFormat
uuidlogo_url?string|nullname*Nameslug*Slugstatus*Statusverified_at?|nullwebsite_url?string|nullcurl -X PUT 'https://example.com/v1/marketplace/publishers/me' \ -H 'Content-Type: application/json' \ -d '{}'Example Response
{ "created_at": "2019-08-24T14:15:22Z", "description": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "logo_url": "string", "name": "string", "slug": "string", "status": "string", "verified_at": "2019-08-24T14:15:22Z", "website_url": "string"}GET
slug*SlugSuccessful Response
application/json- response
created_at*Created AtFormat
date-timedescription?string|nullid*IdFormat
uuidlogo_url?string|nullname*Nameslug*Slugstatus*Statusverified_at?|nullwebsite_url?string|nullcurl -X GET 'https://example.com/v1/marketplace/publishers/string'Example Response
{ "created_at": "2019-08-24T14:15:22Z", "description": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "logo_url": "string", "name": "string", "slug": "string", "status": "string", "verified_at": "2019-08-24T14:15:22Z", "website_url": "string"}GET
HTTPBearerheader
AuthorizationBearer <token>X-Api-Key?string|nullSuccessful Response
application/json- response
[index: integer]?curl -X GET 'https://example.com/v1/marketplace/reseller/pricing'Example Response
[ { "created_at": "2019-08-24T14:15:22Z", "enabled": true, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "markup_cents": 0, "markup_percent": 0, "skill_id": "3cd68bb3-8b7e-48be-8232-1b99b5b4b3aa", "skill_name": "string" }]PUT
HTTPBearerheader
AuthorizationBearer <token>X-Api-Key?string|nullapplication/json- body
enabled?EnabledDefault
truemarkup_cents?Markup CentsRange
0 <= valueDefault
0markup_percent?|nullskill_id*Skill IdFormat
uuidSuccessful Response
application/json- response
created_at*Created AtFormat
date-timeenabled*Enabledid*IdFormat
uuidmarkup_cents*Markup Centsmarkup_percent?number|nullskill_id*Skill IdFormat
uuidskill_name?string|nullcurl -X PUT 'https://example.com/v1/marketplace/reseller/pricing' \ -H 'Content-Type: application/json' \ -d '{ "skill_id": "3cd68bb3-8b7e-48be-8232-1b99b5b4b3aa"}'Example Response
{ "created_at": "2019-08-24T14:15:22Z", "enabled": true, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "markup_cents": 0, "markup_percent": 0, "skill_id": "3cd68bb3-8b7e-48be-8232-1b99b5b4b3aa", "skill_name": "string"}DELETE
HTTPBearerheader
AuthorizationBearer <token>skill_id*Skill IdFormat
uuidX-Api-Key?string|nullSuccessful Response
curl -X DELETE 'https://example.com/v1/marketplace/reseller/pricing/497f6eca-6276-4993-bfeb-53cbbbba6f08'Example Response
Empty
GET
category?|Filter by category
item_type?|Filter: skill, mcp_server
search?|Search name/description/tags
billing_type?|Filter: free, one_time, monthly, yearly
featured?|Filter featured only
sort?SortSort: popular, newest, price_asc, price_desc
Default
"popular"limit?LimitRange
1 <= value <= 100Default
50offset?OffsetRange
0 <= valueDefault
0Successful Response
application/json- response
[index: integer]?curl -X GET 'https://example.com/v1/marketplace/skills'Example Response
[ { "avg_rating": 0, "billing_type": "string", "category": "string", "created_at": "2019-08-24T14:15:22Z", "current_version": { "changelog": "string", "created_at": "2019-08-24T14:15:22Z", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "published_at": "2019-08-24T14:15:22Z", "status": "string", "version": "string" }, "description": "string", "emoji": "string", "featured": true, "haldir_verified": false, "icon_url": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "install_count": 0, "item_type": "skill", "long_description": "string", "mcp_config": {}, "min_tier": "string", "name": "string", "price_cents": 0, "publisher_id": "83ed281e-4f5b-486d-b81f-73c966460c55", "publisher_name": "string", "publisher_slug": "string", "screenshots": [ "string" ], "slug": "string", "source_type": "string", "status": "string", "tags": [ "string" ], "updated_at": "2019-08-24T14:15:22Z" }]GET
HTTPBearerheader
AuthorizationBearer <token>X-Api-Key?string|nullSuccessful Response
application/json- response
[index: integer]?curl -X GET 'https://example.com/v1/marketplace/skills/mine'Example Response
[ { "avg_rating": 0, "billing_type": "string", "category": "string", "created_at": "2019-08-24T14:15:22Z", "current_version": { "changelog": "string", "created_at": "2019-08-24T14:15:22Z", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "published_at": "2019-08-24T14:15:22Z", "status": "string", "version": "string" }, "description": "string", "emoji": "string", "featured": true, "haldir_verified": false, "icon_url": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "install_count": 0, "item_type": "skill", "long_description": "string", "mcp_config": {}, "min_tier": "string", "name": "string", "price_cents": 0, "publisher_id": "83ed281e-4f5b-486d-b81f-73c966460c55", "publisher_name": "string", "publisher_slug": "string", "screenshots": [ "string" ], "slug": "string", "source_type": "string", "status": "string", "tags": [ "string" ], "updated_at": "2019-08-24T14:15:22Z" }]POST
HTTPBearerheader
AuthorizationBearer <token>X-Api-Key?string|nullapplication/json- body
billing_type?Billing TypeDefault
"free"bundle_hash?|Pre-computed composite SHA-256 for non-builtin skills. Builtin skills are hashed automatically from disk.
category?CategoryLength
length <= 50Default
"general"changelog?string|nulldescription?string|nullemoji?EmojiLength
length <= 10Default
"🔧"long_description?string|nullmin_tier?string|nullname*NameLength
1 <= length <= 200price_cents?Price CentsRange
0 <= valueDefault
0slug*SlugLength
3 <= length <= 100source_ref?string|nullsource_type?Source TypeDefault
"uploaded"tags?array<string>version?VersionLength
length <= 30Default
"1.0.0"Successful Response
application/json- response
avg_rating?number|nullbilling_type*Billing Typecategory*Categorycreated_at*Created AtFormat
date-timecurrent_version?|nulldescription?string|nullemoji*Emojifeatured*Featuredhaldir_verified?Haldir VerifiedDefault
falseicon_url?string|nullid*IdFormat
uuidinstall_count*Install Countitem_type?Item TypeDefault
"skill"long_description?string|nullmcp_config?|nullmin_tier?string|nullname*Nameprice_cents*Price Centspublisher_id*Publisher IdFormat
uuidpublisher_name?string|nullpublisher_slug?string|nullscreenshots?array<string>slug*Slugsource_type*Source Typestatus*Statustags?array<string>updated_at*Updated AtFormat
date-timecurl -X POST 'https://example.com/v1/marketplace/skills/submit' \ -H 'Content-Type: application/json' \ -d '{ "name": "string", "slug": "string"}'Example Response
{ "avg_rating": 0, "billing_type": "string", "category": "string", "created_at": "2019-08-24T14:15:22Z", "current_version": { "changelog": "string", "created_at": "2019-08-24T14:15:22Z", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "published_at": "2019-08-24T14:15:22Z", "status": "string", "version": "string" }, "description": "string", "emoji": "string", "featured": true, "haldir_verified": false, "icon_url": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "install_count": 0, "item_type": "skill", "long_description": "string", "mcp_config": {}, "min_tier": "string", "name": "string", "price_cents": 0, "publisher_id": "83ed281e-4f5b-486d-b81f-73c966460c55", "publisher_name": "string", "publisher_slug": "string", "screenshots": [ "string" ], "slug": "string", "source_type": "string", "status": "string", "tags": [ "string" ], "updated_at": "2019-08-24T14:15:22Z"}GET
skill_id*Skill IdFormat
uuidSuccessful Response
application/json- response
avg_rating?number|nullbilling_type*Billing Typecategory*Categorycreated_at*Created AtFormat
date-timecurrent_version?|nulldescription?string|nullemoji*Emojifeatured*Featuredhaldir_verified?Haldir VerifiedDefault
falseicon_url?string|nullid*IdFormat
uuidinstall_count*Install Countitem_type?Item TypeDefault
"skill"long_description?string|nullmcp_config?|nullmin_tier?string|nullname*Nameprice_cents*Price Centspublisher_id*Publisher IdFormat
uuidpublisher_name?string|nullpublisher_slug?string|nullscreenshots?array<string>slug*Slugsource_type*Source Typestatus*Statustags?array<string>updated_at*Updated AtFormat
date-timecurl -X GET 'https://example.com/v1/marketplace/skills/497f6eca-6276-4993-bfeb-53cbbbba6f08'Example Response
{ "avg_rating": 0, "billing_type": "string", "category": "string", "created_at": "2019-08-24T14:15:22Z", "current_version": { "changelog": "string", "created_at": "2019-08-24T14:15:22Z", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "published_at": "2019-08-24T14:15:22Z", "status": "string", "version": "string" }, "description": "string", "emoji": "string", "featured": true, "haldir_verified": false, "icon_url": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "install_count": 0, "item_type": "skill", "long_description": "string", "mcp_config": {}, "min_tier": "string", "name": "string", "price_cents": 0, "publisher_id": "83ed281e-4f5b-486d-b81f-73c966460c55", "publisher_name": "string", "publisher_slug": "string", "screenshots": [ "string" ], "slug": "string", "source_type": "string", "status": "string", "tags": [ "string" ], "updated_at": "2019-08-24T14:15:22Z"}PUT
HTTPBearerheader
AuthorizationBearer <token>skill_id*Skill IdFormat
uuidX-Api-Key?string|nullapplication/json- body
billing_type?string|nullcategory?|nulldescription?string|nullemoji?|nulllong_description?string|nullmin_tier?string|nullname?|nullprice_cents?|nulltags?array<string>|nullSuccessful Response
application/json- response
avg_rating?number|nullbilling_type*Billing Typecategory*Categorycreated_at*Created AtFormat
date-timecurrent_version?|nulldescription?string|nullemoji*Emojifeatured*Featuredhaldir_verified?Haldir VerifiedDefault
falseicon_url?string|nullid*IdFormat
uuidinstall_count*Install Countitem_type?Item TypeDefault
"skill"long_description?string|nullmcp_config?|nullmin_tier?string|nullname*Nameprice_cents*Price Centspublisher_id*Publisher IdFormat
uuidpublisher_name?string|nullpublisher_slug?string|nullscreenshots?array<string>slug*Slugsource_type*Source Typestatus*Statustags?array<string>updated_at*Updated AtFormat
date-timecurl -X PUT 'https://example.com/v1/marketplace/skills/497f6eca-6276-4993-bfeb-53cbbbba6f08' \ -H 'Content-Type: application/json' \ -d '{}'Example Response
{ "avg_rating": 0, "billing_type": "string", "category": "string", "created_at": "2019-08-24T14:15:22Z", "current_version": { "changelog": "string", "created_at": "2019-08-24T14:15:22Z", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "published_at": "2019-08-24T14:15:22Z", "status": "string", "version": "string" }, "description": "string", "emoji": "string", "featured": true, "haldir_verified": false, "icon_url": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "install_count": 0, "item_type": "skill", "long_description": "string", "mcp_config": {}, "min_tier": "string", "name": "string", "price_cents": 0, "publisher_id": "83ed281e-4f5b-486d-b81f-73c966460c55", "publisher_name": "string", "publisher_slug": "string", "screenshots": [ "string" ], "slug": "string", "source_type": "string", "status": "string", "tags": [ "string" ], "updated_at": "2019-08-24T14:15:22Z"}GET
skill_id*Skill IdFormat
uuidSuccessful Response
application/json- response
[index: integer]?curl -X GET 'https://example.com/v1/marketplace/skills/497f6eca-6276-4993-bfeb-53cbbbba6f08/versions'Example Response
[ { "changelog": "string", "created_at": "2019-08-24T14:15:22Z", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "published_at": "2019-08-24T14:15:22Z", "status": "string", "version": "string" }]POST
HTTPBearerheader
AuthorizationBearer <token>skill_id*Skill IdFormat
uuidversion*VersionLength
1 <= length <= 30changelog?string|nullbundle_hash?|Pre-computed composite SHA-256 for non-builtin skills.
X-Api-Key?string|nullSuccessful Response
application/json- response
changelog?string|nullcreated_at*Created AtFormat
date-timeid*IdFormat
uuidpublished_at?|nullstatus*Statusversion*Versioncurl -X POST 'https://example.com/v1/marketplace/skills/497f6eca-6276-4993-bfeb-53cbbbba6f08/versions?version=string'Example Response
{ "changelog": "string", "created_at": "2019-08-24T14:15:22Z", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "published_at": "2019-08-24T14:15:22Z", "status": "string", "version": "string"}