> ## Documentation Index > Fetch the complete documentation index at: https://developers.tiendadepuntos.com/llms.txt > Use this file to discover all available pages before exploring further. # Actualizar un nivel > Reemplaza los datos de un nivel. **No es un patch**: los campos que no envíes se sobrescriben, así que mandá siempre el nivel completo. No se puede llevar `minPoints` a `0` en un nivel que no arrancó en `0` (el nivel base del comercio es el único que puede valer `0`), ni repetir los `minPoints` de otro nivel. ## OpenAPI ````yaml /api-reference/openapi.json put /external/levels/{id} openapi: 3.0.0 info: title: API de Tienda de Puntos description: >- API pública de Tienda de Puntos. Permite sumar puntos por compra, consultar clientes, validar canjes y consumir cupones desde tu POS, ERP o e-commerce. Todas las llamadas se autentican con el header `x-api-key`. version: 0.0.1 contact: {} servers: - url: https://api.tiendadepuntos.com description: Producción - url: https://apidev.tiendadepuntos.com description: Desarrollo security: - ApiKeyAuth: [] tags: [] paths: /external/levels/{id}: put: tags: - Niveles summary: Actualizar un nivel description: >- Reemplaza los datos de un nivel. **No es un patch**: los campos que no envíes se sobrescriben, así que mandá siempre el nivel completo. No se puede llevar `minPoints` a `0` en un nivel que no arrancó en `0` (el nivel base del comercio es el único que puede valer `0`), ni repetir los `minPoints` de otro nivel. operationId: ExternalLevelController_update parameters: - name: id required: true in: path description: ID del nivel en Tienda de Puntos. schema: type: integer example: 3 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateExternalLevelDto' responses: '200': description: Nivel actualizado. content: application/json: schema: type: object properties: success: type: boolean example: true status: type: integer example: 200 message: type: string example: Request was successful data: $ref: '#/components/schemas/ExternalLevelOutputDto' required: - success - status - message '400': description: El cuerpo o los parámetros no pasaron la validación. content: application/json: schema: type: object properties: statusCode: type: integer example: 400 timestamp: type: string format: date-time example: '2026-07-31T14:05:12.431Z' path: type: string example: /external/tags/add method: type: string example: POST message: type: string example: Error de validación errors: type: array nullable: true items: type: object data: type: object nullable: true '404': description: >- Falta el header `x-api-key` (`Api Key is required`) o la API key no corresponde a ningún comercio (`Business not found`). También se usa cuando el recurso pedido no existe. content: application/json: schema: type: object properties: statusCode: type: integer example: 404 timestamp: type: string format: date-time example: '2026-07-31T14:05:12.431Z' path: type: string example: /external/tags/add method: type: string example: POST message: type: string example: Api Key is required errors: type: array nullable: true items: type: object data: type: object nullable: true '409': description: >- Ya existe otro nivel del comercio con la misma cantidad de `minPoints`. content: application/json: schema: type: object properties: statusCode: type: integer example: 409 timestamp: type: string format: date-time example: '2026-07-31T14:05:12.431Z' path: type: string example: /external/tags/add method: type: string example: POST message: type: string example: >- Ya existe un nivel con la misma cantidad mínima de puntos necesarios. errors: type: array nullable: true items: type: object data: type: object nullable: true security: - ApiKeyAuth: [] components: schemas: UpdateExternalLevelDto: type: object properties: name: type: string description: Nombre del nivel. example: Nivel 2 description: type: string description: Descripción del nivel. example: Beneficios para clientes frecuentes. minPoints: type: number description: >- Puntos acumulados que necesita un cliente para alcanzar este nivel. No puede repetirse entre niveles del mismo comercio. example: 5000 pointsMultiplier: type: number description: >- Multiplicador de puntos de las compras de los clientes de este nivel. `1` es sin bonificación. example: 1.5 minimum: 1 colors: description: Colores con los que el nivel se muestra en la app del cliente. allOf: - $ref: '#/components/schemas/ExternalLevelColorsDto' required: - name - minPoints - pointsMultiplier - colors ExternalLevelOutputDto: type: object properties: id: type: number description: ID del nivel. example: 3 name: type: string description: Nombre del nivel. example: Nivel 2 description: type: string description: Descripción del nivel. example: Beneficios para clientes frecuentes. nullable: true minPoints: type: number description: Puntos acumulados que necesita un cliente para alcanzar este nivel. example: 5000 pointsMultiplier: type: number description: >- Multiplicador de puntos que se aplica a las compras de los clientes de este nivel. `1` significa sin bonificación. example: 1.5 colors: type: object description: Colores con los que el nivel se muestra en la app del cliente. example: primary: '#55ffff' secondary: '#abffff' border: '#000000' createdAt: format: date-time type: string example: '2026-02-14T12:30:00.000Z' updatedAt: format: date-time type: string example: '2026-06-01T09:15:00.000Z' required: - id - name - description - minPoints - pointsMultiplier - colors - createdAt - updatedAt ExternalLevelColorsDto: type: object properties: primary: type: string description: Color principal en hexadecimal. example: '#55FFFF' secondary: type: string description: Color secundario en hexadecimal. example: '#ABFFFF' border: type: string description: Color del borde en hexadecimal. example: '#000000' required: - primary - secondary - border securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- API key del comercio. Se genera desde el panel de Tienda de Puntos, en Configuración → Integraciones. ````