> ## 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 um Titular ## OpenAPI ````yaml pt/openapi/v3-current/ledger.yaml patch /v1/organizations/{organization_id}/holders/{holder_id} openapi: 3.1.0 info: title: API Midaz Ledger description: >- Referência completa da API para serviços do Midaz Ledger incluindo gerenciamento de organizações, operações de ledger, ativos, segmentos, portfolios, contas, tipos de conta, transações, operações, saldos, rotas de operação, rotas de transação e índices de metadata. version: 3.7.8 servers: - url: https://ledger.sandbox.lerian.net security: [] tags: - name: API de Organizações - name: API de Ledgers - name: API de Ativos - name: API de Segmentos - name: API de Portfolios - name: API de Tipos de Conta - name: API de Contas - name: API de Saldos - name: API de Transações - name: API de Operações - name: API de Rotas de Operação - name: API de Rotas de Transação - name: API de Índices de Metadata - name: API de Titulares - name: API de Instrumentos - name: API de Pacotes de Cobrança - name: API de Pacotes - name: API de Cálculo de Cobrança - name: API de Estimativa - name: API de Criptografia - name: API de Proteção - name: API de Taxas de Ativos paths: /v1/organizations/{organization_id}/holders/{holder_id}: patch: tags: - API de Titulares summary: Atualizar um Titular parameters: - $ref: '#/components/parameters/OrganizationId' - name: holder_id in: path required: true description: ID do titular (UUID) schema: type: string - $ref: '#/components/parameters/ContentType' - $ref: '#/components/parameters/XRequestId' - $ref: '#/components/parameters/Authorization' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/Holder' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/Holder' default: description: Erro content: application/problem+json: schema: $ref: '#/components/schemas/Error' components: parameters: OrganizationId: name: organization_id in: path description: O identificador único da Organização associada ao Ledger. required: true example: 019c96a0-0a98-7287-9a31-786e0809c769 schema: type: string format: uuid ContentType: name: Content-Type in: header description: O tipo de mídia do recurso. O valor recomendado é `application/json`. required: false example: application/json schema: type: string XRequestId: name: X-Request-Id in: header description: >- Um identificador único utilizado para rastrear e acompanhar cada requisição. required: false example: 019c96a0-0a98-7287-9a31-786e0809c769 schema: type: string format: uuid Authorization: name: Authorization in: header required: false schema: type: string description: > Token JWT bearer para autenticação. Obrigatório quando `PLUGIN_AUTH_ENABLED=true` (exigido em implantações multi-tenant). Opcional no modo OSS single-tenant padrão. Formato: `Bearer ` schemas: Holder: additionalProperties: false properties: addresses: $ref: '#/components/schemas/Addresses' contact: $ref: '#/components/schemas/Contact' createdAt: examples: - '2025-01-01T00:00:00Z' format: date-time type: string deletedAt: examples: - '2025-01-01T00:00:00Z' format: date-time type: - string - 'null' document: examples: - '91315026015' maxLength: 100 type: string externalId: examples: - G4K7N8M2 maxLength: 256 type: string id: examples: - 00000000-0000-0000-0000-000000000000 format: uuid type: string legalPerson: $ref: '#/components/schemas/LegalPerson' metadata: additionalProperties: {} type: object name: examples: - John Doe maxLength: 256 type: string naturalPerson: $ref: '#/components/schemas/NaturalPerson' type: examples: - NATURAL_PERSON maxLength: 100 type: string updatedAt: examples: - '2025-01-01T00:00:00Z' format: date-time type: string required: - createdAt - updatedAt - deletedAt type: object Error: additionalProperties: false properties: code: description: >- Código de erro de domínio estável e legível por máquina, com escopo no serviço emissor (formato: -NNNN). examples: - ERR-0001 type: string detail: description: >- Uma explicação legível por humanos específica para esta ocorrência do problema. examples: - Property foo is required but is missing. type: string errors: description: Lista opcional de detalhes de erro individuais items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- Uma referência de URI que identifica a ocorrência específica do problema. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: Código de status HTTP examples: - 400 format: int64 type: integer title: description: >- Um resumo curto e legível por humanos do tipo de problema. Este valor não deve mudar entre ocorrências do erro. examples: - Bad Request type: string type: default: about:blank description: >- Uma referência de URI para a documentação legível por humanos do erro. examples: - https://example.com/errors/example format: uri type: string type: object Addresses: additionalProperties: false properties: additional1: $ref: '#/components/schemas/Address' additional2: $ref: '#/components/schemas/Address' primary: $ref: '#/components/schemas/Address' type: object Contact: additionalProperties: false properties: mobilePhone: examples: - '+1555555555' maxLength: 32 type: string otherPhone: examples: - '+1555555555' maxLength: 32 type: string primaryEmail: examples: - john.doe@example.com maxLength: 256 type: string secondaryEmail: examples: - john.doe@example.com maxLength: 256 type: string type: object LegalPerson: additionalProperties: false properties: activity: examples: - Electronic devices development maxLength: 256 type: string foundingDate: examples: - '2025-01-01' format: date type: string representative: $ref: '#/components/schemas/Representative' size: examples: - Medium maxLength: 100 type: string status: examples: - Active maxLength: 100 type: string tradeName: examples: - Lerian Studio maxLength: 256 type: string type: examples: - Limited Liability maxLength: 100 type: string type: object NaturalPerson: additionalProperties: false properties: birthDate: examples: - '1990-01-01' format: date type: string civilStatus: examples: - Single maxLength: 100 type: string fatherName: examples: - John Doe maxLength: 256 type: string favoriteName: examples: - John maxLength: 256 type: string gender: examples: - Male maxLength: 100 type: string motherName: examples: - Jane Doe maxLength: 256 type: string nationality: examples: - Brazilian maxLength: 100 type: string socialName: examples: - John Doe maxLength: 256 type: string status: examples: - Active maxLength: 100 type: string type: object ErrorDetail: additionalProperties: false properties: location: description: >- Onde o erro ocorreu, por exemplo 'body.items[3].tags' ou 'path.thing-id' type: string message: description: Texto da mensagem de erro type: string value: description: O valor na localização informada type: object Address: additionalProperties: false properties: city: examples: - New York maxLength: 100 type: string country: examples: - US maxLength: 2 minLength: 2 type: string description: examples: - Home maxLength: 100 type: string line1: examples: - 123 Financial Avenue maxLength: 256 type: string line2: examples: - Suite 1500 maxLength: 256 type: - string - 'null' state: examples: - NY maxLength: 100 type: string zipCode: examples: - '10001' maxLength: 20 type: string required: - line1 - line2 - zipCode - city - state - country type: object Representative: additionalProperties: false properties: document: examples: - '91315026015' maxLength: 100 type: string email: examples: - john.doe@example.com maxLength: 256 type: string name: examples: - John Doe maxLength: 256 type: string role: examples: - CFO maxLength: 100 type: string type: object ````