Create Group

This API creates a new group within the tenant. Groups are used to organize users and manage their permissions collectively.

Endpoint Details

URL	/v1/auth/groups
Method	POST
Authorization	Bearer Token

---

Request Headers

Header	Type	Description
Content-Type	String	Must be application/json

---

Request Body

Use the following format to make a request:

JSON Request

{
  "name": "grup jeje 2",
  "description": "deskripsi grup"
}

---

Parameters

Parameter	Type	Description
name	String	Name of the group
description	String	Optional description of the group

---

Response

Here is an example response after the request has been successfully processed:

Response

{
    "group": {
        "id": "8c9258f8-14c9-42c5-978b-f7a652c13444",
        "tenant_id": "5ebde17c-01a1-4394-977b-9e611250cf5d",
        "name": "Grup Jeje 2",
        "description": "deskripsi grup",
        "created_by": "0a937c60-0ed4-4d06-870a-2e284b54287d",
        "updated_by": "0a937c60-0ed4-4d06-870a-2e284b54287d",
        "created_at": 1784085688,
        "updated_at": 1784085688
    }
}

---

Field Descriptions

Field	Type	Description
id	UUID	Unique identifier of the group
tenant_id	UUID	Identifier of the tenant that owns the group
name	String	Name of the group
description	String	Description of the group
created_by	UUID	Identifier of the user who created the group
updated_by	UUID	Identifier of the user who last updated the group
created_at	Integer	Group creation timestamp in Unix format
updated_at	Integer	Last update timestamp in Unix format

---

info

• A valid Bearer Token is required to access this endpoint.
• Unix timestamp fields can be converted to a human-readable date and time format as needed.