---
title: "Update an organization"
method: PATCH
path: "/v1/organizations/{id}"
tags: ["v1Organizations"]
---

# Update an organization

`PATCH /v1/organizations/{id}`

Atualiza os campos enviados. `customFields` é mesclado com os campos já salvos. Organizações excluídas não podem ser alteradas.

## Path parameters

- `id` number, required

## Request body

- UpdateOrganizationPublicDto
  - `name` string — Nome da organização / nome fantasia
  - `legalName` string, nullable — Razão social
  - `avatar` string, nullable — Logo da organização (arquivo enviado pelo upload do Kinbox)
  - `cnpj` string, nullable — CNPJ (salvo sem pontuação)
  - `website` string, nullable — Site da organização
  - `phone` string, nullable — Telefone da organização
  - `email` string, nullable — E-mail da organização
  - `address` OrganizationAddress
    - `street` string
    - `number` string
    - `complement` string
    - `district` string
    - `city` string
    - `state` string
    - `zip` string
    - `country` string
  - `segment` string, nullable — Segmento / setor de atuação
  - `description` string, nullable — Descrição / observações
  - `customFields` object, nullable — Campos personalizados no formato { placeholder: { value } }
  - `operatorId` number, nullable — ID do usuário responsável pela organização

## Response `200`

- OrganizationPublicDto
  - `name` string, required — Nome da organização / nome fantasia
  - `legalName` string, nullable — Razão social
  - `avatar` string, nullable — Logo da organização (arquivo enviado pelo upload do Kinbox)
  - `cnpj` string, nullable — CNPJ (salvo sem pontuação)
  - `website` string, nullable — Site da organização
  - `domain` string, nullable — Domínio normalizado, derivado automaticamente do site
  - `phone` string, nullable — Telefone da organização
  - `email` string, nullable — E-mail da organização
  - `address` OrganizationAddress
    - `street` string
    - `number` string
    - `complement` string
    - `district` string
    - `city` string
    - `state` string
    - `zip` string
    - `country` string
  - `segment` string, nullable — Segmento / setor de atuação
  - `description` string, nullable — Descrição / observações
  - `customFields` object, nullable — Campos personalizados no formato { placeholder: { value } }
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `deletedAt` string, date-time, nullable — Preenchido quando a organização foi excluída (exclusão lógica)
  - `contactsCount` number — Quantidade de contatos vinculados
  - `id` number, required — ID da organização
  - `workspaceId` number, required — ID do workspace
  - `operatorId` number, nullable — ID do usuário responsável pela organização

## Changes

- **2026-10-01** `c083bbfe8973` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/kinbox/apis/kinbox-api/changes/v1/organizations/:id/patch.md)

---

[API](https://skmtc.dev/kinbox/apis/kinbox-api.md) · [All operations](https://skmtc.dev/kinbox/apis/kinbox-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kinbox/apis/kinbox-api/revisions/c083bbfe8973?raw)