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

# First request

List your spaces, create a task and paginate results

With your [token in hand](/docs/authentication), make these three calls to get to know the API.

## 1. List your spaces

Spaces organize tasks and projects in Wiboor. Start with them: the response brings the `id` of each space and the users who share it with you.

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

See every field in [List spaces](/reference/listar-todos-os-espacos-que-seu-usuario-esta-com-seus-membros).

## 2. Create a task

Use the `id` of a space and the `id` of a member (the assignee) to create a task:

```bash Terminal
curl -X POST "https://api.azzimuti.com.br/v1/tasks" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Call back the ACME lead",
    "type": "TASK",
    "departmentId": "SPACE_ID",
    "userExecutorId": "ASSIGNEE_ID"
  }'
```

- Only `title`, `type` and `userExecutorId` are required.
- To schedule the task, send `startedAt` (start) and `endedAt` (due date) in ISO 8601, for example `2026-12-01T12:00:00.000Z`. The start cannot be in the past: the API responds `400`.
- The other fields (priority, description, project…) are in [Create a task](/reference/criar-uma-nova-tarefa-ou-problema-para-alguem).
- `type` is `TASK` (task) or `BUG` (bug).

## 3. List tasks with filters and pagination

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

Lists are paginated: `count` sets how many items come per page and `page` picks the page. The response includes a `pagination` field so you know whether there are more pages.

Every filter (search, project, spaces, period, status) is in [List tasks](/reference/listar-todas-as-tarefas-com-filtros).

## Next steps

- Track execution by [starting](/reference/quando-voce-comecar-a-executar-uma-tarefa), [pausing](/reference/quando-voce-quer-pausar-a-execucao-de-uma-tarefa) and [finishing](/reference/quando-voce-quer-finaliza-a-execucao-de-uma-tarefa) a task.
- Group tasks into [projects](/reference/criar-um-novo-projeto).
- Use the documentation with your AI assistant through the [MCP Server](/docs/mcp-server-en).