> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ofrecer delegación entre inquilinos

> Ofrezca una delegación de confianza con alcance a un agente en otro inquilino.

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

| Restricción | Límite | Descripción |
| :- | :- | :- |
| Profundidad máxima | 3 | Las delegaciones no pueden ser re-delegadas más allá de 3 saltos |
| TTL máximo | 24 horas | Las delegaciones expiran automáticamente después de la duración especificada |
| Alcance limitado | Por oferta | Cada delegación está limitada a los alcances explícitamente listados |

> [!WARNING]
>
> 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

**id** `string`

Identificador único de oferta de delegación.

**status** `string`

Estado de la delegación. Siempre `offered` en la creación.

**offered\_by\_agent\_id** `string`

El agente que creó la oferta.

**offered\_by\_tenant\_id** `string`

Inquilino del agente que ofrece.

**target\_tenant\_id** `string`

Inquilino objetivo que puede aceptar la oferta.

**scopes** `string[]`

Ámbitos de permisos delegados.

**max\_depth** `integer`

Profundidad máxima de re-delegación.

**expires\_at** `string`

Marca de tiempo ISO 8601 cuando la oferta expira si no es aceptada.

**created\_at** `string`

Marca de tiempo de creación ISO 8601.


## OpenAPI

````yaml es/mint-openapi.yaml POST /v1/delegations/cross-tenant/offer
openapi: 3.0.3
info:
  title: Truthlocks API
  description: >
    Truthlocks es una infraestructura de verificación universal para documentos,
    credenciales y activos digitales.

    Esta especificación define la API canónica para interactuar con los
    servicios de Truthlocks.


    ## URLs Base

    - **Producción**: `https://api.truthlocks.com`

    - **Sandbox**: `https://sandbox-api.truthlocks.com`


    ## Autenticación

    - **Claves API**: Use el encabezado `X-API-Key` para operaciones máquina a
    máquina

    - **Tokens Bearer**: Use `Authorization: Bearer <jwt>` para operaciones
    iniciadas por el usuario


    ## Identidad del Inquilino

    En producción, la identidad del inquilino se deriva del contexto autenticado
    (clave API o JWT).

    El encabezado `X-Tenant-ID` se ignora en producción para evitar la
    suplantación de identidad.
  version: 1.0.0
  contact:
    name: Truthlocks Support
    url: https://truthlocks.com/support
    email: support@truthlocks.com
servers:
  - url: https://api.truthlocks.com
    description: API de producción
  - url: https://sandbox-api.truthlocks.com
    description: Entorno Sandbox
security:
  - APIKey: []
  - BearerAuth: []
tags:
  - name: Authentication
    description: Gestión de claves y tokens de API
  - name: Issuers
    description: Registro del emisor y gestión de la confianza
  - name: Keys
    description: Gestión de claves criptográficas para emisores
  - name: Attestations
    description: Ciclo de vida de la atestación (acuñar, revocar, reemplazar)
  - name: Verification
    description: Verificación de atestación y paquetes de prueba
  - name: Governance
    description: Flujos de trabajo de gobernanza del emisor (solo administrador)
  - name: Identity
    description: Gestión de organización, usuarios y roles
  - name: Audit
    description: Consultas de eventos de auditoría
  - name: Tenant Console
    description: Puntos finales de perfil y ciclo de vida del inquilino
  - name: Health
    description: Endpoints de estado y preparación del servicio
  - name: Risk
    description: Ingesta de señales de riesgo y detección de fraude
  - name: Risk Enforcement
    description: >-
      Acciones de aplicación de riesgos: bloqueo, desafío, cuarentena y
      configuración
  - name: Billing
    description: Gestión de facturación, suscripciones y complementos
  - name: Machine Identity
    description: >-
      Protocolo de Identidad de Agente de Máquina (MAIP) — registro de agentes,
      sesiones, confianza, testigo, cumplimiento, orquestación y observabilidad
externalDocs:
  description: API de transparencia de solo lectura (especificación de servicio separada)
  url: >-
    https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
  /v1/delegations/cross-tenant/offer:
    post:
      tags:
        - Machine Identity
      summary: Ofrecer delegación
      description: >-
        Crea una oferta de delegación de un agente a otro, otorgando un
        subconjunto de ámbitos con un TTL y condiciones opcionales. El agente
        receptor debe aceptar explícitamente la delegación.
      operationId: maip.delegations.offer
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                accepting_tenant_id:
                  type: string
                allowed_scopes:
                  type: array
                  items:
                    type: string
                max_delegation_depth:
                  type: integer
                metadata: {}
                offered_by_agent_id:
                  type: string
                ttl_hours:
                  type: integer
              type: object
              required:
                - accepting_tenant_id
                - offered_by_agent_id
      responses:
        '201':
          description: Delegación ofrecida
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MaipDelegation'
        '400':
          description: Error de validación o escalada de alcance
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '401':
          description: Autenticación requerida
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '404':
          description: Agente no encontrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '429':
          description: Límite de velocidad excedido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      security:
        - APIKey: []
components:
  schemas:
    MaipDelegation:
      type: object
      properties:
        delegation_id:
          type: string
          format: uuid
        from_agent_id:
          type: string
          format: uuid
        to_agent_id:
          type: string
          format: uuid
        scopes:
          type: array
          items:
            type: string
        ttl_seconds:
          type: integer
        conditions:
          type: object
          additionalProperties: true
        status:
          type: string
          enum:
            - offered
            - active
            - expired
            - revoked
        token:
          type: string
          description: Token de aceptación de delegación (devuelto en la oferta)
        created_at:
          type: string
          format: date-time
        expires_at:
          type: string
          format: date-time
    ErrorEnvelope:
      type: object
      required:
        - code
        - message
        - http_status
      properties:
        code:
          type: string
          description: Código de error legible por máquina
          enum:
            - AUTH_REQUIRED
            - AUTH_INVALID
            - PERMISSION_DENIED
            - TENANT_IDENTITY_UNVERIFIED
            - NOT_FOUND
            - VALIDATION_ERROR
            - CONFLICT
            - PAYLOAD_TOO_LARGE
            - RATE_LIMIT_EXCEEDED
            - QUOTA_EXCEEDED
            - SERVICE_UNAVAILABLE
            - INTERNAL_ERROR
        message:
          type: string
          description: Mensaje de error legible por humanos
        http_status:
          type: integer
          description: Código de estado HTTP
        retry_after_ms:
          type: integer
          description: Milisegundos a esperar antes de reintentar (para límites de tasa)
        details:
          type: object
          description: Contexto de error adicional
      example:
        code: AUTH_REQUIRED
        message: Authentication required
        http_status: 401
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Clave API para autenticación máquina a máquina
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT para operaciones iniciadas por el usuario

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.