---
title: "Criar um projeto"
method: POST
path: "/api/management/projects"
tags: ["projects"]
---

# Criar um projeto

`POST /api/management/projects`

Cria um novo projeto com os dados fornecidos.

## Request body

- object — Dados para criação ou atualização de um projeto
  - `name` string, required — Nome do projeto. Campo obrigatório na criação, máximo de 191 caracteres.
  - `description` string — Descrição detalhada do projeto. Campo opcional que permite fornecer informações adicionais sobre o projeto.
  - `impact` integer — Nível de impacto do projeto em uma escala de 1 a 10.
  - `contact_id` string, uuid — ID único (UUID) do contato associado ao projeto. Campo opcional que permite vincular um contato específico ao projeto.
  - `customer_id` string, uuid — ID único (UUID) do cliente associado ao projeto. Campo opcional que permite vincular um cliente específico ao projeto.
  - `status` 1 | 2 | 3 | 4 — Status atual do projeto. Valores possíveis: 1 (Em execução), 2 (Concluído), 3 (Arquivado), 4 (Parado).
  - `budget` number, float — Receita esperada do projeto em valor numérico decimal. Campo opcional que permite definir a receita esperada para o projeto. Valor mínimo: 0, máximo: 999999999999.99.
  - `is_template` boolean — Indica se o projeto é um modelo de projeto. Quando true, o projeto pode ser usado como base para criação de outros projetos.
  - `form_answers` object[] — Array de objetos contendo as respostas de formulários dinâmicos associados ao projeto. Cada objeto contém os dados das respostas dos campos do formulário.
  - `forecast_dates` object[] — Array de objetos para definir datas de previsão por funil. Permite associar diferentes datas de previsão a diferentes funis de projeto.
    - `date` string, date — Data de previsão para o funil de projeto.
    - `project_funnel_id` integer, required — ID do funil de projeto ao qual esta data de previsão está associada.
  - `groups` object — Objeto para gerenciar grupos associados ao projeto. Contém arrays 'to_add' e 'to_rem' para adicionar ou remover grupos.
    - `to_add` string[], required — Array de UUIDs dos grupos a serem adicionados ao projeto. Permite associar o projeto a um ou mais grupos.
    - `to_rem` string[], required — Array de UUIDs dos grupos a serem removidos do projeto. Permite desassociar o projeto de grupos específicos.
  - `tags` object — Objeto para gerenciar etiquetas de funil associadas ao projeto. Contém arrays 'to_add' e 'to_rem' para adicionar ou remover etiquetas do projeto.
    - `to_add` integer[], required — Array de IDs das etiquetas a serem adicionadas ao projeto.
    - `to_rem` integer[], required — Array de IDs das etiquetas a serem removidas do projeto.
  - `funnels` object — Objeto para gerenciar funis que o projeto está vinculado. Contém arrays 'to_add' e 'to_rem' para adicionar ou remover funis.
    - `to_add` integer[], required — Array de IDs dos funis de projeto a serem adicionados ao projeto.
    - `to_rem` integer[], required — Array de IDs dos funis de projeto a serem removidos do projeto.
  - `funnel_status` object — Objeto para vincular ou desvincular um status de funil do projeto.
    - `project_funnel_id` integer, required — ID do funil de projeto ao qual o status será aplicado.
    - `funnel_status_id` integer — ID do status de funil que será atribuído ao projeto dentro do funil especificado.
  - `prefix` string — Prefixo para o código do projeto. Quando fornecido, será usado na geração automática do código do projeto (ex: 'PRJ-001').
  - `users` object[] — Array de objetos para gerenciar usuários associados ao projeto.
    - `user_id` string, uuid, required — ID único (UUID) do usuário a ser associado ou removido do projeto. Campo obrigatório dentro do objeto users.
    - `role` string, required — Papel do usuário no projeto. Valores possíveis: 'creator', 'assignee', 'follower'.
    - `action` string, required — Ação a ser executada com o usuário. Valores possíveis: 'add' (Adicionar usuário ao projeto), 'remove' (Remover usuário do projeto).
  - `childrens` object — Objeto para gerenciar projetos filhos associados ao projeto. Contém arrays 'to_add' e 'to_rem' para adicionar ou remover projetos filhos.
    - `to_add` string[], required — Array de UUIDs dos projetos filhos a serem adicionados ao projeto. Permite criar uma hierarquia de projetos.
    - `to_rem` string[], required — Array de UUIDs dos projetos filhos a serem removidos do projeto.
  - `parent_id` string, uuid, nullable — ID do projeto pai na hierarquia. Quando null, o projeto fica na raiz.

## Response `200`

Sucesso

- object
  - `response` boolean
  - `project` object
    - `frame_id` string
    - `status` integer
    - `impact` integer
    - `description` string
    - `name` string
    - `budget` integer
    - `is_template` boolean
    - `code` string
    - `id` string
    - `created_by` string
    - `updated_at` string, date-time
    - `created_at` string, date-time
    - `frame` object
      - `id` string
      - `name` string
      - `type` integer
      - `status` integer
      - `subdomain` string
      - `cockpit_access` integer
    - `form_answers` object[]
      - `id` integer
      - `label` string
      - `answer` string
      - `model` string
      - `answered_by` string
      - `updated_at` string, date-time

## Other responses

- `401` — Não autorizado
- `422` — Erro de validação

---

[API](https://skmtc.net/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.net/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/olie-ai/olie-api/versions/4859f7ec8b64/schema)