Saltar para o conteúdo principal
POST
Oferecer Delegação
Cria uma oferta de delegação de confiança entre inquilinos. As delegações de confiança permitem que agentes em um inquilino concedam permissões específicas e com escopo a agentes em outro inquilino — permitindo fluxos de trabalho de IA multi-organização seguros sem compartilhar credenciais. As ofertas de delegação são limitadas no tempo e restritas por escopo. O inquilino de destino deve aceitar explicitamente a oferta antes que a delegação se torne ativa. Todos os eventos do ciclo de vida da delegação são registrados no log de transparência.

Restrições de Delegação

Delegações entre locatários são uma operação privilegiada. O agente ofertante deve ter a permissão delegations:offer e o locatário de destino deve estar no oferecendo a lista de parceiros confiáveis do locatário.

Resposta

string
Identificador de oferta de delegação único.
string
Status da delegação. Sempre offered na criação.
string
O agente que criou a oferta.
string
Locatário do agente ofertante.
string
Locatário de destino que pode aceitar a oferta.
string[]
Escopos de permissão delegados.
integer
Profundidade máxima de re-delegação.
string
Carimbo de data/hora ISO 8601 quando a oferta expira se não for aceita.
string
Carimbo de data/hora de criação ISO 8601.

Autorizações

X-API-Key
string
header
obrigatório

Chave de API para autenticação máquina a máquina

Corpo

application/json
accepting_tenant_id
string
obrigatório
offered_by_agent_id
string
obrigatório
allowed_scopes
string[]
max_delegation_depth
integer
metadata
any
ttl_hours
integer

Resposta

Delegação oferecida

delegation_id
string<uuid>
from_agent_id
string<uuid>
to_agent_id
string<uuid>
scopes
string[]
ttl_seconds
integer
conditions
object
status
enum<string>
Opções disponíveis:
offered,
active,
expired,
revoked
token
string

Token de aceitação de delegação (retornado na oferta)

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