Guide: Publish an Agent

Publish your Flapjack agent as a shareable link that anyone can interact with — no API key needed.

How Published Chats Work

You publish agent → Get a public URL → Anyone can chat with it
https://flapjack.chat/chat/{slug}

Published chats are standalone web interfaces. Users interact directly with your agent without needing a Flapjack account or API key.

Publishing via Dashboard

1. Go to Agents → Select your agent
2. Click Publish
3. Set a slug (URL identifier)
4. Choose visibility
5. Copy the public URL

Publishing via API

curl -X POST https://api.flapjack.dev/api/agents/{agentId}/publish \
  -H "Authorization: Bearer fj_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "my-support-bot",
    "visibility": "public",
    "title": "Acme Support",
    "description": "Ask me anything about Acme products"
  }'

📋 Copy as prompt

Publish my Flapjack agent as a public chat. POST to /api/agents/{agentId}/publish with a slug, visibility, title, and description.

Visibility Options

Visibility	Description
public	Anyone with the link can chat
private	Requires session verification

Unpublishing

curl -X DELETE https://api.flapjack.dev/api/agents/{agentId}/publish \
  -H "Authorization: Bearer fj_live_..."

Public Chat API

Published chats have their own API endpoints that don't require authentication:

Method	Endpoint	Description
GET	/api/public/chat/{slug}	Get chat metadata
POST	/api/public/chat/{slug}/threads	Create a thread
POST	/api/public/chat/{slug}/threads/{id}/messages	Send a message (SSE)
POST	/api/public/chat/{slug}/threads/{id}/stop	Stop response

Next Steps

• Concepts: Agents — agent configuration
• API: Agents — agent management endpoints