Hey.Café Endpoint Docs

Post Conversation Create

Docs Home / Post Conversation / Post Conversation Create
Requires TokenAgecheckCache Purge

post_conversation_create

Post a new conversation.

Primary URL: https://endpoint.hey.cafe/post_conversation_create

Variables

A list of variables needed to make the call work, they can be provided via the URL or POST.

base64Required
content
The text encoded for the new conversation.
text
content_raw
You can use this if you want to provide the text without encoding.
text
cafe
The café ID to post into.
text
file
The file ID to include in the conversation, you need to send the file to post_temp_file.
text
image_url
A url to a file to download and attach to the conversation.
base64
alt
The text encoded up to 2000 characters that will be used for the file alt text.
boolian
adult
If TRUE we will flag the file as adult.
boolian
spoiler
If TRUE we will flag the file as spoiler.
boolian
ai
If TRUE we will flag the file as AI generated.
boolean
draft
If TRUE it will only save the conversation as a draft.

Error Codes

A list of error codes this call can return and what that it means.

to_large
Sorry but this conversation contains too many characters.
image_upload_failed
Image upload failed to be saved to our storage.
cafe_denied
You are not allowed to create a conversation in this café.
tag_denied
You are not allowed to create a conversation with this tag.
cafe_not_found
We are unable to find the café.
already_posted
You have already posted this content.
no_content
No content provided for the new conversation.
limit_reached
You have reached your limit of conversations at this time.
account_not_setup
Your account is not setup yet so you are not able to make a conversation.
needs_session
You are not using a valid session.

Response Modifications

We have a few URL options you can provide to modify the API response. If you have any suggestions let us know.

&convert_numeric=VARIABLE

This option will turn an array into a numeric response instead of KEYs when provided with the variable to modify. It will only work on main level variables at this time for example in the call endpoint.hey.cafe/api/account_conversations?query=anthony&convert_numeric=conversations.

&error_boolean=true

Return all responses in system_api_error as a boolean true or false only. If there is an error message when this is active it will be provided in system_api_error_message.

&error_no_http=true

Do not modify the HTTP response code when any error response happens, keep the HTTP response code as 200.

Flags

Some requests have rules that must be followed, they are done on the API end and will be automatically validated and if failed you will get an error message.

Needs Session

On fail will return needs_session and if this falg is set the request will only respond if made by a valid user session or API session.

Needs Agecheck

On fail you will get the response of needs_agecheck and this happens if request is made from an IP in a country or region that has an age verification law. To use this the IP must not be based in an age check region or the user must do the age verification in settings first.