v61

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-011950982.7 KB

projects

{id}

Editar um projeto

Atualiza os dados de um projeto existente.

put/api/management/projects/{id}

Request body

namestring

Nome do projeto. Campo opcional na atualização, máximo de 191 caracteres.

descriptionstring

Descrição detalhada do projeto. Campo opcional que permite atualizar as informações adicionais sobre o projeto.

impactinteger

Nível de impacto do projeto em uma escala de 1 a 10.

contact_idstring uuid

ID único (UUID) do contato associado ao projeto. Campo opcional que permite atualizar ou vincular um contato específico ao projeto.

customer_idstring uuid

ID único (UUID) do cliente associado ao projeto. Campo opcional que permite atualizar ou vincular um cliente específico ao projeto.

status1 | 2 | 3 | 4

Status atual do projeto. Valores possíveis: 1 (Em execução), 2 (Concluído), 3 (Arquivado), 4 (Parado).

budgetnumber float

Receita esperada do projeto em valor numérico decimal. Campo opcional que permite atualizar a receita esperada para o projeto.

is_templateboolean

Indica se o projeto é um modelo de projeto. Quando true, o projeto pode ser usado como base para criação de outros projetos.

form_answersobject[]

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.

groupsobject

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.

parent_idstring uuid nullable

ID do projeto pai na hierarquia. Quando null, o projeto fica na raiz.

Example request

{
  "name": "Projeto Atualizado",
  "description": "Nova descrição do projeto",
  "impact": 8,
  "contact_id": "uuid-do-contato",
  "customer_id": "uuid-do-cliente",
  "status": 2,
  "budget": 35000.5,
  "forecast_dates": [
    {
      "date": "2025-08-01",
      "project_funnel_id": 4
    }
  ],
  "funnel_status": {
    "project_funnel_id": 5,
    "funnel_status_id": 3
  },
  "users": [
    {
      "user_id": "uuid-do-usuario",
      "role": "assignee",
      "action": "remove"
    }
  ],
  "parent_id": "550e8400-e29b-41d4-a716-446655440000"
}

Response

Editado com sucesso

responseboolean