> ## 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 límite de transacción > Modifica los límites de transacción de una cuenta. Especifica el tipo de periodo (DAILY, NIGHTLY, MONTHLY, YEARLY) y el tipo de límite (DEBIT para salidas o CREDIT para entradas) para actualizar el monto correspondiente. ## OpenAPI ````yaml es/openapi/v3-current/pix.yaml PATCH /v1/limits openapi: 3.0.3 info: title: Plugin BR Pix Directo - API completa description: > API completa para el sistema de pagos instantáneos Pix de Brasil, que incluye operaciones del diccionario de claves Pix, generación/decodificación de códigos QR, transacciones y límites transaccionales. version: 1.0.0 servers: - url: https://plugin-pix-direct.api.lerian.net - url: https://plugin-pix-direct-qrcode.api.lerian.net security: - bearerAuth: [] paths: /v1/limits: patch: tags: - Transaction Limits API summary: Actualizar límite de transacción description: > Modifica los límites de transacción de una cuenta. Especifica el tipo de periodo (DAILY, NIGHTLY, MONTHLY, YEARLY) y el tipo de límite (DEBIT para salidas o CREDIT para entradas) para actualizar el monto correspondiente. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateLimitRequest' examples: daily_debit_limit: summary: Actualizar límite diario de débito/salida value: accountId: 019c96a0-0c0c-7221-8cf3-13313fb60081 amount: 10000 periodType: DAILY limitType: DEBIT monthly_credit_limit: summary: Actualizar límite mensual de crédito/entrada value: accountId: 019c96a0-0c0c-7221-8cf3-13313fb60081 amount: 50000 periodType: MONTHLY limitType: CREDIT nightly_debit_limit: summary: Actualizar límite nocturno de débito (20:00 - 6:00) value: accountId: 019c96a0-0c0c-7221-8cf3-13313fb60081 amount: 1000 periodType: NIGHTLY limitType: DEBIT responses: '200': description: Límite actualizado content: application/json: schema: $ref: '#/components/schemas/TransactionLimit' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '500': $ref: '#/components/responses/InternalServerError' components: schemas: UpdateLimitRequest: type: object required: - accountId - amount - periodType - limitType properties: accountId: type: string description: Identificador de la cuenta para la cual se establece el límite. format: uuid example: 019c96a0-0c0c-7221-8cf3-13313fb60081 amount: type: number description: Nuevo monto del límite. format: double example: 10000 periodType: $ref: '#/components/schemas/PeriodTypeEnum' limitType: $ref: '#/components/schemas/LimitTypeEnum' TransactionLimit: type: object required: - id - accountId - transactionType - periodType - limitType - amount - createdAt - updatedAt properties: id: type: string description: Identificador único del límite. example: limit_123 accountId: type: string description: Identificador de la cuenta asociada con el límite. example: acc_123456789 transactionType: type: string description: 'Cadena del tipo de transacción: TED, DOC, PIX, etc.' example: PIX periodType: $ref: '#/components/schemas/PeriodTypeEnum' limitType: $ref: '#/components/schemas/LimitTypeEnum' amount: type: number description: Monto del límite. format: double example: 5000 createdAt: type: string description: Marca de tiempo de creación del límite. format: date-time example: '2023-06-01T00:00:00Z' updatedAt: type: string description: Marca de tiempo de la última actualización del límite. format: date-time example: '2023-06-01T00:00:00Z' PeriodTypeEnum: type: string description: > Tipo de periodo del límite de transacción. Valores en texto que definen el periodo de tiempo al que aplican los límites. **Valores válidos:** - `DAILY` = Límite diario (se restablece cada día a medianoche) - `NIGHTLY` = Límite nocturno (generalmente de 20:00 a 6:00, según la regulación bancaria brasileña) - `MONTHLY` = Límite mensual (se restablece el primer día de cada mes) - `YEARLY` = Límite anual (se restablece el 1 de enero de cada año) enum: - DAILY - NIGHTLY - MONTHLY - YEARLY example: DAILY LimitTypeEnum: type: string description: > Tipo de dirección del límite de transacción. Valores en texto que especifican si el límite aplica a transacciones entrantes o salientes. **Valores válidos:** - `DEBIT` = Límite de transacciones salientes (dinero que sale de la cuenta) - `CREDIT` = Límite de transacciones entrantes (dinero que entra a la cuenta) enum: - DEBIT - CREDIT example: DEBIT ErrorResponse: type: object properties: code: type: string description: Código de error message: type: string description: Mensaje de error details: type: array items: type: string description: Detalles adicionales del error responses: BadRequest: description: Solicitud Incorrecta - Parámetros inválidos content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_key_type: summary: Invalid key type value: code: INVALID_KEY_TYPE message: Key type must be between 0 and 4 details: - 'keyType: must be one of [0, 1, 2, 3, 4]' missing_required_field: summary: Missing required field value: code: VALIDATION_ERROR message: Required field is missing details: - 'accountId: field is required' invalid_document_format: summary: Invalid document format value: code: INVALID_DOCUMENT message: Document must be valid CPF (11 digits) or CNPJ (14 digits) details: - 'document: must match pattern ^\d{11}$|^\d{14}$' invalid_phone_format: summary: Invalid phone format value: code: INVALID_PHONE message: Phone must be in Brazilian format details: - 'phone: must match pattern ^\+55\d{2}\d{8,9}$' Unauthorized: description: No Autorizado - Autenticación inválida o ausente content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missing_token: summary: Missing authentication token value: code: MISSING_TOKEN message: Authorization header is required details: [] invalid_token: summary: Invalid token value: code: INVALID_TOKEN message: Invalid or expired access token details: [] expired_token: summary: Expired token value: code: TOKEN_EXPIRED message: Access token has expired. Please obtain a new token. details: [] InternalServerError: description: Error Interno del Servidor content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: generic_error: summary: Generic internal error value: code: INTERNAL_ERROR message: An internal error occurred. Please try again later. details: [] database_error: summary: Database error value: code: DATABASE_ERROR message: Database operation failed details: [] external_service_error: summary: External service error value: code: EXTERNAL_SERVICE_ERROR message: External service (JD PIX) is temporarily unavailable details: [] securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: > Autenticación con token JWT Bearer. Obtén el token desde el endpoint `/v1/login/oauth/access_token` usando credenciales de cliente (`clientId` y `clientSecret`). Incluye el token en el encabezado Authorization: `Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...` El token expira después de 3600 segundos (1 hora). ````