Saltar al contenido principal
POST
Crear sesión

Crear Sesión

POST /v1/agent-sessions Crea una nueva sesión autenticada para un agente de máquina. La sesión vincula un token de acceso de tiempo limitado y un token de actualización al agente, con un conjunto de ámbito explícito que debe ser un subconjunto de los ámbitos concedidos al agente. Los token y refresh_token se devuelven solo en la respuesta de creación. Guárdelos de forma segura, no se pueden recuperar más tarde.
Los campos token y refresh_token solo se devuelven una vez en esta respuesta. Almacénelos en un gestor de secretos seguro o en un almacenamiento cifrado inmediatamente. Si se pierde, termine la sesión y cree una nueva.

Autenticación

Requiere el encabezado X-API-Key o el token Bearer JWT. El espacio de trabajo se deriva de la credencial autenticada; no envíe X-Tenant-ID.

Respuesta

object
El objeto de sesión creado que contiene:
string
Clave primaria UUID interna.
string
Identificador de sesión MAIP en formato maip-sess:<short-uuid>:<random-hex>. Utilice este ID en llamadas API posteriores.
string
El agente al que pertenece esta sesión.
string
Estado de la sesión. Siempre "active" en la creación.
string[]
Los alcances efectivos para esta sesión.
object
Metadatos de la sesión.
string
Marca de tiempo de expiración ISO 8601.
string
Marca de tiempo de creación ISO 8601.
string
Marca de tiempo de última actualización ISO 8601.
string
Token de acceso opaco para autenticar solicitudes de API dentro de esta sesión. Cadena hexadecimal de 64 caracteres. Devuelta solo una vez.
string
Token para refrescar la sesión antes de que caduque. Cadena hexadecimal de 64 caracteres. Devuelto solo una vez.

Ejemplo


Ciclo de vida de la sesión

Se crea automáticamente un recibo de sesión cuando comienza la sesión, vinculando la sesión a la pista de auditoría del agente.

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Cuerpo

application/json
agent_id
string<uuid>
requerido

Agente para el que se creará la sesión

metadata
any
scopes
string[]

Alcances para esta sesión (debe ser un subconjunto de los alcances del agente)

ttl_minutes
integer

Respuesta

Sesión creada

session_id
string<uuid>
agent_id
string<uuid>
token
string

Token de portador de sesión (devuelto una vez en la creación)

scopes
string[]
status
enum<string>
Opciones disponibles:
active,
terminated,
expired
metadata
object
expires_at
string<date-time>
created_at
string<date-time>
terminated_at
string<date-time>