Report an ask as sent or failed
Tell us what happened to an ask, whether it came from check or you requested it.
Questions? [email protected]
Tell us what happened to an ask, whether it came from check or you requested it.
Questions? [email protected]
/api/external/v1/chat-gate/asks/{id}also served at /api/external/chat-gate/asks/{id}NewTell us what happened to an ask, whether it came from check or you requested it.
Sent as messageId: we keep it, and chat.unlocked carries it back as unpinMessageId when the fan pays. Not sent (failed: true): the fan’s next message is asked again.
Send the creator's API key as a bearer token: Authorization: Bearer dpfn_…. See Authentication & API keys.
For a creator you manage or onboarded
POST /api/external/v1/creators/{creatorId}/chat-gate/asks/{id} — an agency's own key for a creator or AI persona it manages (needs canManageDrops), or your app owner's own key for an account your app onboarded. The X-Dropfans-Account header still works but is deprecated. See Acting for a creator.
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The ask.id from check or from [POST /chat-gate/asks](/developers/reference/request-chat-ask). |
Content type: application/json
| Name | Type | Required | Description |
|---|---|---|---|
messageId | integer | Optional | The sent message’s id. |
failed | boolean | Optional | true: it couldn’t be sent. |
{
"messageId": 4211
}{
"failed": true
}| Name | Type | Description |
|---|---|---|
ok | boolean | Always true. |
{
"ok": true
}| Status | Body | When |
|---|---|---|
| 400 | {"error":"Send messageId (the sent message id) or failed: true","code":"invalid_request"} | Neither. |
| 404 | {"error":"Ask not found: unknown, not your app’s, or the fan already paid","code":"ask_not_found"} | An unknown id, another app’s ask, or one already settled. |
| 401 | {"error":"Unauthorized","code":"unauthorized"} | Missing or invalid API key. |
| 403 | {"error":"This endpoint needs a key bound to an app with the chat_gate API category enabled — personal keys cannot use it.","code":"app_key_required","category":"chat_gate"} | A personal key: the chat gate answers back through app webhooks. |
| 503 | {"error":"The chat gate is not available right now. Let the message through.","code":"unavailable"} | Something failed on our side. Fail open: let the message stand. |
| 400 | {"error":"X-Dropfans-Account must be an account id (from GET /api/external/agency/creators), not a username.","code":"invalid_account_header"} | `X-Dropfans-Account` is not an account id. |
| 400 | {"error":"X-Dropfans-Account names a different account than the path — send one or the other.","code":"account_mismatch"} | Called under /v1/creators/{creatorId}/ with an `X-Dropfans-Account` naming another account. |
| 403 | {"error":"This key cannot act for that account.","code":"account_not_managed"} | The creator in the path (or `X-Dropfans-Account`) is one this key cannot act for: no ACCEPTED management by your agency and not an account your app onboarded (or it no longer holds a key bound to your app), a key minted for one creator, or someone is suspended, banned or deleted. An unknown id gets the same answer. |
| 403 | {"error":"The agency does not have permission for this on that account.","code":"permission_denied","permission":"canManageDrops"} | For a managed creator: the agency lacks `canManageDrops` on that account. |
| 403 | {"error":"This app does not have the chat_gate API category enabled. Contact support to enable it.","code":"api_category_disabled","category":"chat_gate"} | Your app has the Pay to Chat [API category](/developers/concepts/api-categories) switched off (the default for new apps). |
Every response carries the X-RateLimit-Tier header and, on limited tiers, the per-minute and per-day trios — read X-RateLimit-Remaining and X-RateLimit-Reset instead of hardcoding limits. Details in Rate limits.
curl -X POST "https://www.dropfans.io/api/external/v1/chat-gate/asks/$ID" \
-H "Authorization: Bearer $DROPFANS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"messageId": 4211
}'const id = '…'; // from an earlier response
const res = await fetch(`https://www.dropfans.io/api/external/v1/chat-gate/asks/${id}`, {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"messageId": 4211
}),
});
console.log(await res.json());import os
import requests
id = "…" # from an earlier response
res = requests.post(
f"https://www.dropfans.io/api/external/v1/chat-gate/asks/{id}",
headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
json={
"messageId": 4211,
},
)
print(res.json())