---
agentTools:
  projectIndex: https://docs.wiboor.com.br/llms.txt
  projectSearch: https://docs.wiboor.com.br/agentSearch?query=term1%20term2
---

# Registrar e aprovar uma ideia

Registre sugestões vindas de outro sistema com POST /v1/ideas e aprove a ideia gerando uma tarefa com PATCH /v1/ideas/{id}/change-status.

## Registre a ideia

> Linhas destacadas: 7-16

Só `description` e `departmentId` (o espaço) são obrigatórios. Use para levar ao Wiboor sugestões que chegam por formulário, pesquisa de satisfação ou chat interno. A ideia nasce como `NOT_STARTED` (não analisada).

## Coloque em análise

> Linhas destacadas: 18-23

[Alterar o status de uma ideia](/reference/alterar-o-status-de-uma-ideia) aceita `NOT_STARTED` (não analisada), `STARTED` (em análise), `FINISHED` (aprovada) e `CANCELED` (arquivada).

## Aprove gerando trabalho

> Linhas destacadas: 25-35

Para aprovar (`FINISHED`), informe o que a aprovação gera em `ideaType` (`task` ou `project`) e quem vai executar em `userExecutorId`: os dois são obrigatórios nesse status. Para arquivar, envie só `status: "CANCELED"`.

## Código

```js Node.js
const BASE_URL = 'https://api.azzimuti.com.br/v1';
const headers = {
  Authorization: `Bearer ${process.env.WIBOOR_TOKEN}`,
  'Content-Type': 'application/json',
};

// 1. Registre a ideia no espaço da equipe
const ideaRes = await fetch(`${BASE_URL}/ideas`, {
  method: 'POST',
  headers,
  body: JSON.stringify({
    description: 'Enviar lembrete por WhatsApp um dia antes da reunião com o cliente',
    departmentId: '0197a1c2-3d4e-7f50-8a61-b2c3d4e5f607',
  }),
});
const idea = await ideaRes.json();

// 2. Coloque em análise
await fetch(`${BASE_URL}/ideas/${idea.id}/change-status`, {
  method: 'PATCH',
  headers,
  body: JSON.stringify({ status: 'STARTED' }),
});

// 3. Aprove: a ideia vira uma tarefa para o executor
const approvedRes = await fetch(`${BASE_URL}/ideas/${idea.id}/change-status`, {
  method: 'PATCH',
  headers,
  body: JSON.stringify({
    status: 'FINISHED',
    ideaType: 'task',
    userExecutorId: '0197a1c2-9b8a-7c6d-8e5f-40312a1b2c3d',
  }),
});
const approved = await approvedRes.json();
```

## Resposta

```json
{
  "id": "0197b6d3-4e5f-7a6b-8c7d-8e9f0a1b2c3d",
  "ideaNumber": 412,
  "description": "Enviar lembrete por WhatsApp um dia antes da reunião com o cliente",
  "status": "FINISHED",
  "departmentId": "0197a1c2-3d4e-7f50-8a61-b2c3d4e5f607",
  "createdAt": "2026-11-03T15:20:44.000Z"
}
```