确认代理注册

验证并将由代理预配的 API 密钥关联到赞助方账户。

确认待处理的代理注册。如果赞助方已有 Firecrawl 账户，该密钥将并入该账户。如果没有，沙盒账户将升级为使用赞助方 email 的正式账户。无需身份验证——验证令牌本身即可作为凭证。

​

请求头

请求头	值
Content-Type	application/json

​

请求体

参数	类型	必填	描述
agent_signup_token	string	是	确认邮件中链接里的验证令牌。

​

响应

字段	类型	描述
success	boolean	确认是否成功
message	string	便于阅读的结果消息

​

请求示例

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

​

响应示例

{
  "success": true,
  "message": "Agent key confirmed and linked to your account."
}

​

确认后会发生什么

• 现有账户：代理的 API 密钥将转移到赞助方的团队中。沙盒账户将被停用。
• 无账户：沙盒账户的 email 将更新为赞助方的 email，并成为其正式账户。
• 在这两种情况下，50 积分上限都会被移除，且该密钥将继承赞助方的完整订阅方案。

​

错误响应

状态	错误	何时
400	无效的请求	缺少 agent_signup_token
403	已超过验证期限	5 天确认窗口已过期
403	此代理注册已被阻止	赞助方已阻止此密钥
404	验证令牌无效或已过期	未找到令牌或令牌已被使用