> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dokstamp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Grupos de Módulos

> Organize os módulos do curso em grupos lógicos (semestres, períodos, áreas).

# Grupos de Módulos

Os grupos de módulos permitem organizar os módulos de um curso em seções lógicas — semestres, períodos acadêmicos, áreas do conhecimento ou qualquer outro agrupamento que reflita a estrutura do seu currículo.

***

## O objeto grupo de módulos

```json theme={null}
{
  "uuid": "d4e5f6a7-b8c9-0123-defg-234567890123",
  "name": "1st Semester",
  "order": 1,
  "is_active": true,
  "course": {
    "uuid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "name": "Bachelor of Computer Science"
  }
}
```

***

## Listar grupos de módulos

```http theme={null}
GET /courses/{course_uuid}/modules/groups
```

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.dokstamp.com/courses/c3d4e5f6-a7b8-9012-cdef-123456789012/modules/groups" \
    -H "Authorization: Bearer {TOKEN}" \
    -H "Accept: application/json" \
    -H "X-Tenant: {TENANT}"
  ```
</CodeGroup>

***

## Criar um grupo de módulos

```http theme={null}
POST /courses/{course_uuid}/modules/groups
```

| Parâmetro   | Tipo    | Obrigatório | Descrição                          |
| ----------- | ------- | ----------- | ---------------------------------- |
| `name`      | string  | Sim         | Nome do grupo (ex.: "1º Semestre") |
| `order`     | integer | Não         | Ordem de exibição dentro do curso  |
| `is_active` | boolean | Não         | Padrão: `true`                     |

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.dokstamp.com/courses/c3d4e5f6-a7b8-9012-cdef-123456789012/modules/groups" \
    -H "Authorization: Bearer {TOKEN}" \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -H "X-Tenant: {TENANT}" \
    -d '{
      "name": "1st Semester",
      "order": 1,
      "is_active": true
    }'
  ```
</CodeGroup>

Após criar os grupos, atribua módulos a eles usando o parâmetro `course_module_group_uuid` ao vincular módulos. Consulte [Módulos do Curso](/pt-BR/api-reference/courses/modules).

***

## Obter, atualizar, excluir

```http theme={null}
GET    /courses/{course_uuid}/modules/groups/{group_uuid}
PATCH  /courses/{course_uuid}/modules/groups/{group_uuid}
PUT    /courses/{course_uuid}/modules/groups/{group_uuid}
DELETE /courses/{course_uuid}/modules/groups/{group_uuid}
```