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

# Rotar clave

> Crea una clave de reemplazo en el mismo emisor y entorno, y expira la clave antigua para una nueva emisión. Los registros almacenados emitidos antes del corte conservan el soporte de verificación a menos que la clave se vea comprometida o revocada. La generación gestionada admite Ed25519, ES256, ES384, RS256, RS512, PS256 y PS512.

Crea una clave de reemplazo para una clave activa y expira atómicamente la clave antigua para una nueva emisión. El reemplazo permanece en el mismo emisor y entorno. Utilice su `kid` devuelto explícitamente en las solicitudes de acuñación posteriores; los llamadores no se cambian silenciosamente a otra clave.

## Generar un reemplazo

```json theme={null}
{"provider": "KMS", "alg": "ES256"}
```

La generación gestionada admite Ed25519, ES256, ES384, RS256, RS512, PS256 y PS512. Para la importación de claves públicas, proporcione `kid`, `alg` y `public_key_b64url` con SubjectPublicKeyInfo DER codificado como base64url sin relleno. El material público importado por sí solo no puede acuñar nuevos registros. Consulte [algoritmos de firma](https://docs.truthlocks.com/es/enterprise/signing-algorithms.md).

## Registros existentes

La verificación utiliza la marca de tiempo de emisión registrada. Los registros emitidos antes del corte de la clave antigua aún pueden pasar la verificación de firma con su carga útil original. Una clave comprometida o revocada se rechaza incluso para registros más antiguos. Las marcas de tiempo confiables faltantes no pueden reemplazarse con una fecha proporcionada por el llamante.

El éxito devuelve HTTP **201** con la clave de reemplazo y `rotated_from`. Una clave retirada no se puede rotar de nuevo. Las comprobaciones de caducidad, revocación y firma de registros continúan aplicándose de forma independiente.


## OpenAPI

````yaml es/mint-openapi.yaml POST /v1/issuers/keys/{kid}/rotate
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/issuers/keys/{kid}/rotate:
    post:
      tags:
        - Keys
      summary: Rotar clave de emisor
      description: >-
        Crea una clave de reemplazo en el mismo emisor y entorno, y expira la
        clave antigua para una nueva emisión. Los registros almacenados emitidos
        antes del corte conservan el soporte de verificación a menos que la
        clave se vea comprometida o revocada. La generación gestionada admite
        Ed25519, ES256, ES384, RS256, RS512, PS256 y PS512.
      parameters:
        - name: kid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                alg:
                  $ref: '#/components/schemas/SigningAlgorithm'
                  description: Algoritmo de firma que coincide con la clave.
                kid:
                  type: string
                provider:
                  type: string
                  enum:
                    - KMS
                    - DEV
                  description: >-
                    KMS genera una clave de firma dedicada. DEV registra solo
                    material de verificación pública.
                public_key_b64url:
                  type: string
                  description: >-
                    SubjectPublicKeyInfo DER base64url sin relleno; requerido
                    para la importación, nunca envíe material de clave privada.
              type: object
              oneOf:
                - title: Managed signing key
                  required:
                    - provider
                  properties:
                    provider:
                      enum:
                        - KMS
                - title: Imported public verification key
                  required:
                    - kid
                    - alg
                    - public_key_b64url
                  properties:
                    provider:
                      enum:
                        - DEV
      responses:
        '201':
          description: Clave rotada
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Key'
      security:
        - APIKey: []
components:
  schemas:
    SigningAlgorithm:
      type: string
      enum:
        - Ed25519
        - ES256
        - ES384
        - ES512
        - RS256
        - RS384
        - RS512
        - PS256
        - PS384
        - PS512
      description: Algoritmo de firma para la generación de claves
    Key:
      type: object
      properties:
        kid:
          type: string
          description: Identificador de clave
        issuer_id:
          type: string
          format: uuid
        algorithm:
          $ref: '#/components/schemas/SigningAlgorithm'
        public_key:
          type: string
          description: Clave pública codificada en Base64
        status:
          type: string
          enum:
            - ACTIVE
            - DISABLED
            - EXPIRED
        not_before:
          type: string
          format: date-time
        expires_at:
          type: string
          format: date-time
  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.