1.1

get /v1/groups/{group_id}/users

Description

get group users list

상태 ACTIVE (SUPPORTED)

버전	최소 지원 보장일
1.1	20260531

Parameters

Type	Name	Description	Schema	Default
path	group_id required	그룹 ID Example : `138c2fc8c29a449dbfa8681f8f1d78e2`	string	None
query	size optional	size Example : `20`	any of [integer, null]	20
query	page optional	page Example : `0`	any of [integer, null]	0
query	sort optional	sort Example : `created_at:desc`	any of [string, null]	None
query	instance_id required	인스턴스 ID Example : `ssoins-12345`	string	None
query	user_id optional	사용자 ID Example : `138c2fc8c29a449dbfa8681f8f1d78e2`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	GroupUsersPageResponse
400	Bad Request	None
401	Unauthorized	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/groups/{group_id}/users?instance_id={instance_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = ko-KR",
"Scp-Api-Version = iam-identity-center 1.1"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ],
    "users": [
        {
            "created_at": "2024-05-17T00:23:17Z",
            "created_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "group_count": 2,
            "groups": [
                {
                    "created_at": "2025-07-03T12:05:11",
                    "created_by": "a8b5d675f25341cea41eb4cd1979aa95",
                    "id": "39520424-440c-41c0-9b9c-f22b2129f6f9",
                    "modified_at": "2025-07-03T12:05:11",
                    "modified_by": "a8b5d675f25341cea41eb4cd1979aa95",
                    "name": "admin"
                },
                {
                    "created_at": "2025-07-03T12:05:36",
                    "created_by": "a8b5d675f25341cea41eb4cd1979aa95",
                    "id": "80c53fe1-4e27-4cce-92be-151cf0f2873e",
                    "modified_at": "2025-07-07T05:16:58",
                    "modified_by": "941e76c4b9424cd9b0ac3a12d5f4335d",
                    "name": "test-group"
                }
            ],
            "id": "138c2fc8c29a449dbfa8681f8f1d78e2",
            "modified_at": "2024-05-17T00:23:17Z",
            "modified_by": "90dddfc2b1e04edba54ba2b41539a9ac",
            "name": "John Doe",
            "user_id": "johndoe"
        }
    ]
}