Marketplace
Approve Publisher
Approve a publisher application (admin only).
"You shall not pass!" — Gandalf (unless you're approved)
In: header
Path Parameters
uuidResponse Body
curl -X PUT "https://loading/v1/marketplace/admin/publishers/497f6eca-6276-4993-bfeb-53cbbbba6f08/approve"{
"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"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Approve Skill
Approve a submitted skill (admin only).
"I'm the captain now." — Muse, Captain Phillips (about marketplace moderation)
In: header
Path Parameters
uuidResponse Body
curl -X PUT "https://loading/v1/marketplace/admin/skills/497f6eca-6276-4993-bfeb-53cbbbba6f08/approve"{
"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"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Reject Skill
Reject a submitted skill (admin only).
In: header
Path Parameters
uuidQuery Parameters
Rejection reason
""Response Body
curl -X PUT "https://loading/v1/marketplace/admin/skills/497f6eca-6276-4993-bfeb-53cbbbba6f08/reject?reason="null{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}List Categories
List all skill categories with counts.
"There's no place like home." — Dorothy, Wizard of Oz (about category filtering)
Response Body
curl -X GET "https://loading/v1/marketplace/categories"[
{}
]List Instance Skills
List skills installed on an instance.
In: header
Path Parameters
uuidHeader Parameters
Response Body
curl -X GET "https://loading/v1/marketplace/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/skills" \ -H "X-Api-Key: string"[
{
"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"
}
]{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Install Skill
One-click install a marketplace skill on an instance.
"Get to the chopper!" — Dutch, Predator (about installing skills quickly)
In: header
Path Parameters
uuidHeader Parameters
uuidResponse Body
curl -X POST "https://loading/v1/marketplace/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/skills/install" \ -H "X-Api-Key: string" \ -H "Content-Type: application/json" \ -d '{ "skill_id": "3cd68bb3-8b7e-48be-8232-1b99b5b4b3aa" }'{
"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"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Uninstall Skill
Remove a marketplace skill from an instance.
"Hasta la vista, baby." — T-800, Terminator 2 (about skill removal)
In: header
Path Parameters
uuiduuidHeader Parameters
Response Body
curl -X DELETE "https://loading/v1/marketplace/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/skills/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "X-Api-Key: string"{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Create Publisher
Register as a marketplace publisher.
"Listen very carefully, I shall say this only once." — Michelle, 'Allo 'Allo! (about publisher registration)
In: header
Header Parameters
1 <= length <= 2003 <= length <= 80Response Body
curl -X POST "https://loading/v1/marketplace/publishers" \ -H "X-Api-Key: string" \ -H "Content-Type: application/json" \ -d '{ "name": "string", "slug": "string" }'{
"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"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Get My Publisher
Get the current user's publisher profile (if any).
In: header
Header Parameters
Response Body
curl -X GET "https://loading/v1/marketplace/publishers/me" \ -H "X-Api-Key: string"{
"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"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Update My Publisher
Update publisher profile.
In: header
Header Parameters
Response Body
curl -X PUT "https://loading/v1/marketplace/publishers/me" \ -H "X-Api-Key: string" \ -H "Content-Type: application/json" \ -d '{}'{
"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"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Get Publisher
Get a public publisher profile by slug.
"You talking to me?" — Travis Bickle, Taxi Driver (about publisher slugs)
Path Parameters
Response Body
curl -X GET "https://loading/v1/marketplace/publishers/string"{
"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"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}List Reseller Pricing
List reseller pricing overrides for the current tenant.
"Show me the money!" — Jerry Maguire
In: header
Header Parameters
Response Body
curl -X GET "https://loading/v1/marketplace/reseller/pricing" \ -H "X-Api-Key: string"[
{
"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"
}
]{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Set Reseller Pricing
Set reseller markup for a specific skill.
"Greed, for lack of a better word, is good." — Gordon Gekko, Wall Street (about markup configuration)
In: header
Header Parameters
true00 <= valueuuidResponse Body
curl -X PUT "https://loading/v1/marketplace/reseller/pricing" \ -H "X-Api-Key: string" \ -H "Content-Type: application/json" \ -d '{ "skill_id": "3cd68bb3-8b7e-48be-8232-1b99b5b4b3aa" }'{
"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"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Delete Reseller Pricing
Remove reseller pricing override, reverting to publisher's price.
In: header
Path Parameters
uuidHeader Parameters
Response Body
curl -X DELETE "https://loading/v1/marketplace/reseller/pricing/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "X-Api-Key: string"{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Discover Skills
Browse approved marketplace skills.
"I see dead skills." — Cole Sear, The Sixth Sense (about deprecated ones)
Query Parameters
Filter by category
Filter: skill, mcp_server
Search name/description/tags
Filter: free, one_time, monthly, yearly
Filter featured only
Sort: popular, newest, price_asc, price_desc
"popular"501 <= value <= 10000 <= valueResponse Body
curl -X GET "https://loading/v1/marketplace/skills?category=string&item_type=string&search=string&billing_type=string&featured=true&sort=popular&limit=50&offset=0"[
{
"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"
}
]{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}List My Skills
List skills belonging to the current publisher.
In: header
Header Parameters
Response Body
curl -X GET "https://loading/v1/marketplace/skills/mine" \ -H "X-Api-Key: string"[
{
"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"
}
]{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Submit Skill
Submit a new skill to the marketplace.
"If you build it, they will come." — Shoeless Joe, Field of Dreams
In: header
Header Parameters
"free"Pre-computed composite SHA-256 for non-builtin skills. Builtin skills are hashed automatically from disk.
"general"length <= 50"🔧"length <= 101 <= length <= 20000 <= value3 <= length <= 100"uploaded""1.0.0"length <= 30Response Body
curl -X POST "https://loading/v1/marketplace/skills/submit" \ -H "X-Api-Key: string" \ -H "Content-Type: application/json" \ -d '{ "name": "string", "slug": "string" }'{
"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"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Get Skill
Get a single marketplace skill by ID. Public catalog — only
approved skills are exposed. Submitted/draft/rejected skills must
use the publisher-owned views (/skills/mine or
_get_owned_skill).
Path Parameters
uuidResponse Body
curl -X GET "https://loading/v1/marketplace/skills/497f6eca-6276-4993-bfeb-53cbbbba6f08"{
"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"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Update Skill
Update a skill you own.
In: header
Path Parameters
uuidHeader Parameters
Response Body
curl -X PUT "https://loading/v1/marketplace/skills/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "X-Api-Key: string" \ -H "Content-Type: application/json" \ -d '{}'{
"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"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}List Skill Versions
List published versions of a skill. Public catalog — parent skill must be approved, otherwise versions for a private/submitted skill would leak to anyone who knows the skill ID.
Path Parameters
uuidResponse Body
curl -X GET "https://loading/v1/marketplace/skills/497f6eca-6276-4993-bfeb-53cbbbba6f08/versions"[
{
"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"
}
]{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Create Skill Version
Publish a new version of a skill.
"Sequel? We're doing a sequel?" — Every 80s action hero
In: header
Path Parameters
uuidQuery Parameters
1 <= length <= 30Pre-computed composite SHA-256 for non-builtin skills.
Header Parameters
Response Body
curl -X POST "https://loading/v1/marketplace/skills/497f6eca-6276-4993-bfeb-53cbbbba6f08/versions?version=string&changelog=string&bundle_hash=string" \ -H "X-Api-Key: string"{
"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"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}