---
title: "Criar uma área de negócio"
method: POST
path: "/api/management/business-areas"
tags: ["business-areas"]
---

# Criar uma área de negócio

`POST /api/management/business-areas`

Cria uma área de negócio, usada para agrupar funis de projeto. O nome precisa ser único na empresa e a verificação inclui as áreas arquivadas, então reaproveitar o nome de uma área arquivada é recusado. A área nasce na posição 0 da ordenação; use a reordenação para definir onde ela aparece na lista.

## Request body

- object — Dados da área de negócio a ser criada.
  - `name` string, required — Nome da área de negócio. Precisa ser único na empresa, inclusive entre as áreas arquivadas.

## Response `200`

Sucesso

- object — Área de negócio recém-criada.
  - `response` boolean — Indica que a requisição foi concluída com sucesso. Sempre `true`.
  - `business_area` object — Área de negócio.
    - `name` string — Nome da área de negócio.
    - `frame_id` integer — Identificador interno da empresa proprietária da área.
    - `id` integer — Identificador numérico da área de negócio.

## Other responses

- `422` — Nome já utilizado

## Changes

- **2026-09-22** `d71b18b1685d` — 2 breaking
  - the request property `name` became required
  - the `name` request property's minLength was increased from `0` to `1`
- **2026-09-18** `626cc36dd5e6` — 3 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 `422`

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/business-areas/post.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)