---
title: "Atualizar representante legal"
method: PATCH
path: "/clients/{onboarding_id}/legal_representatives/{legal_representative_id}"
---

# Atualizar representante legal

`PATCH /clients/{onboarding_id}/legal_representatives/{legal_representative_id}`

## Request

- Base URL: `https://pagamentos.grafeno.be/api/v2`
- URL: `https://pagamentos.grafeno.be/api/v2/clients/{onboarding_id}/legal_representatives/{legal_representative_id}`
- Auth: HTTP basic and API key in header `Authorization`
- TypeScript: <https://skmtc.dev/grafeno/apis/api-v2-grafeno/docs/clients/:onboarding_id/legal_representatives/:legal_representative_id/patch.ts> (a function with typed inputs; its response is checked against the schema)

Atualiza os dados de um representante legal para o onboarding.

## Path parameters

- `onboarding_id` string, required
- `legal_representative_id` string, required

## Request body

- object
  - `name` string: Nome completo do representante legal.
  - `email` string: E-Mail da empresa.
  - `phone` string: Telefone do representante legal.
  - `birthDate` string, date: Data de nascimento do representante legal.
  - `nationality` string: Código alpha-2 do país de origem do representante legal.
  - `maritalStatus` 'single' | 'married': Estado civil do representante legal.
  - `address` object: Endereço da empresa.
    - `street` string, required: Rua do endereço da empresa.
    - `number` string, required: Número do endereço da empresa.
    - `complement` string: Complemento do endereço da empresa.
    - `neighborhood` string, required: Bairro do endereço da empresa.
    - `city` string, required: Cidade do endereço da empresa.
    - `state` string, required: Estado do endereço da empresa.
    - `country` string, required: País do endereço da empresa. (código ALPHA-02).
    - `zipCode` string, required: CEP do endereço da empresa.
    - `proof` object: Comprovante de endereço.
      - `filename` string, required: Nome do arquivo (com extensão).
      - `content` string, required: Conteúdo do arquivo em Base64.
  - `pep` object: Informações sobre Pessoa Politicamente Exposta.
    - `kind` 'none' | 'primary' | 'secondary', required: Tipo de pep (Pessoa politicamente exposta).
    - `role` string, required: Cargo desempenhado pela pep. Obrigatório se o tipo for primary ou secondary.
    - `documentNumber` string: CPF da pep. Obrigatório se o tipo for secondary.
    - `name` string: Nome da pep. Obrigatório se o tipo for secondary.
  - `kind` 'administrator' | 'attorney': Tipo do representante legal.
  - `subscriberKind` 'required' | 'participate' | 'dont_subscribe': Tipo de assinatura.
  - `representationKind` 'in_isolation' | 'together': Tipo de representação.
  - `identityDocumentNumber` string: Número do RG ou RNE do representante legal.
  - `identityDocumentIssuingAgency` string: Órgão expedidor do RG ou RNE.
  - `identityDocument` object: RG ou RNE do representante legal.
    - `filename` string, required: Nome do arquivo (com extensão),
    - `content` string, required: Conteúdo do arquivo em Base64.
  - `proofOfPowerDueDate` string: Validade do documento de comprovação de poderes.
  - `proofOfPower` object: Documento de comprovação de poderes.
    - `filename` string, required: Nome do arquivo (com extensão).
    - `content` string, required: Conteúdo do arquivo em Base64.
  - `extraAttachments` object[]: Documentos extras do representante legal.
    - `filename` string, required: Nome do arquivo (com extensão).
    - `content` string, required: Conteúdo do arquivo em Base64.

## Response `200`

200

- object
  - `data` object
    - `id` string
    - `type` string
    - `attributes` object
      - `name` string
      - `birthDate` string
      - `nationality` string
      - `identityDocumentNumber` string
      - `identityDocumentIssuingAgency` string
      - `maritalStatus` string
      - `email` string
      - `phone` string
      - `kind` string
      - `subscriberKind` string
      - `representationKind` string
      - `proofOfPowerDueDate` unknown
      - `createdAt` string
      - `updatedAt` string
      - `identityDocument` object
        - `data` object
          - `id` string
          - `type` string
          - `attributes` object
            - `filename` string
            - `content` string
      - `proofOfPower` object
        - `data` object
          - `id` string
          - `type` string
          - `attributes` object
            - `filename` string
            - `content` string
      - `extraAttachments` unknown
      - `address` object
        - `data` object
          - `id` unknown
          - `type` string
          - `attributes` object
            - `zipCode` string
            - `street` string
            - `number` string
            - `complement` string
            - `country` string
            - `state` string
            - `city` string
            - `neighborhood` string
      - `pep` object
        - `data` object
          - `id` unknown
          - `type` string
          - `attributes` object
            - `kind` string
            - `role` unknown
            - `documentNumber` unknown
            - `name` unknown

## Other responses

- `404`: 404
- `422`: 422

---

[API](https://skmtc.dev/grafeno/apis/api-v2-grafeno.md) - [All operations](https://skmtc.dev/grafeno/apis/api-v2-grafeno/llms.txt) - [OpenAPI document](https://skmtc.dev/grafeno/apis/api-v2-grafeno/revisions/20f928f6933f?raw)