Skip to main content
Blocks a pending agent signup, immediately disabling the API key and banning the sandboxed account. Use this if the agent created a key without authorization. No authentication required — the verification token acts as proof.

​
Headers

HeaderValue
Content-Typeapplication/json

​
Request Body

ParameterTypeRequiredDescription
agent_signup_tokenstringYesThe verification token from the confirmation email link.

​
Response

FieldTypeDescription
successbooleanWhether the block succeeded
messagestringHuman-readable result message

​
Example Request

curl -X POST "https://api.firecrawl.dev/v2/agent-signup/block" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_signup_token": "a1b2c3d4..."
  }'

​
Example Response

{
  "success": true,
  "message": "Agent key has been blocked and disabled."
}

​
What Happens on Block

  • The agent’s API key is deleted.
  • The sandboxed team is banned.
  • The sponsor record is marked as "blocked", preventing future agent signups for that email.
  • Any further API requests using the blocked key will return 403.

​
Error Responses

StatusErrorWhen
400Invalid requestMissing agent_signup_token
404Invalid verification tokenToken not found
409This agent key has already been confirmedCannot block a key that was already confirmed