ArgorantDocs

Autenticación

Claves de API, la URL base, qué permite cada scope de clave y cómo inician sesión los agentes de IA sin clave.

URL base

Text
https://app.argorant.com/api/v1

Claves de API

Inicia sesión en app.argorant.com/profile y crea una clave en Claves de API. Las claves empiezan por ag_live_ y se muestran una sola vez. Ponle a cada clave el nombre de lo que la usa, como zapier, ci o laptop, para poder revocar una sin romper las demás.

Envía la clave en cada llamada:

Shell
curl "https://app.argorant.com/api/v1/account" \
  -H "Authorization: Bearer $ARGORANT_API_KEY"

La respuesta te dice en nombre de quién actúa la clave, tu plan, tus créditos, cuántas solicitudes por minuto puede enviar la clave y lo que queda de los límites de hoy. Haz esta llamada antes de un trabajo grande.

Las claves de API funcionan durante la prueba de 7 días y en todos los planes. La herramienta de línea de comandos lee la misma clave desde npx argorant login o desde la variable ARGORANT_API_KEY.

Scopes

Una clave creada en la app tiene todos los scopes de abajo. Una clave más limitada recibe 403 con el código scope_missing cuando llama a algo fuera de sus scopes.

ScopePermitePuede costar
argorant:read_countsRecuentos, listas de términos, la cuenta, leer campañas, la bandeja de entrada, los buzones y los webhooksNada
argorant:search_segmentsVistas previas enmascaradas de personas y empresasNada
argorant:manage_listsListas, campañas, lanzamientos, responder a respuestas, estados, buzones, la lista de bloqueo, webhooks, pedidos de buzonesLos pedidos de buzones cuestan dinero, tras un sí
argorant:unlock_contactsDesbloqueos, números de teléfono, enriquecimiento de personas, el buscador de correosCréditos
argorant:create_exportsExportaciones y exportaciones de listasCréditos
argorant:verify_emailsVerificar tus propias listasCréditos, medio crédito por verificación nueva

Los agentes de IA inician sesión, nunca ven la clave

Los clientes MCP como Claude y ChatGPT se conectan a https://mcp.argorant.com/mcp e inician sesión con OAuth 2.1 (código de autorización con PKCE). Actúan en nombre de tu cuenta con los scopes que apruebas, y tu clave de API nunca acaba en un chat. Consulta Conectar un cliente.

Permisos dentro de un espacio de trabajo

Una clave actúa como la persona que la creó. Propietarios y miembros solo ven su propio espacio de trabajo. Algunas acciones, como pedir buzones, son del propietario del espacio de trabajo; un miembro recibe 403 con un mensaje claro que lo indica. Los elementos de otros espacios de trabajo siempre responden 404 not_found, igual que los elementos que no existen.

En esta página