Autenticación en la API

La API de TeamDay usa Tokens de Acceso Personal (PAT) para la autenticación.

Crear un Token

  1. Ve a Configuración → Claves de API
  2. Haz clic en "+ Nuevo Token de Acceso Personal"
  3. Asigna un nombre descriptivo
  4. Selecciona expiración (recomendado: 90 días)
  5. Haz clic en "Crear"

Guarda el token de forma segura - solo se muestra una vez.

Usar el Token

Incluye el token en el encabezado Authorization:

curl -H "Authorization: Bearer td_your_token_here" \
  https://cc.teamday.ai/api/v1/agents

O usa variable de entorno:

export TEAMDAY_API_TOKEN="td_your_token_here"

curl -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  https://cc.teamday.ai/api/v1/agents

Seguridad

  • Nunca compartas tu token
  • Rota tokens regularmente
  • Revoca tokens que no uses
  • Usa variables de entorno en código

Expiración

Los tokens expiran después del período seleccionado. Antes de expirar:

  1. Ve a Configuración → Claves de API
  2. Verás aviso de expiración próxima
  3. Crea un nuevo token
  4. Actualiza tu código/scripts
  5. Revoca el token antiguo

Revocar Token

  1. Ve a Configuración → Claves de API
  2. Encuentra el token
  3. Haz clic en "Eliminar"
  4. Confirma

Un token revocado no funcionará más.

Errores de Autenticación

401 Unauthorized:

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or expired token"
  }
}

Solución: Verifica que tu token sea válido y no haya expirado.

403 Forbidden:

{
  "error": {
    "code": "FORBIDDEN",
    "message": "Token does not have required permissions"
  }
}

Solución: Verifica que estés en la organización correcta.

Próximos Pasos