Reactivate a retired AI persona
Brings a retired persona back online under the agency, with the same rules as the dashboard: not while another agency runs it, not over the 8-persona cap, and never for an account Dropfans suspended.
/api/external/v1/agency/personas/{id}/reactivatealso served at /api/external/agency/personas/{id}/reactivateNewBrings a retired persona back online under the agency, with the same rules as the dashboard: not while another agency runs it, not over the 8-persona cap, and never for an account Dropfans suspended.
Find retired personas with GET /api/external/v1/agency/creators?status=all.
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 persona’s account id (id from GET /api/external/v1/agency/creators). |
Responses
| Name | Type | Description |
|---|---|---|
id | string | The persona’s account id. |
status | string | Always "active". One of: active |
{
"id": "cmh4v2q8k0003xy9z7w6v5u4t",
"status": "active"
}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. |
| 404 | {"error":"Persona not found."} | No AI persona with this id was ever run by this agency. |
| 409 | {"error":"This persona is already active."} | Nothing to do. |
| 409 | {"error":"You've reached the maximum of 8 AI personas. Retire one before reactivating another."} | 8 personas are already active. |
| 409 | {"error":"@other_agency runs this persona now."} | Another agency runs the persona now. |
| 409 | {"error":"This persona account no longer exists."} | The account was deleted or banned. |
| 409 | {"error":"This persona was suspended by Dropfans — contact support."} | Suspended by Dropfans, not retired by the agency. |
| 500 | {"error":"Could not reactivate the persona."} | Unexpected failure — retry later. |
| 400 | {"error":"This endpoint acts as the key’s own account or app — call it without /creators/{creatorId}.","code":"creator_scope_not_allowed"} | Called under /api/external/v1/creators/{creatorId}/ — this endpoint always acts as the key’s own account, agency or app. |
| 403 | {"error":"This app does not have the agency API category enabled. Contact support to enable it.","code":"api_category_disabled","category":"agency"} | Your app has the Agency roster [API category](/developers/concepts/api-categories) switched off. |
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 POST "https://www.dropfans.io/api/external/v1/agency/personas/$ACCOUNT_ID/reactivate" \
-H "Authorization: Bearer $DROPFANS_API_KEY"const accountId = '…'; // from an earlier response
const res = await fetch(`https://www.dropfans.io/api/external/v1/agency/personas/${accountId}/reactivate`, {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
},
});
console.log(await res.json());import os
import requests
account_id = "…" # from an earlier response
res = requests.post(
f"https://www.dropfans.io/api/external/v1/agency/personas/{account_id}/reactivate",
headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
)
print(res.json())Questions? support@dropfans.io