---
title: "Atualizar uma área de negócio"
method: PUT
path: "/api/management/business-areas/{business_area}"
tags: ["business-areas"]
---

# Atualizar uma área de negócio

`PUT /api/management/business-areas/{business_area}`

Renomeia uma área de negócio. O identificador efetivamente usado é o `id` enviado no corpo — repita nele o mesmo valor colocado na URL. O novo nome precisa ser único na empresa, considerando também as áreas arquivadas.

## Request body

- object — Novos dados da área de negócio. Ambos os campos são exigidos pelo endpoint.
  - `id` integer, required — Identificador da área de negócio a ser atualizada; é este valor, e não o da URL, que determina o registro alterado. Obrigatório.
  - `name` string, required — Novo nome da área. Precisa ser único na empresa, inclusive entre as áreas arquivadas. Obrigatório.

## Response `200`

Sucesso

- object — Área de negócio após a atualização.
  - `response` boolean — Indica que a requisição foi concluída com sucesso. Sempre `true`.
  - `business_area` object — Área de negócio.
    - `id` integer — Identificador numérico da área de negócio.
    - `name` string — Nome da área de negócio.
    - `order` integer — Posição da área na listagem, começando em zero.
    - `frame_id` integer — Identificador interno da empresa proprietária da área.
    - `deleted_at` string, date-time, nullable — Data e hora do arquivamento, ou `null` quando a área está ativa.

## Other responses

- `404` — Não encontrado
- `422` — Nome já utilizado

## Changes

- **2026-09-22** `d71b18b1685d` — 3 breaking, 1 info
  - added the new required request property `id`
  - the request property `name` became required
  - the `name` request property's minLength was increased from `0` to `1`
  - added the optional property `business_area/deleted_at` to the response with the `200` status
- **2026-09-22** `b43a04f35145` — 2 warning
  - removed the request property `id`
  - removed the optional property `business_area/deleted_at` from the response with the `200` status
- **2026-09-18** `626cc36dd5e6` — 4 info
  - added optional request body
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `404`
  - added the non-success response with the status `422`

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/business-areas/:business_area/put.md)

---

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