---
title: "Schemas"
slug: "schemas-1"
updated: 2023-08-01T07:55:41Z
published: 2023-08-01T07:55:41Z
canonical: "support.perimeter81.com/schemas-1"
---

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

# Schemas

<meta charset="utf-8">

## Request Headers

Each request must include the following request headers:

| Property | Data Type | Description |
| --- | --- | --- |
| Authorization* | String | Your temporary [Access Token](/v1/docs/authorize) obtained using the /authorize method |
| Content-Type* | <meta charset="utf-8">String | <meta charset="utf-8">*application/json* |

## Request Body Schemas

## Groups

Groups contain applications, networks, locations, and members (users) that have access to resources.

<meta charset="utf-8">

### CreateGroupDto

DTO for creating a group. Request body in POST /v1/groups.

| Property | Data Type | Description |
| --- | --- | --- |
| name | String | Name of the group. |
| description | String | Description of group. |

### 

### Group

Data for a single group. Response to POST /v1/groups, DELETE /v1/groups/{id}, POST /v1/groups/{groupId}/member/{userId}, and DELETE /v1/groups/{groupId}/member/{userId}. Found in GroupList.

| Property | Data Type | Description |
| --- | --- | --- |
| name* | String | Name of the group. |
| isDefault* | Boolean | Whether the group is a default group (true). |
| applications* | Array of String | List of group applications. |
| networks* | Array of String | List of group networks. |
| vpnLocations* | Array of String | List of group locations. |
| users* | Array of String | List of group members. |
| id* | String | Group ID. |

### GroupList

List of Group. Response to GET /v1/groups.

| Property | Data Type | Description |
| --- | --- | --- |
| data* | Array of **Group** | List of groups. |
| page* | Number | Page number. |
| totalPage* | Number | Number of pages in list. |
| itemsTotal* | Number | Number of items in list. |