封禁代理注册

封禁并禁用由代理预配的 API 密钥。

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

​

请求头

请求头	值
Content-Type	application/json

​

请求体

参数	类型	必需	描述
agent_signup_token	string	是	确认 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	该代理密钥已确认	无法封禁已确认的密钥