> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Actualizar una plantilla > Utiliza este endpoint para actualizar una plantilla. La solicitud se envía como `multipart/form-data` y acepta actualizaciones parciales. - `description` puede actualizarse por sí solo. - `template` (el archivo `.tpl`) puede enviarse por sí solo. Cuando se envía sin `outputFormat`, el archivo se valida contra el `outputFormat` existente de la plantilla. - `outputFormat` no puede enviarse por sí solo. Enviar `outputFormat` sin un nuevo archivo `template` devuelve un error `400`. La respuesta puede incluir `warnings` cuando la validación de esquema no pudo validar completamente una o más fuentes de datos referenciadas por la nueva plantilla. La plantilla se actualiza de todas formas. ## OpenAPI ````yaml es/openapi/v3-current/reporter.yaml patch /v1/templates/{id} openapi: 3.1.0 info: contact: name: Discord community url: https://discord.gg/DnhqKwkGv3 description: >- Esta es la documentación OpenAPI de Reporter. El binario unificado de Reporter ejecuta la API REST (RUN_MODE=api), el worker de generación de informes de RabbitMQ (RUN_MODE=worker) o ambos; RUN_MODE=all ejecuta los dos en un único proceso para el desarrollo local. Todos los endpoints REST documentados aquí solo están disponibles cuando RUN_MODE=api o RUN_MODE=all (puerto :4005); el worker (puerto :4006) expone únicamente los endpoints de health y readyz. license: name: Lerian Studio General License title: Midaz Reporter API version: 4.0.0 servers: - url: http://localhost:4005 - url: https://localhost:4005 security: - BearerAuth: [] tags: - description: Instancias de informes generados y su ciclo de vida. name: Informes - description: Definiciones de informes reutilizables. name: Plantillas - description: Creación interactiva de plantillas de informes. name: Constructor de plantillas - description: Seguimiento de las fechas de vencimiento de informes programados. name: Plazos - description: Entradas configuradas que proporcionan datos a los informes. name: Fuentes de datos - description: Métricas agregadas de informes. name: Métricas - description: Catálogo publicado de eventos de negocio y políticas de entrega. name: Streaming paths: /v1/templates/{id}: patch: tags: - Plantillas summary: Actualizar una plantilla description: >- Utiliza este endpoint para actualizar una plantilla. La solicitud se envía como `multipart/form-data` y acepta actualizaciones parciales. - `description` puede actualizarse por sí solo. - `template` (el archivo `.tpl`) puede enviarse por sí solo. Cuando se envía sin `outputFormat`, el archivo se valida contra el `outputFormat` existente de la plantilla. - `outputFormat` no puede enviarse por sí solo. Enviar `outputFormat` sin un nuevo archivo `template` devuelve un error `400`. La respuesta puede incluir `warnings` cuando la validación de esquema no pudo validar completamente una o más fuentes de datos referenciadas por la nueva plantilla. La plantilla se actualiza de todas formas. operationId: updateTemplate parameters: - description: Identificador de la plantilla. example: 00000000-0000-0000-0000-000000000000 in: path name: id required: true schema: description: Identificador de la plantilla. type: string requestBody: content: multipart/form-data: schema: properties: description: description: Descripción breve de la plantilla. Opcional. examples: - Monthly financial report type: string outputFormat: description: >- Formato de salida generado por la nueva plantilla. Opcional. Solo se acepta junto con un nuevo archivo `template`. Enviar `outputFormat` sin `template` devuelve un error `400`. examples: - html type: string template: contentMediaType: application/octet-stream description: >- Nuevo archivo `.tpl`. Opcional. Cuando se envía sin `outputFormat`, el archivo se valida contra el `outputFormat` existente de la plantilla. examples: - monthly-report.tpl format: binary type: string type: object description: Formulario multipart de la plantilla. responses: '200': content: application/json: schema: $ref: '#/components/schemas/TemplateResponse' description: Correcto '400': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Solicitud incorrecta '401': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: No autorizado '403': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Prohibido '404': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: No encontrado '422': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Entidad no procesable '500': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error interno del servidor components: schemas: TemplateResponse: properties: createdAt: description: Marca de tiempo que indica cuándo se creó la plantilla. examples: - '2021-01-01T00:00:00Z' format: date-time type: string description: description: Descripción breve de la plantilla. Opcional. examples: - Monthly financial report type: string fileName: description: >- Nombre del archivo de plantilla tal como está guardado en el sistema. Sigue el formato `.tpl`. examples: - 0196159b-4f26-7300-b3d9-f4f68a7c85f3_1744119295.tpl type: string id: description: ID único que identifica la plantilla (formato UUID). examples: - 00000000-0000-0000-0000-000000000000 type: string outputFormat: description: Formato de salida generado (por ejemplo, HTML, CSV, PDF, TXT, XML). examples: - HTML type: string updatedAt: description: >- Marca de tiempo que indica la última vez que se actualizó la plantilla. examples: - '2021-01-01T00:00:00Z' format: date-time type: string warnings: description: >- Se devuelve cuando la validación de esquema no pudo validar completamente una o más fuentes de datos referenciadas por la plantilla. La operación de creación o actualización se completa de todas formas. Ausente cuando no se produjeron advertencias. examples: - - code: DATA_SOURCE_UNAVAILABLE field: account.balance message: data source is temporarily unavailable items: $ref: '#/components/schemas/ValidationWarning' type: - array - 'null' type: object Detail: properties: code: description: >- Código de error de dominio estable y legible por máquina, limitado al servicio emisor (formato: -NNNN). examples: - ERR-0001 type: string detail: description: Explicación legible específica de esta instancia del problema. examples: - Property foo is required but is missing. type: string errors: description: Lista opcional de detalles individuales del error examples: - - location: body.templateId message: expected string to match 'uuid' format value: not-a-uuid items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: Referencia URI que identifica la instancia específica del problema. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: Código de estado HTTP examples: - 400 format: int64 type: integer title: description: >- Resumen breve y legible del tipo de problema. Este valor no debe cambiar entre instancias del error. examples: - Bad Request type: string type: default: about:blank description: Referencia URI a la documentación legible del error. examples: - https://example.com/errors/example format: uri type: string type: object ValidationWarning: properties: code: description: Código de advertencia legible por máquina. examples: - DATA_SOURCE_UNAVAILABLE type: string field: description: >- Referencia al campo o a la fuente de datos afectada por la advertencia. examples: - customers.email type: string message: description: Descripción legible de la advertencia. examples: - Data source is temporarily unavailable. type: string type: object ErrorDetail: properties: location: description: >- Lugar donde ocurrió el error, por ejemplo, 'body.items[3].tags' o 'path.thing-id' examples: - body.templateId type: string message: description: Texto del mensaje de error examples: - expected string to match 'uuid' format type: string value: description: Valor en la ubicación indicada examples: - not-a-uuid type: object securitySchemes: BearerAuth: bearerFormat: JWT description: >- Autenticación mediante token Bearer. Formato: 'Bearer {access_token}'. Solo es obligatoria cuando el plugin de autenticación está habilitado. scheme: bearer type: http ````