Autenticación

Crea una clave

Abre Settings y después API keys. Ponle a la clave un nombre que diga dónde se va a usar y créala.

La clave se muestra una sola vez. Cópiala enseguida y guárdala en un lugar seguro, como las variables de entorno de tu servidor. Setherion guarda solo una huella de ella, así que nadie puede volver a mostrártela, nosotros tampoco. Si la pierdes, revócala y crea una nueva.

Una clave empieza por sth_, seguido de 43 letras, dígitos, - y _ aleatorios, 47 caracteres en total. El nombre puede tener hasta 60 caracteres; si es más largo, se corta.

Envíala con cada petición

Pon la clave en la cabecera Authorization:

curl https://www.setherion.com/api/v1/projects \
  -H "Authorization: Bearer $SETHERION_API_KEY"

const res = await fetch('https://www.setherion.com/api/v1/projects', {
  headers: { Authorization: `Bearer ${process.env.SETHERION_API_KEY}` },
})
const data = await res.json()

Solo se lee el esquema Bearer. Una petición sin una clave válida recibe 401:

{
  "ok": false,
  "error": "A valid API key is required. Make one on your Setherion account page and send it as \"Authorization: Bearer sth_...\"."
}

Una cabecera ausente, una clave mal escrita, una que no existe y una que fue revocada reciben esta misma respuesta, así que nunca te dice cuál de ellas era.

Qué puede hacer una clave

Una clave actúa como tú. Puede hacer lo que tú puedes hacer en Setherion:

• ver las aplicaciones de tu panel de control, las tuyas y las que se comparten contigo;
• leer la guía de tiendas y las respuestas de privacidad de cualquier aplicación que puedas abrir;
• cambiar las aplicaciones que puedes editar, gastando créditos igual que una edición en el editor;
• publicar las aplicaciones que puedes editar y escribir su página de la tienda.

Tu rol en cada aplicación decide el resto. Una llamada que lee necesita viewer o más; una llamada que cambia una aplicación o gasta créditos necesita editor o más. Mira Introducción para saber qué llamada necesita qué.

Una clave no puede cambiar tu cuenta, tu plan ni tu facturación, y no puede crear ni revocar claves: eso solo es posible cuando has iniciado sesión en Setherion tú mismo, así que una clave filtrada nunca puede generar otras.

Revoca una clave

En API keys, pulsa Revoke junto a la clave. Deja de funcionar al instante. Las claves revocadas se quedan en la lista para que veas cuándo se usaron por última vez.

Puedes tener hasta 10 claves activas a la vez. Si pides una número 11, se rechaza con You have 10 active keys. Revoke one you no longer use to make another. La lista muestra cuándo se usó cada clave por última vez, actualizado como máximo una vez por minuto.

Iniciar sesión sin una clave

Los asistentes de IA se conectan con una página de inicio de sesión y un botón Allow en lugar de una clave. Mira MCP: conecta un asistente de IA.

Los tokens que produce ese inicio de sesión funcionan solo en la dirección del asistente (/api/mcp). Los endpoints de esta referencia aceptan una clave de API y nada más.