跳转到主要内容
封禁处于待处理状态的代理注册，立即禁用该 API 密钥并封禁沙盒账户。若代理未经授权创建了密钥，请使用此功能。无需身份验证——验证令牌本身即可作为凭证。

​
请求头

请求头值
Content-Typeapplication/json

​
请求体

参数类型必需描述
agent_signup_tokenstring是确认 email 中链接里的验证令牌。

​
响应

字段类型描述
success布尔值该操作是否成功
message字符串便于人工阅读的结果消息

​
请求示例

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

​
示例响应

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

​
封禁后会发生什么

  • 代理的 API 密钥会被删除。
  • 沙盒团队会被封禁。
  • sponsor 记录会被标记为 "blocked"，从而阻止该 email 后续进行代理注册。
  • 任何继续使用被封禁密钥发起的 API 请求都将返回 403。

​
错误响应

状态错误出现情况
400请求无效缺少 agent_signup_token
404验证令牌无效未找到令牌
409该代理密钥已确认无法封禁已确认的密钥