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

# Primeira requisição

Liste seus espaços, crie uma tarefa e pagine resultados

Com o [token em mãos](/docs/autenticacao), faça estas três chamadas para conhecer a API.

## 1. Liste seus espaços

Os espaços organizam as tarefas e os projetos no Wiboor. Comece por eles: a resposta traz o `id` de cada espaço e os usuários que participam com você.

```bash Terminal
curl "https://api.azzimuti.com.br/v1/departments" \
  -H "Authorization: Bearer SEU_TOKEN"
```

Veja todos os campos em [Listar espaços](/reference/listar-todos-os-espacos-que-seu-usuario-esta-com-seus-membros).

## 2. Crie uma tarefa

Use o `id` de um espaço e o `id` de um membro (o executor) para criar uma tarefa:

```bash Terminal
curl -X POST "https://api.azzimuti.com.br/v1/tasks" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Retornar contato do lead ACME",
    "type": "TASK",
    "departmentId": "ID_DO_ESPACO",
    "userExecutorId": "ID_DO_EXECUTOR"
  }'
```

- Só `title`, `type` e `userExecutorId` são obrigatórios.
- Para planejar a tarefa, envie `startedAt` (início) e `endedAt` (prazo) em ISO 8601, por exemplo `2026-12-01T12:00:00.000Z`. O início não pode estar no passado: a API responde `400`.
- Os demais campos (prioridade, descrição, projeto…) estão em [Criar uma tarefa](/reference/criar-uma-nova-tarefa-ou-problema-para-alguem).
- `type` é `TASK` (tarefa) ou `BUG` (problema).

## 3. Liste tarefas com filtros e paginação

```bash Terminal
curl -G "https://api.azzimuti.com.br/v1/tasks" \
  -H "Authorization: Bearer SEU_TOKEN" \
  --data-urlencode "userExecutorId=ID_DO_EXECUTOR" \
  --data-urlencode "status[]=NOT_STARTED" \
  --data-urlencode "status[]=STARTED" \
  --data-urlencode "count=50" \
  --data-urlencode "page=1"
```

As listagens são paginadas: `count` define quantos itens vêm por página e `page` escolhe a página. A resposta traz o campo `pagination` para você saber se há mais páginas.

Todos os filtros (busca, projeto, espaços, período, status) estão em [Listar tarefas](/reference/listar-todas-as-tarefas-com-filtros).

## Próximos passos

- Acompanhe a execução com [iniciar](/reference/quando-voce-comecar-a-executar-uma-tarefa), [pausar](/reference/quando-voce-quer-pausar-a-execucao-de-uma-tarefa) e [finalizar](/reference/quando-voce-quer-finaliza-a-execucao-de-uma-tarefa) uma tarefa.
- Agrupe tarefas em [projetos](/reference/criar-um-novo-projeto).
- Use a documentação com o seu assistente de IA pelo [MCP Server](/docs/mcp-server).