> ## 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.

# Listar políticas MAIP

> Listar todas las políticas de aplicación de agentes para el inquilino autenticado

# Listar Políticas MAIP

`GET /v1/maip/policies`

Devuelve todas las políticas de agentes MAIP configuradas para el inquilino autenticado. Las políticas definen reglas de aplicación en tiempo de ejecución que rigen lo que los agentes pueden hacer en función de las puntuaciones de confianza, los alcances, la profundidad de la delegación y el tipo de agente.

### Autenticación

Requiere el encabezado `X-API-Key` o el token Bearer JWT. Con alcance de inquilino a través de cookie o reclamo JWT.

### Respuesta

Devuelve una matriz de objetos de política.

**id** `string`

Clave primaria UUID de la política.

**tenant\_id** `string`

UUID del inquilino propietario.

**name** `string`

Nombre de política legible por humanos. Usado en mensajes de denegación y registros de auditoría.

**description** `string`

Descripción detallada de lo que aplica la política.

**category** `string`

Categoría de política. Una de: `"scope"`, `"trust"`, `"rate"`, `"custom"`.

**status** `string`

Estado del ciclo de vida de la política. Uno de: `"active"`, `"disabled"`, `"archived"`. Solo
Las políticas `active` se evalúan durante las comprobaciones de políticas.

**priority** `integer`

Prioridad de evaluación. Los números más bajos se evalúan primero. Predeterminado: `100`.

**rules** `object`

Array JSON de reglas de política. Cada regla contiene condiciones, un efecto
(`"allow"`, `"deny"`, `"require_approval"`), y un
bandera `requires_approval`. Consulte [Crear política](#create-policy) para ver el
esquema de reglas.

**created\_at** `string`

Marca de tiempo de creación ISO 8601.

**updated\_at** `string`

Marca de tiempo de última actualización ISO 8601.

### Ejemplo

```bash theme={null}
curl https://api.truthlocks.com/v1/maip/policies \
  -H "X-API-Key: tl_live_..."
```

```javascript theme={null}
const response = await fetch("https://api.truthlocks.com/v1/maip/policies", {
  headers: { "X-API-Key": "tl_live_..." },
});
const policies = await response.json();
```

```python theme={null}
import requests

response = requests.get(
    "https://api.truthlocks.com/v1/maip/policies",
    headers={"X-API-Key": "tl_live_..."},
)
policies = response.json()
```


## OpenAPI

````yaml es/mint-openapi.yaml GET /v1/maip/policies
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/maip/policies:
    get:
      tags:
        - Machine Identity
      summary: Listar políticas MAIP
      description: >
        Devuelve todas las políticas de aplicación de agentes MAIP configuradas
        para el inquilino

        autenticado. Solo las políticas activas se evalúan durante las
        comprobaciones de políticas en tiempo de ejecución.
      operationId: maip.policies.list
      responses:
        '200':
          description: Matriz de políticas
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MaipPolicy'
        '401':
          description: Autenticación requerida
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      security:
        - APIKey: []
components:
  schemas:
    MaipPolicy:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Clave primaria UUID
        tenant_id:
          type: string
          format: uuid
          description: UUID del inquilino propietario
        name:
          type: string
          description: Nombre de la política legible por humanos
        description:
          type: string
          description: Descripción detallada de la política
        category:
          type: string
          enum:
            - scope
            - trust
            - rate
            - custom
          description: Categoría de política
        status:
          type: string
          enum:
            - active
            - disabled
            - archived
          description: Estado del ciclo de vida de la política
        priority:
          type: integer
          description: Prioridad de evaluación (menor = primero)
        rules:
          type: array
          items:
            $ref: '#/components/schemas/MaipPolicyRule'
          description: Matriz de reglas de política
        created_at:
          type: string
          format: date-time
        updated_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
    MaipPolicyRule:
      type: object
      properties:
        conditions:
          type: array
          items:
            $ref: '#/components/schemas/MaipPolicyCondition'
          description: Condiciones que deben coincidir todas (lógica AND)
        effect:
          type: string
          enum:
            - allow
            - deny
            - require_approval
          description: Acción a tomar cuando las condiciones coinciden
        requires_approval:
          type: boolean
          description: Si se requiere aprobación humana
    MaipPolicyCondition:
      type: object
      properties:
        field:
          type: string
          enum:
            - trust_score
            - scope
            - agent_type
            - delegation_depth
          description: El campo a evaluar
        op:
          type: string
          enum:
            - eq
            - ne
            - lt
            - gt
            - le
            - ge
            - in
            - contains
          description: Operador de comparación
        value:
          description: Valor con el que comparar (el tipo depende del campo)
  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.