---
title: "Editar um projeto"
method: PUT
path: "/api/management/projects/{id}"
tags: ["projects", "{id}"]
---

# Editar um projeto

`PUT /api/management/projects/{id}`

Atualiza os dados de um projeto existente.

## Request body

- object — Dados para atualização de um projeto
  - `name` string — Nome do projeto. Campo opcional na atualização, máximo de 191 caracteres.
  - `description` string — Descrição detalhada do projeto. Campo opcional que permite atualizar as 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 atualizar ou vincular um contato específico ao projeto.
  - `customer_id` string, uuid — ID único (UUID) do cliente associado ao projeto. Campo opcional que permite atualizar ou 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 atualizar a receita esperada para o projeto.
  - `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. Permite atualizar as respostas dos formulários.
  - `forecast_dates` object[] — Array de objetos para atualizar datas de previsão por funil. Permite atualizar ou remover datas de previsão de diferentes funis de projeto.
    - `date` string, date — Data de previsão para o funil de projeto. Pode ser null para remover a data de previsão.
    - `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. Ambos os arrays devem estar presentes quando este campo for fornecido.
  - `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. Ambos os arrays devem estar presentes quando este campo for fornecido.
    - `to_add` integer[], required — Array de IDs das etiquetas dos funis de projeto serem adicionados ao projeto.
    - `to_rem` integer[], required — Array de IDs das etiquetas dos funis de projeto 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. Ambos os arrays devem estar presentes quando este campo for fornecido.
    - `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.
  - `users` object[] — Array de objetos para gerenciar usuários associados ao projeto. Permite adicionar ou remover usuários com diferentes papéis do projeto.
    - `user_id` string, uuid, required — ID único (UUID) do usuário a ser associado ou removido do projeto.
    - `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).
  - `parent_id` string, uuid, nullable — ID do projeto pai na hierarquia. Quando null, o projeto fica na raiz.

## Response `200`

Editado com sucesso

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

## Other responses

- `401` — Não autorizado
- `404` — Model não encontrada
- `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)