Skip to main content
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.