Stop managing a creator
Ends the agency's management of a creator or persona — the same as "Leave agreement" in the dashboard.
/api/external/agency/creators/{id}NewEnds the agency's management of a creator or persona — the same as "Leave agreement" in the dashboard.
Split agreements end, keys the agency minted for the account stop working, X-Dropfans-Account stops working for it, and an AI persona is retired. Requires { "confirm": true } in the body so a retry loop or a stray call can never drop a creator. A real creator has to accept a new invite to come back.
Authentication
Send the creator's API key as a bearer token: Authorization: Bearer dpfn_…. See Authentication & API keys.
Needs the agency's own key, sent without X-Dropfans-Account.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | The account’s account id (id from GET /api/external/agency/creators). |
Request body
Content type: application/json
| Name | Type | Required | Description |
|---|---|---|---|
confirm | boolean | Required | Must be true. |
reason | string | Optional | Optional reason, stored with the relationship and shown to the creator. Max length: 300 |
{
"confirm": true,
"reason": "Contract ended"
}Responses
| Name | Type | Description |
|---|---|---|
id | string | The account id. |
status | string | Always "ended". One of: ended |
{
"id": "cmh3k9p2a0002cd5e6f7g8h9j",
"status": "ended"
}Errors
| Status | Body | When |
|---|---|---|
| 400 | {"error":"Agency endpoints act as the agency itself — send them without X-Dropfans-Account.","code":"account_header_not_allowed"} | The request carried `X-Dropfans-Account`. Agency endpoints always act as the agency. |
| 401 | {"error":"Unauthorized","code":"unauthorized"} | Missing or invalid API key. |
| 403 | {"error":"This endpoint needs a verified agency's own API key.","code":"agency_key_required"} | The key is not a verified agency’s own key — a creator’s key, or a key an agency minted for one of its creators. |
| 400 | {"error":"Send { \"confirm\": true } to end management of this creator.","code":"confirm_required"} | `confirm` is missing or not `true`. |
| 400 | {"error":"Invalid JSON body"} | The body is not valid JSON. |
| 404 | {"error":"Not managed by this agency.","code":"account_not_managed"} | No ACCEPTED relationship with this account. |
Rate limiting
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.
Code samples
curl -X DELETE "https://www.dropfans.io/api/external/agency/creators/$ACCOUNT_ID" \
-H "Authorization: Bearer $DROPFANS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"confirm": true,
"reason": "Contract ended"
}'const accountId = '…'; // from an earlier response
const res = await fetch(`https://www.dropfans.io/api/external/agency/creators/${accountId}`, {
method: 'DELETE',
headers: {
Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"confirm": true,
"reason": "Contract ended"
}),
});
console.log(await res.json());import os
import requests
account_id = "…" # from an earlier response
res = requests.delete(
f"https://www.dropfans.io/api/external/agency/creators/{account_id}",
headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
json={
"confirm": True,
"reason": "Contract ended",
},
)
print(res.json())Questions? [email protected]