Saltar al contenido principal
POST
Ofrecer delegación
Crea una oferta de delegación de confianza entre inquilinos. Las delegaciones de confianza permiten que los agentes de un inquilino otorguen permisos específicos y con alcance a los agentes de otro inquilino, lo que permite flujos de trabajo de IA seguros entre múltiples organizaciones sin compartir credenciales. Las ofertas de delegación tienen un tiempo limitado y un alcance restringido. El inquilino objetivo debe aceptar explícitamente la oferta antes de que la delegación se active. Todos los eventos del ciclo de vida de la delegación se registran en el registro de transparencia.

Restricciones de delegación

Las delegaciones entre inquilinos son una operación privilegiada. El agente oferente debe tienen el permiso delegations:offer y el inquilino de destino debe estar en el la lista de socios de confianza del inquilino que ofrece.

Respuesta

string
Identificador único de oferta de delegación.
string
Estado de la delegación. Siempre offered en la creación.
string
El agente que creó la oferta.
string
Inquilino del agente que ofrece.
string
Inquilino objetivo que puede aceptar la oferta.
string[]
Ámbitos de permisos delegados.
integer
Profundidad máxima de re-delegación.
string
Marca de tiempo ISO 8601 cuando la oferta expira si no es aceptada.
string
Marca de tiempo de creación ISO 8601.

Autorizaciones

X-API-Key
string
header
requerido

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

Cuerpo

application/json
accepting_tenant_id
string
requerido
offered_by_agent_id
string
requerido
allowed_scopes
string[]
max_delegation_depth
integer
metadata
any
ttl_hours
integer

Respuesta

Delegación ofrecida

delegation_id
string<uuid>
from_agent_id
string<uuid>
to_agent_id
string<uuid>
scopes
string[]
ttl_seconds
integer
conditions
object
status
enum<string>
Opciones disponibles:
offered,
active,
expired,
revoked
token
string

Token de aceptación de delegación (devuelto en la oferta)

created_at
string<date-time>
expires_at
string<date-time>