Detail User Set Policy by ID
This API returns detailed information about a specific user set policy identified by ID.
Endpoint Details
| URL | /v1/config-agent/user-sets/id |
| Method | GET |
| Authorization | Bearer Token |
Request Headers
| Header | Type | Description |
|---|---|---|
| Content-Type | String | Must be application/json |
Request Path
To retrieve the details of a specific user set policy, use the following request format:
/v1/config-agent/user-sets/95811aa4-5b61-46d3-a007-14d0a576ef60
Path Parameter
| Parameter | Type | Description |
|---|---|---|
| id | UUID | Unique identifier of the user set policy |
Response
Here is an example of a response when viewing data details:
Response
{
"data": {
"id": "95811aa4-5b61-46d3-a007-14d0a576ef60",
"tenant_id": "5ebde17c-01a1-4394-977b-9e611250cf5d",
"name": "Dummy User Sets",
"users": [
{
"uname": "dummy",
"gname": "dummy",
"uid": "1000",
"gid": "1000"
}
],
"created_by": "0a937c60-0ed4-4d06-870a-2e284b54287d",
"created_by_name": "Admin Aplikasi",
"updated_by": "0a937c60-0ed4-4d06-870a-2e284b54287d",
"updated_by_name": "Admin Aplikasi",
"created_at": 1785214953,
"updated_at": 1785214953
}
}
Field Descriptions
| Field | Type | Description |
|---|---|---|
| id | UUID | Unique identifier of the user set policy |
| tenant_id | UUID | Identifier of the tenant that owns the user set policy |
| name | String | Name of the user set policy |
| description | String | Description of the user set policy |
| users | Array | List of users included in the policy |
| uname | String | Username of the user |
| gname | String | Group name of the user |
| uid | String | User ID (UID) of the user |
| gid | String | Group ID (GID) of the user |
| domain_os | String | Operating system domain that restricts the policy |
| created_by | UUID | Identifier of the user who created the policy |
| created_by_name | String | Display name of the user who created the policy |
| updated_by | UUID | Identifier of the user who last updated the policy |
| updated_by_name | String | Display name of the user who last updated the policy |
| created_at | Integer | 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.
- The
idpath parameter must reference an existing user set policy. - The
domain_osfield is only present when a domain restriction is configured for the user. - Unix timestamp fields can be converted to a human-readable date and time format as needed.