Bloquear el registro del agente

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

Encabezado	Valor
`Content-Type`	`application/json`

Cuerpo de la solicitud

Parámetro	Tipo	Obligatorio	Descripción
`agent_signup_token`	string	Sí	El token de verificación del enlace de confirmación del correo electrónico.

respuesta

Field	Type	descripción
`success`	boolean	Indica si el bloque se ejecutó correctamente
`message`	string	Mensaje 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

Estado	Error	Cuándo
`400`	Solicitud no válida	Falta `agent_signup_token`
`404`	Token de verificación no válido	Token no encontrado
`409`	Esta clave de agent ya se confirmó	No se puede bloquear una clave que ya se confirmó

Uso de la API

Endpoints de scraping

Endpoints de búsqueda

Endpoints de mapeo

Endpoints de rastreo

Endpoints del navegador

Endpoints de agente

Endpoints de registro del Agent

Endpoints de extracción

Endpoints de la cuenta

Cargas útiles de webhook

Bloquear el registro del agente

Encabezados

Cuerpo de la solicitud

respuesta

Ejemplo de solicitud

Respuesta de ejemplo

Qué ocurre al bloquear

Respuestas de error

​Encabezados

​Cuerpo de la solicitud

​respuesta

​Ejemplo de solicitud

​Respuesta de ejemplo

​Qué ocurre al bloquear

​Respuestas de error

Encabezados

Cuerpo de la solicitud

respuesta

Ejemplo de solicitud

Respuesta de ejemplo

Qué ocurre al bloquear

Respuestas de error