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

# Atualizar limite de transacao

> Modifica os limites de transacao de uma conta. Especifique o tipo de periodo (DAILY, NIGHTLY, MONTHLY, YEARLY)
e o tipo de limite (DEBIT para saida ou CREDIT para entrada) para atualizar o valor do limite correspondente.




## OpenAPI

````yaml pt/openapi/v3-current/pix.yaml PATCH /v1/limits
openapi: 3.0.3
info:
  title: Plugin BR Pix Direct - API Completa
  description: >
    API completa para o sistema de pagamentos instantaneos PIX brasileiro,
    incluindo

    operacoes de dicionario de chaves PIX, geracao/decodificacao de QR codes,
    transacoes e

    limites de transacao.
  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:
        - API de Limites de Transacao
      summary: Atualizar limite de transacao
      description: >
        Modifica os limites de transacao de uma conta. Especifique o tipo de
        periodo (DAILY, NIGHTLY, MONTHLY, YEARLY)

        e o tipo de limite (DEBIT para saida ou CREDIT para entrada) para
        atualizar o valor do limite correspondente.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateLimitRequest'
            examples:
              daily_debit_limit:
                summary: Atualizar limite diario de debito/saida
                value:
                  accountId: 019c96a0-0c0c-7221-8cf3-13313fb60081
                  amount: 10000
                  periodType: DAILY
                  limitType: DEBIT
              monthly_credit_limit:
                summary: Atualizar limite mensal de credito/entrada
                value:
                  accountId: 019c96a0-0c0c-7221-8cf3-13313fb60081
                  amount: 50000
                  periodType: MONTHLY
                  limitType: CREDIT
              nightly_debit_limit:
                summary: Atualizar limite noturno de debito (20h - 6h)
                value:
                  accountId: 019c96a0-0c0c-7221-8cf3-13313fb60081
                  amount: 1000
                  periodType: NIGHTLY
                  limitType: DEBIT
      responses:
        '200':
          description: Limite atualizado
          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 da conta para a qual o limite esta sendo definido.
          format: uuid
          example: 019c96a0-0c0c-7221-8cf3-13313fb60081
        amount:
          type: number
          description: Novo valor do limite.
          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 unico do limite.
          example: limit_123
        accountId:
          type: string
          description: Identificador da conta associada ao limite.
          example: acc_123456789
        transactionType:
          type: string
          description: 'Tipo de transacao em string: TED, DOC, PIX, etc.'
          example: PIX
        periodType:
          $ref: '#/components/schemas/PeriodTypeEnum'
        limitType:
          $ref: '#/components/schemas/LimitTypeEnum'
        amount:
          type: number
          description: Valor do limite.
          format: double
          example: 5000
        createdAt:
          type: string
          description: Data e hora de criacao do limite.
          format: date-time
          example: '2023-06-01T00:00:00Z'
        updatedAt:
          type: string
          description: Data e hora da ultima atualizacao do limite.
          format: date-time
          example: '2023-06-01T00:00:00Z'
    PeriodTypeEnum:
      type: string
      description: >
        Tipo de periodo do limite de transacao. Valores string que definem o
        periodo de tempo para o qual os limites de transacao se aplicam.


        **Valores validos:**

        - `DAILY` = Limite diario (reinicia todo dia a meia-noite)

        - `NIGHTLY` = Limite do periodo noturno (normalmente das 20h as 6h
        conforme regulamentacao bancaria brasileira)

        - `MONTHLY` = Limite mensal (reinicia no primeiro dia de cada mes)

        - `YEARLY` = Limite anual (reinicia em 1 de janeiro de cada ano)
      enum:
        - DAILY
        - NIGHTLY
        - MONTHLY
        - YEARLY
      example: DAILY
    LimitTypeEnum:
      type: string
      description: >
        Tipo de direcao do limite de transacao. Valores string que especificam
        se o limite se aplica a transacoes de entrada ou saida.


        **Valores validos:**

        - `DEBIT` = Limite de transacoes de saida (dinheiro saindo da conta)

        - `CREDIT` = Limite de transacoes de entrada (dinheiro entrando na
        conta)
      enum:
        - DEBIT
        - CREDIT
      example: DEBIT
    ErrorResponse:
      type: object
      properties:
        code:
          type: string
          description: Codigo do erro
        message:
          type: string
          description: Mensagem de erro
        details:
          type: array
          items:
            type: string
          description: Detalhes adicionais do erro
  responses:
    BadRequest:
      description: Requisicao Invalida - Parametros invalidos
      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: Nao Autorizado - Autenticacao invalida ou 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: Erro Interno do 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: >
        Autenticacao por token JWT Bearer. Obtenha o token no endpoint
        `/v1/login/oauth/access_token`

        usando credenciais do cliente (clientId e clientSecret).


        Inclua o token no header Authorization:

        `Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`


        O token expira apos 3600 segundos (1 hora).

````