Saltar al contenido principal
Bloquea un registro pendiente de un agente y desactiva de inmediato la clave de API, además de bloquear la cuenta en entorno aislado. Úsalo si el agente creó una clave sin autorización. No se requiere autenticación: el token de verificación sirve como prueba.

​
Encabezados

EncabezadoValor
Content-Typeapplication/json

​
Cuerpo de la solicitud

ParámetroTipoObligatorioDescripción
agent_signup_tokenstringSíEl token de verificación del enlace de confirmación del correo electrónico.

​
respuesta

FieldTypedescripción
successbooleanIndica si el bloque se ejecutó correctamente
messagestringMensaje de resultado legible para humanos

​
Ejemplo de solicitud

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

​
Respuesta de ejemplo

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

​
Qué ocurre al bloquear

  • La API key del agent se elimina.
  • El equipo en sandbox queda vetado.
  • El registro del patrocinador se marca como "blocked", lo que impide nuevos registros de agent para ese email.
  • Cualquier solicitud posterior a la API que use la API key bloqueada devolverá 403.

​
Respuestas de error

EstadoErrorCuándo
400Solicitud no válidaFalta agent_signup_token
404Token de verificación no válidoToken no encontrado
409Esta clave de agent ya se confirmóNo se puede bloquear una clave que ya se confirmó