Welcome to Poe for Developers
How to create a prompt bot
Best practices for prompts
Accessing other bots on Poe
Using OpenAI function calling
Rendering an image in the response
Sending files with your response
Enabling file upload for your bot
Setting an introduction message
Updating bot settings
Accessing HTTP request information
How we cover your costs
Poe Protocol Specification
Samples and next steps
How to get distribution
How to contact us
Frequently asked questions
The Poe server will send an HTTP POST request to the bot servers URL with content type
. The body will be a JSON dictionary with the following keys:
: The API version that the server is using.
: This is one of the following strings:
: Called when the user makes a query to the bot (i.e., they send a message).
: Query the bot for its desired settings.
: Report to the bot server when certain events happen (e.g., the user likes a message).
: Report to the bot server when an error happens that is attributable to the bot (e.g., it uses the protocol incorrectly).
Additional request types may be added in the future. Bot servers should ignore any request types they do not understand, ideally by sending a
501 Not Implemented
Each of the request types is discussed in detail below: