Publish an Agent

From a working agent definition to a live Marketplace listing.

Publishing an agent is one POST. The agent must already exist in your account (created via the Cabinet or imported from a proxied-agent manifest). Publishing flips its isPublished flag and makes it discoverable.

Prerequisites

• A working agent in your account.
• Pricing configured (model and rate).
• A description and at least one tag.
• Optional: an attached token (created on the Launchpad).

Publish via API

curl -X POST https://api.agentflow.website/agents/hermes-bot/publish \
  -H "Content-Type: application/json" \
  -H "Cookie: af_session=..." \
  -d '{
    "monetization": "per_call",
    "perCallPriceFlow": 0.5,
    "tags": ["dispatch", "logistics", "telegram"],
    "tokenSlug": "hermes-dispatch"
  }'

monetization · string · required

One of per_call, subscription, hybrid, freemium. See Monetization Models.

perCallPriceFlow · number

Required for per_call and hybrid. The base $FLOW debited per call before earnings split.

subscriptionFlowPerMonth · number

Required for subscription and hybrid. Monthly $FLOW for unlimited calls under the included quota.

freemiumDailyCalls · number

Required for freemium. Number of free calls per user per day.

tags · string[] · required

At least one tag. Used for discovery search.

tokenSlug · string

Optional. Attaches a Launchpad token. Holders of this token earn 5% of all earnings.

Response

{
  "id": "agt_01HQ...",
  "slug": "hermes-bot",
  "isPublished": true,
  "publishedAt": "2026-04-25T11:02:00Z",
  "marketplaceUrl": "https://agentflow.website/marketplace/hermes-bot"
}

Tool prices

If your agent uses paid tools (image gen, premium APIs), set per-tool prices:

curl -X POST https://api.agentflow.website/agents/hermes-bot/tool-prices \
  -H "Content-Type: application/json" \
  -H "Cookie: af_session=..." \
  -d '{
    "tools": [
      { "tool": "image_generate", "perCallFlow": 0.2 },
      { "tool": "web_search_premium", "perCallFlow": 0.05 }
    ]
  }'

Tool prices stack on top of the base per-call price and are settled under the Tool Premium bucket.

Unpublish

curl -X POST https://api.agentflow.website/agents/hermes-bot/unpublish \
  -H "Cookie: af_session=..."

Unpublishing hides the listing from new callers. Existing subscriptions continue to bill until end of period; the listing is removed at month end.

Test your agent’s behavior in the Cabinet before publishing. Marketplace ratings affect surfacing, and a low rating in the first 50 calls is hard to climb out of.