Marketplace API reference

Browse marketplace

marketplace.browseread

Searches snapshots other users have published, by keyword and category. Installing one still requires buying or being granted it.

Parameters

Field	Type	Required	Description
category	string	optional	Narrow to one category, e.g. "lead-gen". Omit for everything.
search	string	optional	Keyword to match against the listing title.

Example

curl -X POST https://app.chirply.io/api/v1/actions/marketplace.browse \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "example",
    "search": "example"
  }'

Test with your API key

Over MCP the same operation is the tool marketplace_browse at https://app.chirply.io/api/mcp, same bearer token, same input.

My listing

marketplace.get_my_listingreadadmin only

This account's marketplace listing for a snapshot, including its review state and any note the reviewer left.

Parameters

Field	Type	Required	Description
snapshot_id	string (uuid)	required	The snapshot's id.

Example

curl -X POST https://app.chirply.io/api/v1/actions/marketplace.get_my_listing \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "snapshot_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Test with your API key

Over MCP the same operation is the tool marketplace_get_my_listing at https://app.chirply.io/api/mcp, same bearer token, same input.

Report a listing

marketplace.report_listingwriteconfirm

Flags a marketplace listing to the platform team as spam, malicious, broken or infringing. Three open reports suspend a listing pending review.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Field	Type	Required	Description
listing_id	string (uuid)	required	The listing's id.
reason	"spam" \| "malicious" \| "broken" \| "copyright" \| "other"	required	Why you're reporting it.
detail	string	optional	What you saw.

Example

curl -X POST https://app.chirply.io/api/v1/actions/marketplace.report_listing \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "listing_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "reason": "spam"
  }'

Test with your API key

Over MCP the same operation is the tool marketplace_report_listing at https://app.chirply.io/api/mcp, same bearer token, same input.

Submit for review

marketplace.submit_listingwriteconfirmowner only

Sends the listing to the platform team for review and public publication. A platform admin reads the whole configuration first, including every outbound URL it would contact.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Field	Type	Required	Description
snapshot_id	string (uuid)	required	The snapshot whose listing to submit.

Example

curl -X POST https://app.chirply.io/api/v1/actions/marketplace.submit_listing \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "snapshot_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Test with your API key

Over MCP the same operation is the tool marketplace_submit_listing at https://app.chirply.io/api/mcp, same bearer token, same input.

Submit template for review

marketplace.submit_templatewriteconfirmadmin only

Submit one of this account's saved funnel, page, or section templates for marketplace review. This exposes the frozen builder document to platform reviewers but does not make it public until a platform admin approves it.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Field	Type	Required	Description
template_id	string (uuid)	required	The saved template to submit.
title	string	required	Title shown on the marketplace card.
tagline	string	optional	Short outcome-focused description shown under the title.

Example

curl -X POST https://app.chirply.io/api/v1/actions/marketplace.submit_template \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "title": "Example"
  }'

Test with your API key

Over MCP the same operation is the tool marketplace_submit_template at https://app.chirply.io/api/mcp, same bearer token, same input.

Unlist

marketplace.unlistwriteconfirmowner only

Removes a listing from public browsing. Existing licences and anything already installed are unaffected.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Field	Type	Required	Description
snapshot_id	string (uuid)	required	The snapshot to unlist.

Example

curl -X POST https://app.chirply.io/api/v1/actions/marketplace.unlist \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "snapshot_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Test with your API key

Over MCP the same operation is the tool marketplace_unlist at https://app.chirply.io/api/mcp, same bearer token, same input.

Unlist template

marketplace.unlist_templatewriteconfirmadmin only

Withdraw this account's funnel, page, or section template from marketplace browsing. Copies already created in other accounts remain intact.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Field	Type	Required	Description
template_id	string (uuid)	required	The saved template to withdraw.

Example

curl -X POST https://app.chirply.io/api/v1/actions/marketplace.unlist_template \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11"
  }'

Test with your API key

Over MCP the same operation is the tool marketplace_unlist_template at https://app.chirply.io/api/mcp, same bearer token, same input.

Edit listing

marketplace.upsert_listingwriteconfirmadmin only

Creates or edits the marketplace listing copy for a snapshot — the title, tagline, description and category buyers read. Editing does NOT publish an unpublished listing; submit it for review separately. But it does NOT re-enter review either: if the listing is already public, the new copy replaces the approved copy immediately and everyone browsing the marketplace sees it, with no moderator in between. Treat it as editing live public text.

Marked confirm: this operation is irreversible, reaches real people, or spends money. Holding a credential is itself the confirmation for API and MCP callers — call it only when you mean it. The in-app assistant refuses to run it without a human approving first.

Parameters

Field	Type	Required	Description
snapshot_id	string (uuid)	required	The snapshot to list.
title	string	required	The headline buyers see.
tagline	string	optional	One line under the title.
body	string	optional	The full description. Rendered as plain text, never as HTML.
category	string	optional	Grouping for browsing, e.g. "lead-gen".

Example

curl -X POST https://app.chirply.io/api/v1/actions/marketplace.upsert_listing \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "snapshot_id": "2f6a1c1e-6c3b-4c62-9f6e-8a2d4b7c9e11",
    "title": "Example"
  }'

Test with your API key

Over MCP the same operation is the tool marketplace_upsert_listing at https://app.chirply.io/api/mcp, same bearer token, same input.