v61

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

projects

Criar um projeto

Cria um novo projeto com os dados fornecidos.

post/api/management/projects

Request body

namestring required

Nome do projeto. Campo obrigatório na criação, máximo de 191 caracteres.

descriptionstring

Descrição detalhada do projeto. Campo opcional que permite fornecer 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 vincular um contato específico ao projeto.

customer_idstring uuid

ID único (UUID) do cliente associado ao projeto. Campo opcional que permite 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 definir a receita esperada para o projeto. Valor mínimo: 0, máximo: 999999999999.99.

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.

prefixstring

Prefixo para o código do projeto. Quando fornecido, será usado na geração automática do código do projeto (ex: 'PRJ-001').

parent_idstring uuid nullable

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

Example request

{
  "name": "Novo Projeto",
  "description": "Descrição do projeto",
  "impact": 5,
  "contact_id": "uuid-do-contato",
  "customer_id": "uuid-do-cliente",
  "status": 1,
  "budget": 15000.5,
  "forecast_dates": [
    {
      "date": "2025-06-01",
      "project_funnel_id": 4
    }
  ],
  "funnel_status": {
    "project_funnel_id": 5,
    "funnel_status_id": 2
  },
  "prefix": "PRJ",
  "users": [
    {
      "user_id": "uuid-do-usuario",
      "role": "assignee",
      "action": "add"
    }
  ],
  "parent_id": "550e8400-e29b-41d4-a716-446655440000"
}

Response

Sucesso

responseboolean