This guide provides a brief description of Organization service and how to call API. The API is provided as a RESTful API, and it responds in JSON format.

Version

Version	Status	Supported Until
1.0	DEPRECATED	20251231
1.1	CURRENT	-

OpenAPI URL

https://organization.{environment}.samsungsdscloud.com

Environment and Region List

environment	region
s	kr-west1
s	kr-east1
g	kr-south1
g	kr-south2
g	kr-south3
e	kr-west1
e	kr-east1

1 - APIs

1.1 - AcceptInvitation

1.1.1 - 1.1

put /v1/invitations/{invitation_id}/accept

Description

accept a specific invitation

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	invitation_id required	초대 ID Example : `138c2fc8c29a449dbfa8681f8f1d78e2`	string	None

Responses

HTTP Code	Description	Schema
200	OK	InvitationAcceptResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/invitations/{invitation_id}/accept

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Example HTTP response

Response 200

{
    "failed_id": {
        "error_code": "Invitation.AlreadySentError",
        "failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found",
        "failed_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "failed_name": "My Organization"
    },
    "master_account_email": "score@samsung.com",
    "success_id": {
        "success_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "success_name": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
    }
}

1.1.2 - 1.0

put /v1/invitations/{invitation_id}/accept

Description

accept a specific invitation

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	invitation_id required	초대 ID Example : `138c2fc8c29a449dbfa8681f8f1d78e2`	string	None

Responses

HTTP Code	Description	Schema
200	OK	InvitationAcceptResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/invitations/{invitation_id}/accept

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Example HTTP response

Response 200

{
    "failed_id": {
        "error_code": "Invitation.AlreadySentError",
        "failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found",
        "failed_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "failed_name": "My Organization"
    },
    "master_account_email": "score@samsung.com",
    "success_id": {
        "success_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "success_name": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
    }
}

1.2 - AttachPolicyBindings

1.2.1 - 1.1

post /v1/assignments/policy-bindings

Description

attach policy bindings

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		PolicyAttachRequest

Responses

HTTP Code	Description	Schema
200	OK	ControlPolicyAssignmentResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/assignments/policy-bindings

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Request body

{
    "entity": "POLICY",
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
    "policy_ids": [
        "f98e76d54c32b10a9z8y7x6w5v4u3"
    ],
    "target_ids": [
        "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
    ]
}

Example HTTP response

Response 200

{
    "failed_ids": [
        {
            "error_code": "Conflict",
            "failed_caused": "Account 482d111a302547fbbd11ee0141ea23bb is not found",
            "failed_id": "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
        }
    ],
    "success_ids": [
        "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
    ]
}

1.2.2 - 1.0

post /v1/assignments/policy-bindings

Description

attach policy bindings

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		PolicyAttachRequest

Responses

HTTP Code	Description	Schema
200	OK	ControlPolicyAssignmentResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/assignments/policy-bindings

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Request body

{
    "entity": "POLICY",
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
    "policy_ids": [
        "f98e76d54c32b10a9z8y7x6w5v4u3"
    ],
    "target_ids": [
        "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
    ]
}

Example HTTP response

Response 200

{
    "failed_ids": [
        {
            "error_code": "Conflict",
            "failed_caused": "Account 482d111a302547fbbd11ee0141ea23bb is not found",
            "failed_id": "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
        }
    ],
    "success_ids": [
        "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
    ]
}

1.3 - CancelInvitations

1.3.1 - 1.1

put /v1/invitations/cancel

Description

cancel invitations

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		InvitationCancelRequest

Responses

HTTP Code	Description	Schema
200	OK	InvitationCancelResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/invitations/cancel

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Request body

{
    "ids": [
        "138c2fc8c29a449dbfa8681f8f1d78e2"
    ],
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}

Example HTTP response

Response 200

{
    "success_ids": [
        "138c2fc8c29a449dbfa8681f8f1d78e2"
    ]
}

1.3.2 - 1.0

put /v1/invitations/cancel

Description

cancel invitations

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		InvitationCancelRequest

Responses

HTTP Code	Description	Schema
200	OK	InvitationCancelResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/invitations/cancel

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Request body

{
    "ids": [
        "138c2fc8c29a449dbfa8681f8f1d78e2"
    ],
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}

Example HTTP response

Response 200

{
    "success_ids": [
        "138c2fc8c29a449dbfa8681f8f1d78e2"
    ]
}

1.4 - CreateAccount

1.4.1 - 1.1

post /v1/organization-accounts

Description

create a account

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		OrganizationUserCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	AccountCreateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-accounts

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Request body

{
    "login_id": "log-archive@samsung.com",
    "name": "score-account",
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
    "role_name": "OrganizationAccountAccessRole"
}

Example HTTP response

Response 201

{
    "failed": {
        "error_code": "Organization.AccountNotRemovable",
        "failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found"
    },
    "success": {
        "success_id": "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
        "success_name": "score-account"
    }
}

1.4.2 - 1.0

post /v1/organization-accounts

Description

create a account

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		OrganizationUserCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	AccountCreateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-accounts

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Request body

{
    "login_id": "log-archive@samsung.com",
    "name": "score-account",
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
    "role_name": "OrganizationAccountAccessRole"
}

Example HTTP response

Response 201

{
    "failed": {
        "error_code": "Organization.AccountNotRemovable",
        "failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found"
    },
    "success": {
        "success_id": "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
        "success_name": "score-account"
    }
}

1.5 - CreateDelegationPolicy

1.5.1 - 1.1

post /v1/delegation-policies

Description

create a delegation policy

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		DelegationPolicyCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	DelegationPolicyShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/delegation-policies

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Request body

{
    "document": {
        "Statement": [
            {
                "Action": [
                    "organization:CreateServiceControlPolicy",
                    "organization:DeleteServiceControlPolicies",
                    "organization:SetServiceControlPolicy",
                    "organization:ShowServiceControlPolicy",
                    "organization:ListServiceControlPolicies",
                    "organization:ShowAccount",
                    "organization:ListAccounts",
                    "organization:ListOrganizationUnits",
                    "organization:ListOrganizationInvitations",
                    "organization:ListParents",
                    "organization:ListPoliciesForTarget",
                    "organization:ListTargetsForPolicy",
                    "organization:AttachPolicyBindings",
                    "organization:RemovePolicyBindings",
                    "organization:ShowDelegatePolicy"
                ],
                "Effect": "Allow",
                "Principal": {
                    "scp": [
                        "srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
                    ]
                },
                "Resource": [
                    "*"
                ],
                "Sid": "statement1"
            }
        ],
        "Version": "2024-07-01"
    },
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}

Example HTTP response

Response 201

{
    "policy": {
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "document": {
            "Statement": [
                {
                    "Action": [
                        "organization:CreateServiceControlPolicy",
                        "organization:DeleteServiceControlPolicies",
                        "organization:SetServiceControlPolicy",
                        "organization:ShowServiceControlPolicy",
                        "organization:ListServiceControlPolicies",
                        "organization:ShowAccount",
                        "organization:ListAccounts",
                        "organization:ListOrganizationUnits",
                        "organization:ListOrganizationInvitations",
                        "organization:ListParents",
                        "organization:ListPoliciesForTarget",
                        "organization:ListTargetsForPolicy",
                        "organization:AttachPolicyBindings",
                        "organization:RemovePolicyBindings",
                        "organization:ShowDelegatePolicy"
                    ],
                    "Effect": "Allow",
                    "Principal": {
                        "scp": [
                            "srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
                        ]
                    },
                    "Resource": [
                        "*"
                    ],
                    "Sid": "statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
    }
}

1.5.2 - 1.0

post /v1/delegation-policies

Description

create a delegation policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		DelegationPolicyCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	DelegationPolicyShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/delegation-policies

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Request body

{
    "document": {
        "Statement": [
            {
                "Action": [
                    "organization:CreateServiceControlPolicy",
                    "organization:DeleteServiceControlPolicies",
                    "organization:SetServiceControlPolicy",
                    "organization:ShowServiceControlPolicy",
                    "organization:ListServiceControlPolicies",
                    "organization:ShowAccount",
                    "organization:ListAccounts",
                    "organization:ListOrganizationUnits",
                    "organization:ListOrganizationInvitations",
                    "organization:ListParents",
                    "organization:ListPoliciesForTarget",
                    "organization:ListTargetsForPolicy",
                    "organization:AttachPolicyBindings",
                    "organization:RemovePolicyBindings",
                    "organization:ShowDelegatePolicy"
                ],
                "Effect": "Allow",
                "Principal": {
                    "scp": [
                        "srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
                    ]
                },
                "Resource": [
                    "*"
                ],
                "Sid": "statement1"
            }
        ],
        "Version": "2024-07-01"
    },
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}

Example HTTP response

Response 201

{
    "policy": {
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "document": {
            "Statement": [
                {
                    "Action": [
                        "organization:CreateServiceControlPolicy",
                        "organization:DeleteServiceControlPolicies",
                        "organization:SetServiceControlPolicy",
                        "organization:ShowServiceControlPolicy",
                        "organization:ListServiceControlPolicies",
                        "organization:ShowAccount",
                        "organization:ListAccounts",
                        "organization:ListOrganizationUnits",
                        "organization:ListOrganizationInvitations",
                        "organization:ListParents",
                        "organization:ListPoliciesForTarget",
                        "organization:ListTargetsForPolicy",
                        "organization:AttachPolicyBindings",
                        "organization:RemovePolicyBindings",
                        "organization:ShowDelegatePolicy"
                    ],
                    "Effect": "Allow",
                    "Principal": {
                        "scp": [
                            "srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
                        ]
                    },
                    "Resource": [
                        "*"
                    ],
                    "Sid": "statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
    }
}

1.6 - CreateInvitation

1.6.1 - 1.1

post /v1/invitations

Description

create an invitation

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		InvitationCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	InvitationCreateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/invitations

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Request body

{
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
    "target_login_ids": [
        "score-1@samsung.com"
    ]
}

Example HTTP response

Response 201

{
    "failed_ids": [
        {
            "error_code": "Invitation.AlreadySentError",
            "failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found",
            "failed_id": [
                "score-1@samsung.com"
            ]
        }
    ],
    "success_ids": [
        "log-archive@samsung.com"
    ]
}

1.6.2 - 1.0

post /v1/invitations

Description

create an invitation

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		InvitationCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	InvitationCreateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/invitations

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Request body

{
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
    "target_login_ids": [
        "score-1@samsung.com"
    ]
}

Example HTTP response

Response 201

{
    "failed_ids": [
        {
            "error_code": "Invitation.AlreadySentError",
            "failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found",
            "failed_id": [
                "score-1@samsung.com"
            ]
        }
    ],
    "success_ids": [
        "log-archive@samsung.com"
    ]
}

1.7 - CreateOrganization

1.7.1 - 1.1

post /v1/organizations

Description

create a organization

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		OrganizationCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	OrganizationShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/organizations

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Request body

{
    "name": "My Organization"
}

Example HTTP response

Response 201

{
    "organization": {
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "master_account_email": "admin@example.com",
        "master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "My Organization",
        "root_unit_id": "r-abcd7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/organization/o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "use_scp_yn": true
    }
}

1.7.2 - 1.0

post /v1/organizations

Description

create a organization

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		OrganizationCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	OrganizationShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/organizations

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Request body

{
    "name": "My Organization"
}

Example HTTP response

Response 201

{
    "organization": {
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "master_account_email": "admin@example.com",
        "master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "My Organization",
        "root_unit_id": "r-abcd7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/organization/o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "use_scp_yn": true
    }
}

1.8 - CreateOrganizationUnit

1.8.1 - 1.1

post /v1/organization-units

Description

create an organization unit

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		OrganizationUnitCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	OrganizationUnitCreateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-units

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Request body

{
    "description": "에스코어 조직 단위",
    "name": "score-organization-unit",
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
    "parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
    "policy_ids": [
        "f98e76d54c32b10a9z8y7x6w5v4u3"
    ]
}

Example HTTP response

Response 201

{
    "organization_unit": {
        "control_policies": [
            {
                "policy_id": "f98e76d54c32b10a9z8y7x6w5v4u3",
                "policy_name": "test-policy-name"
            }
        ],
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "depth": 1,
        "description": "에스코어 조직 단위",
        "id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "score-organization-unit",
        "parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
        "service_name": "Organization",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/ou/ou-c29a138f8f1d78e24dbfa8681fc2fc8",
        "type": "OU"
    }
}

1.8.2 - 1.0

post /v1/organization-units

Description

create an organization unit

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		OrganizationUnitCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	OrganizationUnitCreateResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-units

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Request body

{
    "description": "에스코어 조직 단위",
    "name": "score-organization-unit",
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
    "parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
    "policy_ids": [
        "f98e76d54c32b10a9z8y7x6w5v4u3"
    ]
}

Example HTTP response

Response 201

{
    "organization_unit": {
        "control_policies": [
            {
                "policy_id": "f98e76d54c32b10a9z8y7x6w5v4u3",
                "policy_name": "test-policy-name"
            }
        ],
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "depth": 1,
        "description": "에스코어 조직 단위",
        "id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "score-organization-unit",
        "parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
        "service_name": "Organization",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/ou/ou-c29a138f8f1d78e24dbfa8681fc2fc8",
        "type": "OU"
    }
}

1.9 - CreateServiceControlPolicy

1.9.1 - 1.1

post /v1/service-control-policies

Description

create a service control policy

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		ServiceControlPolicyCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	ServiceControlPolicyShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/service-control-policies

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Request body

{
    "description": "This is an example policy.",
    "document": {
        "Statement": [
            {
                "Action": [
                    "*"
                ],
                "Effect": "Allow",
                "Resource": [
                    "*"
                ],
                "Sid": "statement1"
            }
        ],
        "Version": "2024-07-01"
    },
    "name": "MyPolicy",
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
    "type": "MANAGED"
}

Example HTTP response

Response 201

{
    "policy": {
        "category": "SCP",
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "description": "This is an example policy.",
        "document": {
            "Statement": [
                {
                    "Action": [
                        "*"
                    ],
                    "Effect": "Allow",
                    "Resource": [
                        "*"
                    ],
                    "Sid": "statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "id": "138c2fc8c29a449dbfa8681f8f1d78e2",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "MyPolicy",
        "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "service_name": "Organization",
        "source": "ORGANIZATION",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/service-control-policy/138c2fc8c29a449dbfa8681f8f1d78e2",
        "state": "ACTIVE",
        "type": "MANAGED"
    }
}

1.9.2 - 1.0

post /v1/service-control-policies

Description

create a service control policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		ServiceControlPolicyCreateRequest

Responses

HTTP Code	Description	Schema
201	Created	ServiceControlPolicyShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/service-control-policies

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Request body

{
    "description": "This is an example policy.",
    "document": {
        "Statement": [
            {
                "Action": [
                    "*"
                ],
                "Effect": "Allow",
                "Resource": [
                    "*"
                ],
                "Sid": "statement1"
            }
        ],
        "Version": "2024-07-01"
    },
    "name": "MyPolicy",
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
    "type": "MANAGED"
}

Example HTTP response

Response 201

{
    "policy": {
        "category": "SCP",
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "description": "This is an example policy.",
        "document": {
            "Statement": [
                {
                    "Action": [
                        "*"
                    ],
                    "Effect": "Allow",
                    "Resource": [
                        "*"
                    ],
                    "Sid": "statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "id": "138c2fc8c29a449dbfa8681f8f1d78e2",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "MyPolicy",
        "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "service_name": "Organization",
        "source": "ORGANIZATION",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/service-control-policy/138c2fc8c29a449dbfa8681f8f1d78e2",
        "state": "ACTIVE",
        "type": "MANAGED"
    }
}

1.10 - DeclineInvitation

1.10.1 - 1.1

put /v1/invitations/{invitation_id}/decline

Description

decline a specific invitation

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	invitation_id required	초대 ID Example : `138c2fc8c29a449dbfa8681f8f1d78e2`	string	None

Responses

HTTP Code	Description	Schema
200	OK	InvitationShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/invitations/{invitation_id}/decline

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Example HTTP response

Response 200

{
    "invitation": {
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "expired_time": "2024-04-30T12:34:56.789Z",
        "id": "138c2fc8c29a449dbfa8681f8f1d78e2",
        "master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "requested_time": "2024-04-17T12:34:56.789Z",
        "state": "REFUSED",
        "target_account_id": "338c2fc8c29a449dbfa8681f8f1d78e5"
    }
}

1.10.2 - 1.0

put /v1/invitations/{invitation_id}/decline

Description

decline a specific invitation

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	invitation_id required	초대 ID Example : `138c2fc8c29a449dbfa8681f8f1d78e2`	string	None

Responses

HTTP Code	Description	Schema
200	OK	InvitationShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/invitations/{invitation_id}/decline

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Example HTTP response

Response 200

{
    "invitation": {
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "expired_time": "2024-04-30T12:34:56.789Z",
        "id": "138c2fc8c29a449dbfa8681f8f1d78e2",
        "master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "requested_time": "2024-04-17T12:34:56.789Z",
        "state": "REFUSED",
        "target_account_id": "338c2fc8c29a449dbfa8681f8f1d78e5"
    }
}

1.11 - DeleteDelegationPolicy

1.11.1 - 1.1

delete /v1/delegation-policies

Description

delete a specific delegation policy

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
204	No Content	None
403	Forbidden	None

Example HTTP request

Request path

/v1/delegation-policies

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Example HTTP response

Response 204

1.11.2 - 1.0

delete /v1/delegation-policies

Description

delete a specific delegation policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
204	No Content	None
403	Forbidden	None

Example HTTP request

Request path

/v1/delegation-policies

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Example HTTP response

Response 204

1.12 - DeleteOrganization

1.12.1 - 1.1

delete /v1/organizations/{organization_id}

Description

delete a specific organization

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string	None

Responses

HTTP Code	Description	Schema
200	OK	OrganizationDeleteResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organizations/{organization_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Example HTTP response

Response 200

{
    "failed": {
        "error_code": "Organization.delete.MemberAccountIsExist",
        "failed_caused": "Payment method registration required.",
        "failed_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
    },
    "success": "My Organization"
}

1.12.2 - 1.0

delete /v1/organizations/{organization_id}

Description

delete a specific organization

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string	None

Responses

HTTP Code	Description	Schema
200	OK	OrganizationDeleteResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organizations/{organization_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Example HTTP response

Response 200

{
    "failed": {
        "error_code": "Organization.delete.MemberAccountIsExist",
        "failed_caused": "Payment method registration required.",
        "failed_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
    },
    "success": "My Organization"
}

1.13 - DeleteOrganizationUnits

1.13.1 - 1.1

delete /v1/organization-units

Description

delete organization units

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		OrganizationUnitDeleteRequest

Responses

HTTP Code	Description	Schema
200	OK	OrganizationUnitDeleteResponse
403	Forbidden	None

Example HTTP request

Request path

/v1/organization-units

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Request body

{
    "ids": [
        "ou-c29a138f8f1d78e24dbfa8681fc2fc8"
    ],
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}

Example HTTP response

Response 200

{
    "failed_ids": [
        {
            "error_code": "Organization.UnitNotRemovable",
            "failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found",
            "failed_id": "ou-abc1f2h1j0l9n8p7r6t5v4x3z2y1w0"
        }
    ],
    "success_ids": [
        "ou-c29a138f8f1d78e24dbfa8681fc2fc8"
    ]
}

1.13.2 - 1.0

delete /v1/organization-units

Description

delete organization units

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		OrganizationUnitDeleteRequest

Responses

HTTP Code	Description	Schema
200	OK	OrganizationUnitDeleteResponse
403	Forbidden	None

Example HTTP request

Request path

/v1/organization-units

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Request body

{
    "ids": [
        "ou-c29a138f8f1d78e24dbfa8681fc2fc8"
    ],
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}

Example HTTP response

Response 200

{
    "failed_ids": [
        {
            "error_code": "Organization.UnitNotRemovable",
            "failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found",
            "failed_id": "ou-abc1f2h1j0l9n8p7r6t5v4x3z2y1w0"
        }
    ],
    "success_ids": [
        "ou-c29a138f8f1d78e24dbfa8681fc2fc8"
    ]
}

1.14 - DeleteServiceControlPolicies

1.14.1 - 1.1

delete /v1/service-control-policies

Description

delete service control policies

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		ServiceControlPolicyDeleteRequest

Responses

HTTP Code	Description	Schema
200	OK	ServiceControlPolicyDeleteResponse
403	Forbidden	None

Example HTTP request

Request path

/v1/service-control-policies

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Request body

{
    "ids": [
        "138c2fc8c29a449dbfa8681f8f1d78e2"
    ],
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}

Example HTTP response

Response 200

{
    "failed_ids": [
        {
            "binding_targets": [
                {
                    "id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8 또는 b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
                    "name": "score-organization-unit 또는 score-account",
                    "type": "OU"
                }
            ],
            "error_code": "Policy.PolicyInUseError",
            "failed_caused": "The specified policy is in use and cannot be deleted.",
            "failed_id": "138c2fc8c29a449dbfa8681f8f1d78e2"
        }
    ],
    "success_ids": [
        ""
    ]
}

1.14.2 - 1.0

delete /v1/service-control-policies

Description

delete service control policies

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		ServiceControlPolicyDeleteRequest

Responses

HTTP Code	Description	Schema
200	OK	ServiceControlPolicyDeleteResponse
403	Forbidden	None

Example HTTP request

Request path

/v1/service-control-policies

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Request body

{
    "ids": [
        "138c2fc8c29a449dbfa8681f8f1d78e2"
    ],
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}

Example HTTP response

Response 200

{
    "failed_ids": [
        {
            "binding_targets": [
                {
                    "id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8 또는 b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
                    "name": "score-organization-unit 또는 score-account",
                    "type": "OU"
                }
            ],
            "error_code": "Policy.PolicyInUseError",
            "failed_caused": "The specified policy is in use and cannot be deleted.",
            "failed_id": "138c2fc8c29a449dbfa8681f8f1d78e2"
        }
    ],
    "success_ids": [
        ""
    ]
}

1.15 - LeaveOrganization

1.15.1 - 1.1

delete /v1/organizations/{organization_id}/membership

Description

leave a specific organization

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string	None

Responses

HTTP Code	Description	Schema
200	OK	OrganizationLeaveResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organizations/{organization_id}/membership

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Example HTTP response

Response 200

{
    "failed": {
        "error_code": "Organization.AccountNotRemovable",
        "failed_caused": "Payment method registration required.",
        "failed_id": "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
        "failed_name": "My Organization"
    },
    "success": {
        "success_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "success_name": "My Organization"
    }
}

1.15.2 - 1.0

delete /v1/organizations/{organization_id}/membership

Description

leave a specific organization

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string	None

Responses

HTTP Code	Description	Schema
200	OK	OrganizationLeaveResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organizations/{organization_id}/membership

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Example HTTP response

Response 200

{
    "failed": {
        "error_code": "Organization.AccountNotRemovable",
        "failed_caused": "Payment method registration required.",
        "failed_id": "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
        "failed_name": "My Organization"
    },
    "success": {
        "success_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "success_name": "My Organization"
    }
}

1.16 - ListAccountInvitations

1.16.1 - 1.1

get /v1/account-invitations

Description

get account invitation list

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Responses

HTTP Code	Description	Schema
200	OK	AccountInvitationResponse
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/account-invitations

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Example HTTP response

Response 200

{
    "account_invitations": [
        {
            "created_at": "2024-12-19 01:09:05.000",
            "created_by": "c23fb561c689455993874fa5d5ed4a2f",
            "expired_time": "2024-04-30T12:34:56.789Z",
            "id": "0a36e0746dbf4908acf0357829701381",
            "master_account_email": "admin@example.com",
            "master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
            "master_account_login_id": "log-archive@samsung.com",
            "master_account_name": "CoreKim",
            "modified_at": "2023-10-15 14:30:00",
            "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
            "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
            "organization_name": "My Organization",
            "requested_time": "2024-04-17T12:34:56.789Z",
            "state": "INVITING",
            "target_account_id": "338c2fc8c29a449dbfa8681f8f1d78e5"
        }
    ],
    "count": 5
}

1.16.2 - 1.0

get /v1/account-invitations

Description

get account invitation list

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Responses

HTTP Code	Description	Schema
200	OK	AccountInvitationResponse
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/account-invitations

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Example HTTP response

Response 200

{
    "account_invitations": [
        {
            "created_at": "2024-12-19 01:09:05.000",
            "created_by": "c23fb561c689455993874fa5d5ed4a2f",
            "expired_time": "2024-04-30T12:34:56.789Z",
            "id": "0a36e0746dbf4908acf0357829701381",
            "master_account_email": "admin@example.com",
            "master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
            "master_account_login_id": "log-archive@samsung.com",
            "master_account_name": "CoreKim",
            "modified_at": "2023-10-15 14:30:00",
            "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
            "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
            "organization_name": "My Organization",
            "requested_time": "2024-04-17T12:34:56.789Z",
            "state": "INVITING",
            "target_account_id": "338c2fc8c29a449dbfa8681f8f1d78e5"
        }
    ],
    "count": 5
}

1.17 - ListAccounts

1.17.1 - 1.1

get /v1/organization-accounts

Description

get accounts list

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	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	id optional	조직 계정 ID Example : `b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0`	any of [string, null]	None
query	name optional	계정명 Example : `score-account`	any of [string, null]	None
query	email optional	계정 이메일 Example : `score@samsung.com`	any of [string, null]	None
query	login_id optional	로그인 ID Example : `log-archive@samsung.com`	any of [string, null]	None
query	joined_start_date optional	가입 조회 시작 일시 Example : `2024-05-17T12:34:56.789Z`	any of [string, null]	None
query	joined_end_date optional	가입 조회 종료 일시 Example : `2024-05-17T12:34:56.789Z`	any of [string, null]	None
query	joined_method optional	가입 방법 Example : `INVITED`	any of [enum (INVITED, CREATED, CLOUD_CONTROL), null]	None
query	exclude_policy_id optional	제외할 정책 ID Example : `238c2fc8c29a449dbfa8681f8f1d78e2`	any of [string, null]	None
query	parent_unit_id optional	ROOT 또는 부모 조직 단위 ID Example : `ou-fc8c29a138d78e24bf1fa86812fc8b`	any of [string, null]	None
query	parent_unit_name optional	ROOT 또는 부모 조직 단위명 Example : `parent-unit-name`	any of [string, null]	None
query	type optional	계정 유형 Example : `MEMBER`	any of [enum (MANAGEMENT, DELEGATION, MEMBER, NONE, LOG_ARCHIVE, AUDIT), null]	None

Responses

HTTP Code	Description	Schema
200	OK	AccountPageResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-accounts

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Example HTTP response

Response 200

{
    "accounts": [
        {
            "created_at": "2024-12-19 01:09:05.000",
            "created_by": "c23fb561c689455993874fa5d5ed4a2f",
            "email": "score@samsung.com",
            "id": "0a36e0746dbf4908acf0357829701381",
            "joined_method": "INVITED",
            "joined_time": "2024-05-17T12:34:56.789Z",
            "login_id": "log-archive@samsung.com",
            "modified_at": "2023-10-15 14:30:00",
            "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
            "name": "score-account",
            "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
            "parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
            "parent_unit_name": "parent-unit-name",
            "state": "ACTIVE",
            "type": "MEMBER"
        }
    ],
    "count": 20,
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.17.2 - 1.0

get /v1/organization-accounts

Description

get accounts list

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	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	id optional	조직 계정 ID Example : `b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0`	any of [string, null]	None
query	name optional	계정명 Example : `score-account`	any of [string, null]	None
query	email optional	계정 이메일 Example : `score@samsung.com`	any of [string, null]	None
query	login_id optional	로그인 ID Example : `log-archive@samsung.com`	any of [string, null]	None
query	joined_start_date optional	가입 조회 시작 일시 Example : `2024-05-17T12:34:56.789Z`	any of [string, null]	None
query	joined_end_date optional	가입 조회 종료 일시 Example : `2024-05-17T12:34:56.789Z`	any of [string, null]	None
query	joined_method optional	가입 방법 Example : `INVITED`	any of [enum (INVITED, CREATED, CLOUD_CONTROL), null]	None
query	exclude_policy_id optional	제외할 정책 ID Example : `238c2fc8c29a449dbfa8681f8f1d78e2`	any of [string, null]	None
query	parent_unit_id optional	ROOT 또는 부모 조직 단위 ID Example : `ou-fc8c29a138d78e24bf1fa86812fc8b`	any of [string, null]	None
query	parent_unit_name optional	ROOT 또는 부모 조직 단위명 Example : `parent-unit-name`	any of [string, null]	None
query	type optional	계정 유형 Example : `MEMBER`	any of [enum (MANAGEMENT, DELEGATION, MEMBER, NONE, LOG_ARCHIVE, AUDIT), null]	None

Responses

HTTP Code	Description	Schema
200	OK	AccountPageResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-accounts

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Example HTTP response

Response 200

{
    "accounts": [
        {
            "created_at": "2024-12-19 01:09:05.000",
            "created_by": "c23fb561c689455993874fa5d5ed4a2f",
            "email": "score@samsung.com",
            "id": "0a36e0746dbf4908acf0357829701381",
            "joined_method": "INVITED",
            "joined_time": "2024-05-17T12:34:56.789Z",
            "login_id": "log-archive@samsung.com",
            "modified_at": "2023-10-15 14:30:00",
            "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
            "name": "score-account",
            "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
            "parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
            "parent_unit_name": "parent-unit-name",
            "state": "ACTIVE",
            "type": "MEMBER"
        }
    ],
    "count": 20,
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.18 - ListOrganizationInvitations

1.18.1 - 1.1

get /v1/organization-invitations

Description

get organization invitation list

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	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	account_id optional	관리자 계정명 Example : `9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r`	any of [string, null]	None
query	account_name optional	관리자 계정명 Example : `CoreKim`	any of [string, null]	None
query	account_email optional	관리자 계정 이메일 Example : `admin@example.com`	any of [string, null]	None
query	state optional	초대 상태 Example : `INVITING`	any of [enum (INVITING, REFUSED, INVITED, CANCELED, EXPIRED), null]	None
query	login_id optional	로그인 ID Example : `log-archive@samsung.com`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	OrganizationInvitationPageResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-invitations

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Example HTTP response

Response 200

{
    "count": 20,
    "organization_invitations": [
        {
            "account_email": "admin@example.com",
            "account_name": "CoreKim",
            "created_at": "2024-12-19 01:09:05.000",
            "created_by": "c23fb561c689455993874fa5d5ed4a2f",
            "id": "0a36e0746dbf4908acf0357829701381",
            "login_id": "log-archive@samsung.com",
            "modified_at": "2023-10-15 14:30:00",
            "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
            "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
            "state": "INVITING",
            "target_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r"
        }
    ],
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.18.2 - 1.0

get /v1/organization-invitations

Description

get organization invitation list

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	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	account_id optional	관리자 계정명 Example : `9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r`	any of [string, null]	None
query	account_name optional	관리자 계정명 Example : `CoreKim`	any of [string, null]	None
query	account_email optional	관리자 계정 이메일 Example : `admin@example.com`	any of [string, null]	None
query	state optional	초대 상태 Example : `INVITING`	any of [enum (INVITING, REFUSED, INVITED, CANCELED, EXPIRED), null]	None
query	login_id optional	로그인 ID Example : `log-archive@samsung.com`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	OrganizationInvitationPageResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-invitations

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Example HTTP response

Response 200

{
    "count": 20,
    "organization_invitations": [
        {
            "account_email": "admin@example.com",
            "account_name": "CoreKim",
            "created_at": "2024-12-19 01:09:05.000",
            "created_by": "c23fb561c689455993874fa5d5ed4a2f",
            "id": "0a36e0746dbf4908acf0357829701381",
            "login_id": "log-archive@samsung.com",
            "modified_at": "2023-10-15 14:30:00",
            "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
            "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
            "state": "INVITING",
            "target_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r"
        }
    ],
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.19 - ListOrganizations

1.19.1 - 1.1

get /v1/organizations

Description

get organizations list

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	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	name optional	조직 이름 Example : `My Organization`	any of [string, null]	None
query	master_account_id optional	조직 계정 ID Example : `b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	OrganizationPageResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organizations

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Example HTTP response

Response 200

{
    "count": 20,
    "organizations": [
        {
            "created_at": "2024-12-19 01:09:05.000",
            "created_by": "c23fb561c689455993874fa5d5ed4a2f",
            "delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
            "id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
            "master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
            "modified_at": "2023-10-15 14:30:00",
            "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
            "name": "My Organization",
            "root_unit_id": "r-abcd7d6c5b4a3z2y1x0w9v8u7t6s5r",
            "use_scp_yn": true
        }
    ],
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.19.2 - 1.0

get /v1/organizations

Description

get organizations list

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	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	name optional	조직 이름 Example : `My Organization`	any of [string, null]	None
query	master_account_id optional	조직 계정 ID Example : `b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	OrganizationPageResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organizations

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Example HTTP response

Response 200

{
    "count": 20,
    "organizations": [
        {
            "created_at": "2024-12-19 01:09:05.000",
            "created_by": "c23fb561c689455993874fa5d5ed4a2f",
            "delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
            "id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
            "master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
            "modified_at": "2023-10-15 14:30:00",
            "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
            "name": "My Organization",
            "root_unit_id": "r-abcd7d6c5b4a3z2y1x0w9v8u7t6s5r",
            "use_scp_yn": true
        }
    ],
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.20 - ListOrganizationUnits

1.20.1 - 1.1

get /v1/organization-units

Description

get organization unit list

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	None
query	parent_unit_id required	ROOT 또는 부모 조직 단위 ID Example : `ou-fc8c29a138d78e24bf1fa86812fc8b`	string	None
query	name optional	조직 단위명 Example : `score-organization-unit`	any of [string, null]	None
query	exclude_policy_id optional	제외할 정책 ID Example : `238c2fc8c29a449dbfa8681f8f1d78e2`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	OrganizationUnitListResponseV1dot1
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-units?parent_unit_id={parent_unit_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Example HTTP response

Response 200

{
    "organization_units": [
        {
            "created_at": "2024-12-19 01:09:05.000",
            "depth": 1,
            "email": "score@samsung.com",
            "id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
            "joined_method": "INVITED",
            "joined_time": "2024-05-17T12:34:56.789Z",
            "login_id": "log-archive@samsung.com",
            "name": "score-organization-unit",
            "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
            "parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
            "parent_unit_name": "parent-unit-name",
            "type": "MEMBER"
        }
    ]
}

1.20.2 - 1.0

get /v1/organization-units

Description

get organization unit list

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	None
query	parent_unit_id required	ROOT 또는 부모 조직 단위 ID Example : `ou-fc8c29a138d78e24bf1fa86812fc8b`	string	None
query	name optional	조직 단위명 Example : `score-organization-unit`	any of [string, null]	None
query	exclude_policy_id optional	제외할 정책 ID Example : `238c2fc8c29a449dbfa8681f8f1d78e2`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	OrganizationUnitListResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-units?parent_unit_id={parent_unit_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Example HTTP response

Response 200

{
    "organization_units": [
        {
            "created_at": "2024-12-19 01:09:05.000",
            "depth": 1,
            "email": "score@samsung.com",
            "id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
            "joined_method": "INVITED",
            "joined_time": "2024-05-17T12:34:56.789Z",
            "login_id": "log-archive@samsung.com",
            "name": "score-organization-unit",
            "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
            "parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
            "type": "MEMBER"
        }
    ]
}

1.21 - ListParents

1.21.1 - 1.1

get /v1/organization-units/{unit_id}/parents

Description

get organization unit parent list

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	unit_id required	조직 단위 ID Example : `ou-c29a138f8f1d78e24dbfa8681fc2fc8`	string	None
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	OrganizationUnitParentsResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-units/{unit_id}/parents

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Example HTTP response

Response 200

{
    "parents": [
        {
            "created_at": "2024-12-19 01:09:05.000",
            "created_by": "c23fb561c689455993874fa5d5ed4a2f",
            "creator_name": "John Doe na",
            "depth": 1,
            "description": "에스코어 조직 단위",
            "id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
            "modified_at": "2023-10-15 14:30:00",
            "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
            "modifier_name": "Alice",
            "name": "score-organization-unit",
            "parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
            "service_name": "Organization",
            "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/ou/ou-c29a138f8f1d78e24dbfa8681fc2fc8",
            "type": "OU"
        }
    ]
}

1.21.2 - 1.0

get /v1/organization-units/{unit_id}/parents

Description

get organization unit parent list

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	unit_id required	조직 단위 ID Example : `ou-c29a138f8f1d78e24dbfa8681fc2fc8`	string	None
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	OrganizationUnitParentsResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-units/{unit_id}/parents

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Example HTTP response

Response 200

{
    "parents": [
        {
            "created_at": "2024-12-19 01:09:05.000",
            "created_by": "c23fb561c689455993874fa5d5ed4a2f",
            "creator_name": "John Doe na",
            "depth": 1,
            "description": "에스코어 조직 단위",
            "id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
            "modified_at": "2023-10-15 14:30:00",
            "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
            "modifier_name": "Alice",
            "name": "score-organization-unit",
            "parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
            "service_name": "Organization",
            "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/ou/ou-c29a138f8f1d78e24dbfa8681fc2fc8",
            "type": "OU"
        }
    ]
}

1.22 - ListPoliciesForTarget

1.22.1 - 1.1

get /v1/assignments/policies

Description

list policies for target

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	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	target_id required	타겟 ID Example : `ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5`	string	None
query	policy_category optional	정책 카테고리 Example : `SCP`	any of [enum (SCP, RCP, TAG, DGP), null]	SCP
query	name optional	제어 정책 이름 Example : `test-policy-name`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ListPoliciesForTargetResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/assignments/policies?target_id={target_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "policies": [
        {
            "created_at": "2024-12-19 01:09:05.000",
            "created_by": "c23fb561c689455993874fa5d5ed4a2f",
            "id": "0a36e0746dbf4908acf0357829701381",
            "link_types": {
                "DIRECTED": [
                    {
                        "target_id": "1a2b3c4d5e6f7g8h9i0j1k2l3m4n5",
                        "target_name": "example-target",
                        "target_type": "OU"
                    }
                ],
                "INHERITED": [
                    {
                        "target_id": "2a2b3c4d5e6f7g8h9i0j1k2l3m4n5",
                        "target_name": "root",
                        "target_type": "ROOT"
                    }
                ]
            },
            "modified_at": "2023-10-15 14:30:00",
            "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
            "policy_name": "test-policy-name",
            "policy_type": "SYSTEM_MANAGED",
            "source": "ORGANIZATION"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.22.2 - 1.0

get /v1/assignments/policies

Description

list policies for target

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	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	target_id required	타겟 ID Example : `ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5`	string	None
query	policy_category optional	정책 카테고리 Example : `SCP`	any of [enum (SCP, RCP, TAG, DGP), null]	SCP
query	name optional	제어 정책 이름 Example : `test-policy-name`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ListPoliciesForTargetResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/assignments/policies?target_id={target_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "policies": [
        {
            "created_at": "2024-12-19 01:09:05.000",
            "created_by": "c23fb561c689455993874fa5d5ed4a2f",
            "id": "0a36e0746dbf4908acf0357829701381",
            "link_types": {
                "DIRECTED": [
                    {
                        "target_id": "1a2b3c4d5e6f7g8h9i0j1k2l3m4n5",
                        "target_name": "example-target",
                        "target_type": "OU"
                    }
                ],
                "INHERITED": [
                    {
                        "target_id": "2a2b3c4d5e6f7g8h9i0j1k2l3m4n5",
                        "target_name": "root",
                        "target_type": "ROOT"
                    }
                ]
            },
            "modified_at": "2023-10-15 14:30:00",
            "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
            "policy_name": "test-policy-name",
            "policy_type": "SYSTEM_MANAGED",
            "source": "ORGANIZATION"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.23 - ListServiceControlPolicies

1.23.1 - 1.1

get /v1/service-control-policies

Description

get service control policies list

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
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	organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string	None
query	id optional	서비스 제어 정책 ID Example : `138c2fc8c29a449dbfa8681f8f1d78e2`	any of [string, null]	None
query	name optional	서비스 제어 정책 이름 Example : `MyPolicy`	any of [array[string], string, null]	None
query	type optional	서비스 제어 정책 유형 Example : `MANAGED`	any of [enum (SYSTEM_MANAGED, USER_DEFINED), null]	None
query	exclude_target_id optional	제외 대상 ID Example : `112c2fc8c29a449dbfa8681f8f1d7442`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ServiceControlPolicyPageResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/service-control-policies?organization_id={organization_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "policies": [
        {
            "category": "SCP",
            "created_at": "2024-12-19 01:09:05.000",
            "created_by": "c23fb561c689455993874fa5d5ed4a2f",
            "creator_name": "John Doe na",
            "description": "This is an example policy.",
            "document": {
                "Statement": [
                    {
                        "Action": [
                            "*"
                        ],
                        "Effect": "Allow",
                        "Resource": [
                            "*"
                        ],
                        "Sid": "statement1"
                    }
                ],
                "Version": "2024-07-01"
            },
            "id": "138c2fc8c29a449dbfa8681f8f1d78e2",
            "modified_at": "2023-10-15 14:30:00",
            "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
            "modifier_name": "Alice",
            "name": "MyPolicy",
            "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
            "source": "ORGANIZATION",
            "state": "ACTIVE",
            "type": "MANAGED"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.23.2 - 1.0

get /v1/service-control-policies

Description

get service control policies list

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
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	organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string	None
query	id optional	서비스 제어 정책 ID Example : `138c2fc8c29a449dbfa8681f8f1d78e2`	any of [string, null]	None
query	name optional	서비스 제어 정책 이름 Example : `MyPolicy`	any of [array[string], string, null]	None
query	type optional	서비스 제어 정책 유형 Example : `MANAGED`	any of [enum (SYSTEM_MANAGED, USER_DEFINED), null]	None
query	exclude_target_id optional	제외 대상 ID Example : `112c2fc8c29a449dbfa8681f8f1d7442`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ServiceControlPolicyPageResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/service-control-policies?organization_id={organization_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "policies": [
        {
            "category": "SCP",
            "created_at": "2024-12-19 01:09:05.000",
            "created_by": "c23fb561c689455993874fa5d5ed4a2f",
            "creator_name": "John Doe na",
            "description": "This is an example policy.",
            "document": {
                "Statement": [
                    {
                        "Action": [
                            "*"
                        ],
                        "Effect": "Allow",
                        "Resource": [
                            "*"
                        ],
                        "Sid": "statement1"
                    }
                ],
                "Version": "2024-07-01"
            },
            "id": "138c2fc8c29a449dbfa8681f8f1d78e2",
            "modified_at": "2023-10-15 14:30:00",
            "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
            "modifier_name": "Alice",
            "name": "MyPolicy",
            "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
            "source": "ORGANIZATION",
            "state": "ACTIVE",
            "type": "MANAGED"
        }
    ],
    "size": 20,
    "sort": [
        "created_at:asc"
    ]
}

1.24 - ListTargetsForPolicy

1.24.1 - 1.1

get /v1/assignments/targets

Description

list targets for policy

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	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	policy_id required	제어 정책 ID Example : `f98e76d54c32b10a9z8y7x6w5v4u3`	string	None
query	policy_category optional	정책 카테고리 Example : `SCP`	any of [enum (SCP, RCP, TAG, DGP), null]	SCP
query	target_type required	타겟 유형 Example : `OU`	enum (ROOT, ACCOUNT, OU)	None
query	name optional	타겟명 Example : `example-target`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ListTargetsForPolicyResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/assignments/targets?policy_id={policy_id}&target_type={target_type}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ],
    "targets": [
        {
            "control_policies": [
                {
                    "policy_id": "f98e76d54c32b10a9z8y7x6w5v4u3",
                    "policy_name": "test-policy-name"
                }
            ],
            "created_at": "2024-12-19 01:09:05.000",
            "created_by": "c23fb561c689455993874fa5d5ed4a2f",
            "id": "0a36e0746dbf4908acf0357829701381",
            "modified_at": "2023-10-15 14:30:00",
            "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
            "target_name": "example-target"
        }
    ]
}

1.24.2 - 1.0

get /v1/assignments/targets

Description

list targets for policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	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	policy_id required	제어 정책 ID Example : `f98e76d54c32b10a9z8y7x6w5v4u3`	string	None
query	policy_category optional	정책 카테고리 Example : `SCP`	any of [enum (SCP, RCP, TAG, DGP), null]	SCP
query	target_type required	타겟 유형 Example : `OU`	enum (ROOT, ACCOUNT, OU)	None
query	name optional	타겟명 Example : `example-target`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ListTargetsForPolicyResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/assignments/targets?policy_id={policy_id}&target_type={target_type}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Example HTTP response

Response 200

{
    "count": 20,
    "page": 0,
    "size": 20,
    "sort": [
        "created_at:asc"
    ],
    "targets": [
        {
            "control_policies": [
                {
                    "policy_id": "f98e76d54c32b10a9z8y7x6w5v4u3",
                    "policy_name": "test-policy-name"
                }
            ],
            "created_at": "2024-12-19 01:09:05.000",
            "created_by": "c23fb561c689455993874fa5d5ed4a2f",
            "id": "0a36e0746dbf4908acf0357829701381",
            "modified_at": "2023-10-15 14:30:00",
            "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
            "target_name": "example-target"
        }
    ]
}

1.25 - MoveAccount

1.25.1 - 1.1

put /v1/organization-accounts/parent

Description

move a specific account to a different OU

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		MoveAccountRequest

Responses

HTTP Code	Description	Schema
200	OK	AccountMoveResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-accounts/parent

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Request body

{
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
    "parent_unit_id": "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5",
    "target_account_ids": [
        "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0"
    ]
}

Example HTTP response

Response 200

{
    "success_ids": [
        {
            "success_id": "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
            "success_name": "score-account",
            "target_id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
            "target_name": "score-organization-unit"
        }
    ]
}

1.25.2 - 1.0

put /v1/organization-accounts/parent

Description

move a specific account to a different OU

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		MoveAccountRequest

Responses

HTTP Code	Description	Schema
200	OK	AccountMoveResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-accounts/parent

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Request body

{
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
    "parent_unit_id": "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5",
    "target_account_ids": [
        "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0"
    ]
}

Example HTTP response

Response 200

{
    "success_ids": [
        {
            "success_id": "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
            "success_name": "score-account",
            "target_id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
            "target_name": "score-organization-unit"
        }
    ]
}

1.26 - RemoveAccounts

1.26.1 - 1.1

delete /v1/organization-accounts

Description

Remove accounts from organization

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		RemoveAccountsRequest

Responses

HTTP Code	Description	Schema
200	OK	AccountRemoveResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-accounts

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Request body

{
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
    "target_account_ids": [
        "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0"
    ]
}

Example HTTP response

Response 200

{
    "failed_ids": [
        {
            "error_code": "Organization.AccountNotRemovable",
            "failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found",
            "failed_id": "1a5xz23h1j0l9n8p7r6t5v4x3z2y1w0",
            "failed_name": "score-account"
        }
    ],
    "success_ids": [
        {
            "success_id": "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
            "success_name": "score-account"
        }
    ]
}

1.26.2 - 1.0

delete /v1/organization-accounts

Description

Remove accounts from organization

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		RemoveAccountsRequest

Responses

HTTP Code	Description	Schema
200	OK	AccountRemoveResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-accounts

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Request body

{
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
    "target_account_ids": [
        "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0"
    ]
}

Example HTTP response

Response 200

{
    "failed_ids": [
        {
            "error_code": "Organization.AccountNotRemovable",
            "failed_caused": "Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found",
            "failed_id": "1a5xz23h1j0l9n8p7r6t5v4x3z2y1w0",
            "failed_name": "score-account"
        }
    ],
    "success_ids": [
        {
            "success_id": "b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
            "success_name": "score-account"
        }
    ]
}

1.27 - RemovePolicyBindings

1.27.1 - 1.1

delete /v1/assignments/policy-bindings

Description

remove policy bindings

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		PolicyRemoveRequest

Responses

HTTP Code	Description	Schema
200	OK	ControlPolicyAssignmentResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/assignments/policy-bindings

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Request body

{
    "entity": "POLICY",
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
    "policy_ids": [
        "f98e76d54c32b10a9z8y7x6w5v4u3"
    ],
    "target_ids": [
        "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
    ]
}

Example HTTP response

Response 200

{
    "failed_ids": [
        {
            "error_code": "Conflict",
            "failed_caused": "Account 482d111a302547fbbd11ee0141ea23bb is not found",
            "failed_id": "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
        }
    ],
    "success_ids": [
        "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
    ]
}

1.27.2 - 1.0

delete /v1/assignments/policy-bindings

Description

remove policy bindings

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		PolicyRemoveRequest

Responses

HTTP Code	Description	Schema
200	OK	ControlPolicyAssignmentResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/assignments/policy-bindings

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Request body

{
    "entity": "POLICY",
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
    "policy_ids": [
        "f98e76d54c32b10a9z8y7x6w5v4u3"
    ],
    "target_ids": [
        "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
    ]
}

Example HTTP response

Response 200

{
    "failed_ids": [
        {
            "error_code": "Conflict",
            "failed_caused": "Account 482d111a302547fbbd11ee0141ea23bb is not found",
            "failed_id": "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
        }
    ],
    "success_ids": [
        "ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5"
    ]
}

1.28 - SetDelegationPolicy

1.28.1 - 1.1

put /v1/delegation-policies

Description

set a specific delegation policy

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
body	body required		DelegationPolicySetRequest

Responses

HTTP Code	Description	Schema
200	OK	DelegationPolicyShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/delegation-policies

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Request body

{
    "document": {
        "Statement": [
            {
                "Action": [
                    "organization:CreateServiceControlPolicy",
                    "organization:DeleteServiceControlPolicies",
                    "organization:SetServiceControlPolicy",
                    "organization:ShowServiceControlPolicy",
                    "organization:ListServiceControlPolicies",
                    "organization:ShowAccount",
                    "organization:ListAccounts",
                    "organization:ListOrganizationUnits",
                    "organization:ListOrganizationInvitations",
                    "organization:ListParents",
                    "organization:ListPoliciesForTarget",
                    "organization:ListTargetsForPolicy",
                    "organization:AttachPolicyBindings",
                    "organization:RemovePolicyBindings",
                    "organization:ShowDelegatePolicy"
                ],
                "Effect": "Allow",
                "Principal": {
                    "scp": [
                        "srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
                    ]
                },
                "Resource": [
                    "*"
                ],
                "Sid": "statement1"
            }
        ],
        "Version": "2024-07-01"
    },
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}

Example HTTP response

Response 200

{
    "policy": {
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "document": {
            "Statement": [
                {
                    "Action": [
                        "organization:CreateServiceControlPolicy",
                        "organization:DeleteServiceControlPolicies",
                        "organization:SetServiceControlPolicy",
                        "organization:ShowServiceControlPolicy",
                        "organization:ListServiceControlPolicies",
                        "organization:ShowAccount",
                        "organization:ListAccounts",
                        "organization:ListOrganizationUnits",
                        "organization:ListOrganizationInvitations",
                        "organization:ListParents",
                        "organization:ListPoliciesForTarget",
                        "organization:ListTargetsForPolicy",
                        "organization:AttachPolicyBindings",
                        "organization:RemovePolicyBindings",
                        "organization:ShowDelegatePolicy"
                    ],
                    "Effect": "Allow",
                    "Principal": {
                        "scp": [
                            "srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
                        ]
                    },
                    "Resource": [
                        "*"
                    ],
                    "Sid": "statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
    }
}

1.28.2 - 1.0

put /v1/delegation-policies

Description

set a specific delegation policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
body	body required		DelegationPolicySetRequest

Responses

HTTP Code	Description	Schema
200	OK	DelegationPolicyShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/delegation-policies

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Request body

{
    "document": {
        "Statement": [
            {
                "Action": [
                    "organization:CreateServiceControlPolicy",
                    "organization:DeleteServiceControlPolicies",
                    "organization:SetServiceControlPolicy",
                    "organization:ShowServiceControlPolicy",
                    "organization:ListServiceControlPolicies",
                    "organization:ShowAccount",
                    "organization:ListAccounts",
                    "organization:ListOrganizationUnits",
                    "organization:ListOrganizationInvitations",
                    "organization:ListParents",
                    "organization:ListPoliciesForTarget",
                    "organization:ListTargetsForPolicy",
                    "organization:AttachPolicyBindings",
                    "organization:RemovePolicyBindings",
                    "organization:ShowDelegatePolicy"
                ],
                "Effect": "Allow",
                "Principal": {
                    "scp": [
                        "srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
                    ]
                },
                "Resource": [
                    "*"
                ],
                "Sid": "statement1"
            }
        ],
        "Version": "2024-07-01"
    },
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}

Example HTTP response

Response 200

{
    "policy": {
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "document": {
            "Statement": [
                {
                    "Action": [
                        "organization:CreateServiceControlPolicy",
                        "organization:DeleteServiceControlPolicies",
                        "organization:SetServiceControlPolicy",
                        "organization:ShowServiceControlPolicy",
                        "organization:ListServiceControlPolicies",
                        "organization:ShowAccount",
                        "organization:ListAccounts",
                        "organization:ListOrganizationUnits",
                        "organization:ListOrganizationInvitations",
                        "organization:ListParents",
                        "organization:ListPoliciesForTarget",
                        "organization:ListTargetsForPolicy",
                        "organization:AttachPolicyBindings",
                        "organization:RemovePolicyBindings",
                        "organization:ShowDelegatePolicy"
                    ],
                    "Effect": "Allow",
                    "Principal": {
                        "scp": [
                            "srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
                        ]
                    },
                    "Resource": [
                        "*"
                    ],
                    "Sid": "statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
    }
}

1.29 - SetOrganization

1.29.1 - 1.1

put /v1/organizations/{organization_id}

Description

set a specific organization

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string	None
body	body required		OrganizationSetRequest

Responses

HTTP Code	Description	Schema
200	OK	OrganizationShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/organizations/{organization_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Request body

{
    "delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
    "name": "My Organization",
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
    "use_scp_yn": true
}

Example HTTP response

Response 200

{
    "organization": {
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "master_account_email": "admin@example.com",
        "master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "My Organization",
        "root_unit_id": "r-abcd7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/organization/o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "use_scp_yn": true
    }
}

1.29.2 - 1.0

put /v1/organizations/{organization_id}

Description

set a specific organization

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string	None
body	body required		OrganizationSetRequest

Responses

HTTP Code	Description	Schema
200	OK	OrganizationShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None
409	Conflict	None

Example HTTP request

Request path

/v1/organizations/{organization_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Request body

{
    "delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
    "name": "My Organization",
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
    "use_scp_yn": true
}

Example HTTP response

Response 200

{
    "organization": {
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "master_account_email": "admin@example.com",
        "master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "My Organization",
        "root_unit_id": "r-abcd7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/organization/o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "use_scp_yn": true
    }
}

1.30 - SetOrganizationUnit

1.30.1 - 1.1

put /v1/organization-units/{unit_id}

Description

set a specific organization unit

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	unit_id required	조직 단위 ID Example : `ou-c29a138f8f1d78e24dbfa8681fc2fc8`	string	None
body	body required		OrganizationUnitSetRequest

Responses

HTTP Code	Description	Schema
200	OK	OrganizationUnitShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-units/{unit_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Request body

{
    "description": "에스코어 조직 단위",
    "name": "score-organization-unit",
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}

Example HTTP response

Response 200

{
    "organization_unit": {
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "depth": 1,
        "description": "에스코어 조직 단위",
        "id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "score-organization-unit",
        "parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
        "service_name": "Organization",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/ou/ou-c29a138f8f1d78e24dbfa8681fc2fc8",
        "type": "OU"
    }
}

1.30.2 - 1.0

put /v1/organization-units/{unit_id}

Description

set a specific organization unit

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	unit_id required	조직 단위 ID Example : `ou-c29a138f8f1d78e24dbfa8681fc2fc8`	string	None
body	body required		OrganizationUnitSetRequest

Responses

HTTP Code	Description	Schema
200	OK	OrganizationUnitShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-units/{unit_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Request body

{
    "description": "에스코어 조직 단위",
    "name": "score-organization-unit",
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}

Example HTTP response

Response 200

{
    "organization_unit": {
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "depth": 1,
        "description": "에스코어 조직 단위",
        "id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "score-organization-unit",
        "parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
        "service_name": "Organization",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/ou/ou-c29a138f8f1d78e24dbfa8681fc2fc8",
        "type": "OU"
    }
}

1.31 - SetServiceControlPolicy

1.31.1 - 1.1

put /v1/service-control-policies/{policy_id}

Description

set a specific service control policy

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	policy_id required	서비스 제어 정책 ID Example : `138c2fc8c29a449dbfa8681f8f1d78e2`	string	None
body	body required		ServiceControlPolicySetRequest

Responses

HTTP Code	Description	Schema
200	OK	ServiceControlPolicyShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/service-control-policies/{policy_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Request body

{
    "description": "This is an example policy.",
    "document": {
        "Statement": [
            {
                "Action": [
                    "*"
                ],
                "Effect": "Allow",
                "Resource": [
                    "*"
                ],
                "Sid": "statement1"
            }
        ],
        "Version": "2024-07-01"
    },
    "name": "MyPolicy",
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}

Example HTTP response

Response 200

{
    "policy": {
        "category": "SCP",
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "description": "This is an example policy.",
        "document": {
            "Statement": [
                {
                    "Action": [
                        "*"
                    ],
                    "Effect": "Allow",
                    "Resource": [
                        "*"
                    ],
                    "Sid": "statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "id": "138c2fc8c29a449dbfa8681f8f1d78e2",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "MyPolicy",
        "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "service_name": "Organization",
        "source": "ORGANIZATION",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/service-control-policy/138c2fc8c29a449dbfa8681f8f1d78e2",
        "state": "ACTIVE",
        "type": "MANAGED"
    }
}

1.31.2 - 1.0

put /v1/service-control-policies/{policy_id}

Description

set a specific service control policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	policy_id required	서비스 제어 정책 ID Example : `138c2fc8c29a449dbfa8681f8f1d78e2`	string	None
body	body required		ServiceControlPolicySetRequest

Responses

HTTP Code	Description	Schema
200	OK	ServiceControlPolicyShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/service-control-policies/{policy_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Request body

{
    "description": "This is an example policy.",
    "document": {
        "Statement": [
            {
                "Action": [
                    "*"
                ],
                "Effect": "Allow",
                "Resource": [
                    "*"
                ],
                "Sid": "statement1"
            }
        ],
        "Version": "2024-07-01"
    },
    "name": "MyPolicy",
    "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
}

Example HTTP response

Response 200

{
    "policy": {
        "category": "SCP",
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "description": "This is an example policy.",
        "document": {
            "Statement": [
                {
                    "Action": [
                        "*"
                    ],
                    "Effect": "Allow",
                    "Resource": [
                        "*"
                    ],
                    "Sid": "statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "id": "138c2fc8c29a449dbfa8681f8f1d78e2",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "MyPolicy",
        "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "service_name": "Organization",
        "source": "ORGANIZATION",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/service-control-policy/138c2fc8c29a449dbfa8681f8f1d78e2",
        "state": "ACTIVE",
        "type": "MANAGED"
    }
}

1.32 - ShowAccount

1.32.1 - 1.1

get /v1/organization-accounts/{account_id}

Description

show a specific account

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	account_id required	조직 계정 ID Example : `b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0`	string	None
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	None
query	lazy_policy optional	연결된 정책 조회 여부 Example : `True`	any of [boolean, null]	True

Responses

HTTP Code	Description	Schema
200	OK	AccountShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-accounts/{account_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Example HTTP response

Response 200

{
    "account": {
        "control_policies": [
            {
                "policy_id": "f98e76d54c32b10a9z8y7x6w5v4u3",
                "policy_name": "test-policy-name"
            }
        ],
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "email": "score@samsung.com",
        "id": "0a36e0746dbf4908acf0357829701381",
        "joined_method": "INVITED",
        "joined_time": "2024-05-17T12:34:56.789Z",
        "login_id": "log-archive@samsung.com",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "score-account",
        "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
        "parent_unit_name": "parent-unit-name",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/account/b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
        "state": "ACTIVE",
        "type": "MEMBER"
    }
}

1.32.2 - 1.0

get /v1/organization-accounts/{account_id}

Description

show a specific account

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	account_id required	조직 계정 ID Example : `b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0`	string	None
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	None
query	lazy_policy optional	연결된 정책 조회 여부 Example : `True`	any of [boolean, null]	True

Responses

HTTP Code	Description	Schema
200	OK	AccountShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-accounts/{account_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Example HTTP response

Response 200

{
    "account": {
        "control_policies": [
            {
                "policy_id": "f98e76d54c32b10a9z8y7x6w5v4u3",
                "policy_name": "test-policy-name"
            }
        ],
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "email": "score@samsung.com",
        "id": "0a36e0746dbf4908acf0357829701381",
        "joined_method": "INVITED",
        "joined_time": "2024-05-17T12:34:56.789Z",
        "login_id": "log-archive@samsung.com",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "score-account",
        "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
        "parent_unit_name": "parent-unit-name",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/account/b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0",
        "state": "ACTIVE",
        "type": "MEMBER"
    }
}

1.33 - ShowDelegationPolicy

1.33.1 - 1.1

get /v1/delegation-policies

Description

show a specific delegation policy

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	DelegationPolicyShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/delegation-policies

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Example HTTP response

Response 200

{
    "policy": {
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "document": {
            "Statement": [
                {
                    "Action": [
                        "organization:CreateServiceControlPolicy",
                        "organization:DeleteServiceControlPolicies",
                        "organization:SetServiceControlPolicy",
                        "organization:ShowServiceControlPolicy",
                        "organization:ListServiceControlPolicies",
                        "organization:ShowAccount",
                        "organization:ListAccounts",
                        "organization:ListOrganizationUnits",
                        "organization:ListOrganizationInvitations",
                        "organization:ListParents",
                        "organization:ListPoliciesForTarget",
                        "organization:ListTargetsForPolicy",
                        "organization:AttachPolicyBindings",
                        "organization:RemovePolicyBindings",
                        "organization:ShowDelegatePolicy"
                    ],
                    "Effect": "Allow",
                    "Principal": {
                        "scp": [
                            "srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
                        ]
                    },
                    "Resource": [
                        "*"
                    ],
                    "Sid": "statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
    }
}

1.33.2 - 1.0

get /v1/delegation-policies

Description

show a specific delegation policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	DelegationPolicyShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/delegation-policies

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Example HTTP response

Response 200

{
    "policy": {
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "document": {
            "Statement": [
                {
                    "Action": [
                        "organization:CreateServiceControlPolicy",
                        "organization:DeleteServiceControlPolicies",
                        "organization:SetServiceControlPolicy",
                        "organization:ShowServiceControlPolicy",
                        "organization:ListServiceControlPolicies",
                        "organization:ShowAccount",
                        "organization:ListAccounts",
                        "organization:ListOrganizationUnits",
                        "organization:ListOrganizationInvitations",
                        "organization:ListParents",
                        "organization:ListPoliciesForTarget",
                        "organization:ListTargetsForPolicy",
                        "organization:AttachPolicyBindings",
                        "organization:RemovePolicyBindings",
                        "organization:ShowDelegatePolicy"
                    ],
                    "Effect": "Allow",
                    "Principal": {
                        "scp": [
                            "srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df"
                        ]
                    },
                    "Resource": [
                        "*"
                    ],
                    "Sid": "statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5"
    }
}

1.34 - ShowOrganization

1.34.1 - 1.1

get /v1/organizations/{organization_id}

Description

show a specific organization

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string	None

Responses

HTTP Code	Description	Schema
200	OK	OrganizationShowResponse
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organizations/{organization_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Example HTTP response

Response 200

{
    "organization": {
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "master_account_email": "admin@example.com",
        "master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "My Organization",
        "root_unit_id": "r-abcd7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/organization/o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "use_scp_yn": true
    }
}

1.34.2 - 1.0

get /v1/organizations/{organization_id}

Description

show a specific organization

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string	None

Responses

HTTP Code	Description	Schema
200	OK	OrganizationShowResponse
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organizations/{organization_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Example HTTP response

Response 200

{
    "organization": {
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "delegation_account_id": "124e7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "master_account_email": "admin@example.com",
        "master_account_id": "9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "My Organization",
        "root_unit_id": "r-abcd7d6c5b4a3z2y1x0w9v8u7t6s5r",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/organization/o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "use_scp_yn": true
    }
}

1.35 - ShowOrganizationUnit

1.35.1 - 1.1

get /v1/organization-units/{unit_id}

Description

show a specific organization unit

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	unit_id required	조직 단위 ID Example : `ou-c29a138f8f1d78e24dbfa8681fc2fc8`	string	None
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	OrganizationUnitShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-units/{unit_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Example HTTP response

Response 200

{
    "organization_unit": {
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "depth": 1,
        "description": "에스코어 조직 단위",
        "id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "score-organization-unit",
        "parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
        "service_name": "Organization",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/ou/ou-c29a138f8f1d78e24dbfa8681fc2fc8",
        "type": "OU"
    }
}

1.35.2 - 1.0

get /v1/organization-units/{unit_id}

Description

show a specific organization unit

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	unit_id required	조직 단위 ID Example : `ou-c29a138f8f1d78e24dbfa8681fc2fc8`	string	None
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	OrganizationUnitShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/organization-units/{unit_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Example HTTP response

Response 200

{
    "organization_unit": {
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "depth": 1,
        "description": "에스코어 조직 단위",
        "id": "ou-c29a138f8f1d78e24dbfa8681fc2fc8",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "score-organization-unit",
        "parent_unit_id": "ou-fc8c29a138d78e24bf1fa86812fc8b",
        "service_name": "Organization",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/ou/ou-c29a138f8f1d78e24dbfa8681fc2fc8",
        "type": "OU"
    }
}

1.36 - ShowServiceControlPolicy

1.36.1 - 1.1

get /v1/service-control-policies/{policy_id}

Description

show a specific service control policy

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Type	Name	Description	Schema	Default
path	policy_id required	서비스 제어 정책 ID Example : `138c2fc8c29a449dbfa8681f8f1d78e2`	string	None
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ServiceControlPolicyShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/service-control-policies/{policy_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.1"

Example HTTP response

Response 200

{
    "policy": {
        "category": "SCP",
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "description": "This is an example policy.",
        "document": {
            "Statement": [
                {
                    "Action": [
                        "*"
                    ],
                    "Effect": "Allow",
                    "Resource": [
                        "*"
                    ],
                    "Sid": "statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "id": "138c2fc8c29a449dbfa8681f8f1d78e2",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "MyPolicy",
        "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "service_name": "Organization",
        "source": "ORGANIZATION",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/service-control-policy/138c2fc8c29a449dbfa8681f8f1d78e2",
        "state": "ACTIVE",
        "type": "MANAGED"
    }
}

1.36.2 - 1.0

get /v1/service-control-policies/{policy_id}

Description

show a specific service control policy

State ACTIVE (DEPRECATED)

Version	Supported Until
1.0	20251231

Parameters

Type	Name	Description	Schema	Default
path	policy_id required	서비스 제어 정책 ID Example : `138c2fc8c29a449dbfa8681f8f1d78e2`	string	None
query	organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]	None

Responses

HTTP Code	Description	Schema
200	OK	ServiceControlPolicyShowResponse
400	Bad Request	None
403	Forbidden	None
404	Not Found	None

Example HTTP request

Request path

/v1/service-control-policies/{policy_id}

Request header

"Scp-Accesskey = 2sd2gg=2agbdSD26svcD",
"Scp-Signature = fsfsdf235f9U35sdgf35Xsf/qgsdgsdg326=sfsdr23rsef=",
"Scp-Timestamp = 1605290625682",
"Scp-ClientType = Openapi",
"Accept-Language = en-US",
"Scp-Api-Version = organization 1.0"

Example HTTP response

Response 200

{
    "policy": {
        "category": "SCP",
        "created_at": "2024-12-19 01:09:05.000",
        "created_by": "c23fb561c689455993874fa5d5ed4a2f",
        "creator_name": "John Doe na",
        "description": "This is an example policy.",
        "document": {
            "Statement": [
                {
                    "Action": [
                        "*"
                    ],
                    "Effect": "Allow",
                    "Resource": [
                        "*"
                    ],
                    "Sid": "statement1"
                }
            ],
            "Version": "2024-07-01"
        },
        "id": "138c2fc8c29a449dbfa8681f8f1d78e2",
        "modified_at": "2023-10-15 14:30:00",
        "modified_by": "c23fb561c689455993874fa5d5ed4a2f",
        "modifier_name": "Alice",
        "name": "MyPolicy",
        "organization_id": "o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5",
        "service_name": "Organization",
        "source": "ORGANIZATION",
        "srn": "srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/service-control-policy/138c2fc8c29a449dbfa8681f8f1d78e2",
        "state": "ACTIVE",
        "type": "MANAGED"
    }
}

2 - Models

2.1 - AccountCreateResponse

Name	Description	Schema	Default
failed optional	계정 생성 실패 정보	any of [CreateAccountFailCaused, null]
success optional	계정 생성 성공 정보	any of [CreateAccountSuccess, null]

2.2 - AccountInvitation

Name	Description	Schema
created_at required	생성 일시 Example : `2024-12-19 01:09:05.000`	string (date-time)
created_by required	생성자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
expired_time required	초대 만료 일시 Example : `2024-04-30T12:34:56.789Z`	string (date-time)
id required	ID Example : `0a36e0746dbf4908acf0357829701381`	string
master_account_email optional	관리자 계정 이메일 Example : `admin@example.com`	any of [string, null]
master_account_id required	관리자 계정명 Example : `9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r`	string
master_account_login_id optional	로그인 ID Example : `log-archive@samsung.com`	any of [string, null]
master_account_name optional	관리자 계정명 Example : `CoreKim`	any of [string, null]
modified_at required	수정 일시 Example : `2023-10-15 14:30:00`	string (date-time)
modified_by required	수정자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string
organization_name required	조직 이름 Example : `My Organization`	string
requested_time required	초대 요청 일시 Example : `2024-04-17T12:34:56.789Z`	string (date-time)
state required	초대 상태 Example : `INVITING`	enum (INVITING, REFUSED, INVITED, CANCELED, EXPIRED)
target_account_id required	초대 수신자 계정 ID Example : `338c2fc8c29a449dbfa8681f8f1d78e5`	string

2.3 - AccountInvitationResponse

Name	Description	Schema	Default
account_invitations required	받은 초대 목록	array[AccountInvitation]
count required	받은 초대 수 Example : `5`	integer

2.4 - AccountMoveResponse

Name	Description	Schema	Default
success_ids required	계정 ID 목록	array[MoveAccountSuccess]

2.5 - AccountPageResponse

Name	Description	Schema
accounts required	조직 계정 목록	array[AccountSummary]
count required	count Example : `20`	integer
page required	page Example : `0`	integer
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]

2.6 - AccountRemoveResponse

Name	Description	Schema	Default
failed_ids required	실패 사유	array[RemoveAccountFailCaused]
success_ids required	계정 ID 목록	array[RemoveAccountSuccess]

2.7 - AccountShowResponse

Name	Description	Schema	Default
account required	조직 계정 상세 정보	OrganizationAccountWithPolicy

2.8 - AccountSummary

Name	Description	Schema
created_at required	생성 일시 Example : `2024-12-19 01:09:05.000`	string (date-time)
created_by required	생성자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
email optional	계정 이메일 Example : `score@samsung.com`	any of [string, null]
id required	ID Example : `0a36e0746dbf4908acf0357829701381`	string
joined_method required	가입 방법 Example : `INVITED`	enum (INVITED, CREATED, CLOUD_CONTROL)
joined_time required	가입 일시 Example : `2024-05-17T12:34:56.789Z`	string (date-time)
login_id optional	로그인 ID Example : `log-archive@samsung.com`	any of [string, null]
modified_at required	수정 일시 Example : `2023-10-15 14:30:00`	string (date-time)
modified_by required	수정자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
name optional	계정명 Example : `score-account`	any of [string, null]
organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string
parent_unit_id required	ROOT 또는 부모 조직 단위 ID Example : `ou-fc8c29a138d78e24bf1fa86812fc8b`	string
parent_unit_name required	ROOT 또는 부모 조직 단위명 Example : `parent-unit-name`	any of [string, null]
state required	계정 상태 Example : `ACTIVE`	enum (ACTIVE, SUSPENDED, PENDING_CLOSURE)
type required	계정 유형 Example : `MEMBER`	enum (MANAGEMENT, DELEGATION, MEMBER, NONE, LOG_ARCHIVE, AUDIT)

2.9 - BindingTarget

Name	Description	Schema
id required	조직 단위 ID 또는 조직 계정 ID Example : `ou-c29a138f8f1d78e24dbfa8681fc2fc8 또는 b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0`	any of [string, null]
name required	조직 단위명 또는 계정명 Example : `score-organization-unit 또는 score-account`	any of [string, null]
type required	타겟 유형 Example : `OU`	any of [string, null]

2.10 - CombinedUnit

Name	Description	Schema	Default
created_at optional	생성 일시 Example : `2024-12-19 01:09:05.000`	any of [string (date-time), null]
depth optional	계층(0~5) Example : `1`	any of [integer, null]	1
email optional	계정 이메일 Example : `score@samsung.com`	any of [string, null]
id required	조직 단위 ID 또는 조직 계정 ID Example : `ou-c29a138f8f1d78e24dbfa8681fc2fc8`	string
joined_method optional	가입 방법 Example : `INVITED`	any of [enum (INVITED, CREATED, CLOUD_CONTROL), null]
joined_time optional	가입 일시 Example : `2024-05-17T12:34:56.789Z`	any of [string (date-time), null]
login_id optional	로그인 ID Example : `log-archive@samsung.com`	any of [string, null]
name optional	조직 단위명 또는 계정명 Example : `score-organization-unit`	any of [string, null]	-
organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string
parent_unit_id optional	ROOT 또는 부모 조직 단위 ID Example : `ou-fc8c29a138d78e24bf1fa86812fc8b`	any of [string, null]
type required	유형(ROOT 또는 조직 단위) 또는 계정 유형 Example : `MEMBER`	string

2.11 - CombinedUnitV1dot1

Name	Description	Schema	Default
created_at optional	생성 일시 Example : `2024-12-19 01:09:05.000`	any of [string (date-time), null]
depth optional	계층(0~5) Example : `1`	any of [integer, null]	1
email optional	계정 이메일 Example : `score@samsung.com`	any of [string, null]
id required	조직 단위 ID 또는 조직 계정 ID Example : `ou-c29a138f8f1d78e24dbfa8681fc2fc8`	string
joined_method optional	가입 방법 Example : `INVITED`	any of [enum (INVITED, CREATED, CLOUD_CONTROL), null]
joined_time optional	가입 일시 Example : `2024-05-17T12:34:56.789Z`	any of [string (date-time), null]
login_id optional	로그인 ID Example : `log-archive@samsung.com`	any of [string, null]
name optional	조직 단위명 또는 계정명 Example : `score-organization-unit`	any of [string, null]	-
organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string
parent_unit_id optional	ROOT 또는 부모 조직 단위 ID Example : `ou-fc8c29a138d78e24bf1fa86812fc8b`	any of [string, null]
parent_unit_name optional	ROOT 또는 부모 조직 단위명 Example : `parent-unit-name`	any of [string, null]
type required	유형(ROOT 또는 조직 단위) 또는 계정 유형 Example : `MEMBER`	string

2.12 - ConnectedPolicySummary

Name	Description	Schema	Default
policy_id required	제어 정책 ID Example : `f98e76d54c32b10a9z8y7x6w5v4u3`	string
policy_name required	제어 정책 이름 Example : `test-policy-name`	string

2.13 - ControlPolicyAssignmentFailCaused

Name	Description	Schema
error_code required	error code Example : `Conflict`	string
failed_caused required	실패 원인 Example : `Account 482d111a302547fbbd11ee0141ea23bb is not found`	string
failed_id required	실패 ID Example : `ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5`	string

2.14 - ControlPolicyAssignmentResponse

Name	Description	Schema	Default
failed_ids required		array[ControlPolicyAssignmentFailCaused]
success_ids required	성공 ID Example : `['ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5']`	array[string]

2.15 - CreateAccountFailCaused

Name	Description	Schema	Default
error_code required	error code Example : `Organization.AccountNotRemovable`	string
failed_caused required	실패 사유 Example : `Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found`	string

2.16 - CreateAccountSuccess

Name	Description	Schema	Default
success_id required	조직 계정 ID Example : `b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0`	string
success_name required	계정명 Example : `score-account`	string

2.17 - DelegationPolicy

Name	Description	Schema
created_at required	생성 일시 Example : `2024-12-19 01:09:05.000`	string (date-time)
created_by required	생성자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
document required	위임 정책 문서 Example : {'Statement': [{'Action': ['organization:CreateServiceControlPolicy', 'organization:DeleteServiceControlPolicies', 'organization:SetServiceControlPolicy', 'organization:ShowServiceControlPolicy', 'organization:ListServiceControlPolicies', 'organization:ShowAccount', 'organization:ListAccounts', 'organization:ListOrganizationUnits', 'organization:ListOrganizationInvitations', 'organization:ListParents', 'organization:ListPoliciesForTarget', 'organization:ListTargetsForPolicy', 'organization:AttachPolicyBindings', 'organization:RemovePolicyBindings', 'organization:ShowDelegatePolicy'], 'Effect': 'Allow', 'Principal': {'scp': ['srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df']}, 'Resource': ['*'], 'Sid': 'statement1'}], 'Version': '2024-07-01'}	DelegationPolicyDocument
modified_at required	수정 일시 Example : `2023-10-15 14:30:00`	string (date-time)
modified_by required	수정자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string

2.18 - DelegationPolicyCreateRequest

Name	Description	Schema	Default
document required	위임 정책 문서 Example : {'Statement': [{'Action': ['organization:CreateServiceControlPolicy', 'organization:DeleteServiceControlPolicies', 'organization:SetServiceControlPolicy', 'organization:ShowServiceControlPolicy', 'organization:ListServiceControlPolicies', 'organization:ShowAccount', 'organization:ListAccounts', 'organization:ListOrganizationUnits', 'organization:ListOrganizationInvitations', 'organization:ListParents', 'organization:ListPoliciesForTarget', 'organization:ListTargetsForPolicy', 'organization:AttachPolicyBindings', 'organization:RemovePolicyBindings', 'organization:ShowDelegatePolicy'], 'Effect': 'Allow', 'Principal': {'scp': ['srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df']}, 'Resource': ['*'], 'Sid': 'statement1'}], 'Version': '2024-07-01'}	DelegationPolicyDocument
organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]

2.19 - DelegationPolicyDocument

Name	Description	Schema	Default
Statement optional	정책 문법	array[DelegationPolicyStatement]
Version optional	정책 버전 Example : `2012-10-17`	string	2012-10-17

2.20 - DelegationPolicySetRequest

Name	Description	Schema	Default
document required	위임 정책 문서 Example : {'Statement': [{'Action': ['organization:CreateServiceControlPolicy', 'organization:DeleteServiceControlPolicies', 'organization:SetServiceControlPolicy', 'organization:ShowServiceControlPolicy', 'organization:ListServiceControlPolicies', 'organization:ShowAccount', 'organization:ListAccounts', 'organization:ListOrganizationUnits', 'organization:ListOrganizationInvitations', 'organization:ListParents', 'organization:ListPoliciesForTarget', 'organization:ListTargetsForPolicy', 'organization:AttachPolicyBindings', 'organization:RemovePolicyBindings', 'organization:ShowDelegatePolicy'], 'Effect': 'Allow', 'Principal': {'scp': ['srn:dev2::f045159f40c64125a1fe61bd71d1c14c:::iam:user/e3a6e3f99c1040639e9a3c8f8b7427df']}, 'Resource': ['*'], 'Sid': 'statement1'}], 'Version': '2024-07-01'}	DelegationPolicyDocument
organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]

2.21 - DelegationPolicyShowResponse

Name	Description	Schema	Default
policy required		DelegationPolicy

2.22 - DelegationPolicyStatement

Name	Description	Schema	Default
Action optional	정책 액션 Example : `['s3:PutObject', 's3:GetObject']`	any of [array[string], null]	[‘s3:PutObject’, ‘s3:GetObject’]
Condition optional	정책 요건 Example :	any of [object[object[array[object]]], null]
Effect optional	정책 효과 Example : `Allow`	string	Allow
NotAction optional	정책 제외 액션 Example :	any of [array[string], null]
Principal optional	호출 주체 Example :	any of [string, object[array[string]], null]
Resource optional	리소스 Example : `['*']`	array[string]	[’*’]
Sid optional	문법 ID Example : `statement1`	string	statement1

2.23 - Invitation

Name	Description	Schema
created_at required	생성 일시 Example : `2024-12-19 01:09:05.000`	string (date-time)
created_by required	생성자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
expired_time required	초대 만료 일시 Example : `2024-04-30T12:34:56.789Z`	string (date-time)
id required	초대 ID Example : `138c2fc8c29a449dbfa8681f8f1d78e2`	string
master_account_id required	관리자 계정 ID Example : `9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r`	string
modified_at required	수정 일시 Example : `2023-10-15 14:30:00`	string (date-time)
modified_by required	수정자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string
requested_time required	초대 요청 일시 Example : `2024-04-17T12:34:56.789Z`	string (date-time)
state required	초대 상태 Example : `REFUSED`	enum (INVITING, REFUSED, INVITED, CANCELED, EXPIRED)
target_account_id required	초대 수신자 계정 ID Example : `338c2fc8c29a449dbfa8681f8f1d78e5`	string

2.24 - InvitationAcceptFailCaused

Name	Description	Schema
error_code required	error code Example : `Invitation.AlreadySentError`	string
failed_caused required	실패 사유 Example : `Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found`	string
failed_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string
failed_name required	조직 이름 Example : `My Organization`	string

2.25 - InvitationAcceptResponse

Name	Description	Schema
failed_id optional	초대 실패 조직 정보	any of [InvitationAcceptFailCaused, null]
master_account_email required	계정 이메일 Example : `score@samsung.com`	any of [string, null]
success_id optional	초대 성공 조직 정보	any of [InvitationAcceptSuccess, null]

2.26 - InvitationAcceptSuccess

Name	Description	Schema	Default
success_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string
success_name required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string

2.27 - InvitationCancelRequest

Name	Description	Schema	Default
ids required	초대 ID Example : `['138c2fc8c29a449dbfa8681f8f1d78e2']`	array[string]
organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]

2.28 - InvitationCancelResponse

Name	Description	Schema	Default
success_ids required	초대 ID Example : `['138c2fc8c29a449dbfa8681f8f1d78e2']`	array[string]

2.29 - InvitationCreateFailCaused

Name	Description	Schema
error_code required	error code Example : `Invitation.AlreadySentError`	string
failed_caused required	실패 사유 Example : `Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found`	string
failed_id required	조직 초대 실패 Login ID 목록 Example : `['score-1@samsung.com']`	string

2.30 - InvitationCreateRequest

Name	Description	Schema	Default
organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]
target_login_ids required	초대 수신자 계정 이메일 목록 Example : `['score-1@samsung.com']`	array[string]

2.31 - InvitationCreateResponse

Name	Description	Schema	Default
failed_ids required		array[InvitationCreateFailCaused]
success_ids required	조직 초대 성공 Login ID 목록 Example : `['log-archive@samsung.com']`	array[string]

2.32 - InvitationShowResponse

Name	Description	Schema	Default
invitation required	초대 상세 정보	Invitation

2.33 - ListPoliciesForTargetResponse

Name	Description	Schema
count required	count Example : `20`	integer
page required	page Example : `0`	integer
policies required		array[PoliciesForTargetSummary]
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]

2.34 - ListTargetsForPolicyResponse

Name	Description	Schema
count required	count Example : `20`	integer
page required	page Example : `0`	integer
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]
targets required		array[TargetsForPolicySummary]

2.35 - MoveAccountRequest

Name	Description	Schema
organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]
parent_unit_id required	ROOT ID 또는 조직 단위 ID Example : `ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5`	string
target_account_ids required	타겟 계정 아이디 목록 Example : `['b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0']`	array[string]

2.36 - MoveAccountSuccess

Name	Description	Schema
success_id required	조직 계정 ID Example : `b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0`	string
success_name required	계정명 Example : `score-account`	string
target_id required	조직 단위 ID Example : `ou-c29a138f8f1d78e24dbfa8681fc2fc8`	string
target_name required	조직 단위명 Example : `score-organization-unit`	string

2.37 - Organization

Name	Description	Schema	Default
created_at required	생성 일시 Example : `2024-12-19 01:09:05.000`	string (date-time)
created_by required	생성자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
creator_name optional	생성자 성, 이름 Example : `John Doe na`	string	-
delegation_account_id optional	위임 계정 Example : `124e7d6c5b4a3z2y1x0w9v8u7t6s5r`	any of [string, null]
id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string
master_account_email required	관리자 계정 이메일 Example : `admin@example.com`	string
master_account_id required	관리자 계정 ID Example : `9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r`	string
modified_at required	수정 일시 Example : `2023-10-15 14:30:00`	string (date-time)
modified_by required	수정자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
modifier_name optional	수정자 성, 이름 Example : `Alice`	string	-
name required	조직 이름 Example : `My Organization`	string
root_unit_id required	루트 유닛 ID Example : `r-abcd7d6c5b4a3z2y1x0w9v8u7t6s5r`	string
srn required	조직 SRN Example : `srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/organization/o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string
use_scp_yn required	통제 정책 사용 여부 Example : `True`	boolean

2.38 - OrganizationAccountWithPolicy

Name	Description	Schema	Default
control_policies required		array[ConnectedPolicySummary]
created_at required	생성 일시 Example : `2024-12-19 01:09:05.000`	string (date-time)
created_by required	생성자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
creator_name optional	생성자 성, 이름 Example : `John Doe na`	string	-
email optional	계정 이메일 Example : `score@samsung.com`	any of [string, null]
id required	ID Example : `0a36e0746dbf4908acf0357829701381`	string
joined_method required	가입 방법 Example : `INVITED`	enum (INVITED, CREATED, CLOUD_CONTROL)
joined_time required	가입 일시 Example : `2024-05-17T12:34:56.789Z`	string (date-time)
login_id optional	로그인 ID Example : `log-archive@samsung.com`	any of [string, null]
modified_at required	수정 일시 Example : `2023-10-15 14:30:00`	string (date-time)
modified_by required	수정자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
modifier_name optional	수정자 성, 이름 Example : `Alice`	string	-
name optional	계정명 Example : `score-account`	any of [string, null]
organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string
parent_unit_id required	ROOT 또는 부모 조직 단위 ID Example : `ou-fc8c29a138d78e24bf1fa86812fc8b`	string
parent_unit_name required	ROOT 또는 부모 조직 단위명 Example : `parent-unit-name`	any of [string, null]
srn optional	SRN Example : `srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/account/b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0`	any of [string, null]
state required	계정 상태 Example : `ACTIVE`	enum (ACTIVE, SUSPENDED, PENDING_CLOSURE)
type required	계정 유형 Example : `MEMBER`	enum (MANAGEMENT, DELEGATION, MEMBER, NONE, LOG_ARCHIVE, AUDIT)

2.39 - OrganizationCreateRequest

Name	Description	Schema	Default
name required	조직 이름 Example : `My Organization` Pattern : `^[a-zA-Z0-9\-.,_+=@ㄱ-ㅎㅏ-ㅣ가-힣 ]$` Minimum length* : `1` Maximum length : `20`	string

2.40 - OrganizationDeleteFailCaused

Name	Description	Schema
error_code required	error code Example : `Organization.delete.MemberAccountIsExist`	string
failed_caused required	실패 사유 Example : `Payment method registration required.`	string
failed_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	array[string]

2.41 - OrganizationDeleteResponse

Name	Description	Schema	Default
failed required		OrganizationDeleteFailCaused
success optional	조직 이름 Example : `My Organization`	any of [string, null]

2.42 - OrganizationInvitation

Name	Description	Schema
account_email optional	관리자 계정 이메일 Example : `admin@example.com`	any of [string, null]
account_name optional	관리자 계정명 Example : `CoreKim`	any of [string, null]
created_at required	생성 일시 Example : `2024-12-19 01:09:05.000`	string (date-time)
created_by required	생성자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
id required	ID Example : `0a36e0746dbf4908acf0357829701381`	string
login_id optional	로그인 ID Example : `log-archive@samsung.com`	any of [string, null]
modified_at required	수정 일시 Example : `2023-10-15 14:30:00`	string (date-time)
modified_by required	수정자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string
state required	초대 상태 Example : `INVITING`	enum (INVITING, REFUSED, INVITED, CANCELED, EXPIRED)
target_account_id required	관리자 계정명 Example : `9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r`	string

2.43 - OrganizationInvitationPageResponse

Name	Description	Schema
count required	count Example : `20`	integer
organization_invitations required	초대 목록	array[OrganizationInvitation]
page required	page Example : `0`	integer
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]

2.44 - OrganizationLeaveFailCaused

Name	Description	Schema
error_code required	error code Example : `Organization.AccountNotRemovable`	string
failed_caused required	실패 사유 Example : `Payment method registration required.`	string
failed_id required	조직 계정 ID Example : `b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0`	string
failed_name required	조직 이름 Example : `My Organization`	string

2.45 - OrganizationLeaveResponse

Name	Description	Schema	Default
failed optional	계정 삭제 실패 정보	any of [OrganizationLeaveFailCaused, null]
success optional	계정 삭제 성공 정보	any of [OrganizationLeaveSuccess, null]

2.46 - OrganizationLeaveSuccess

Name	Description	Schema	Default
success_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string
success_name required	조직 이름 Example : `My Organization`	string

2.47 - OrganizationPageResponse

Name	Description	Schema
count required	count Example : `20`	integer
organizations required		array[OrganizationSummary]
page required	page Example : `0`	integer
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]

2.48 - OrganizationSetRequest

Name	Description	Schema
delegation_account_id optional	위임 계정 Example : `124e7d6c5b4a3z2y1x0w9v8u7t6s5r`	any of [string, null]
name optional	조직 이름 Example : `My Organization` Pattern : `^[a-zA-Z0-9\-.,_+=@ㄱ-ㅎㅏ-ㅣ가-힣 ]*$`	any of [string, null]
organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]
use_scp_yn optional	통제 정책 사용 여부 Example : `True`	any of [boolean, null]

2.49 - OrganizationShowResponse

Name	Description	Schema	Default
organization required		Organization

2.50 - OrganizationSummary

Name	Description	Schema
created_at required	생성 일시 Example : `2024-12-19 01:09:05.000`	string (date-time)
created_by required	생성자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
delegation_account_id optional	위임 계정 Example : `124e7d6c5b4a3z2y1x0w9v8u7t6s5r`	any of [string, null]
id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string
master_account_id required	관리자 계정 ID Example : `9f8e7d6c5b4a3z2y1x0w9v8u7t6s5r`	string
modified_at required	수정 일시 Example : `2023-10-15 14:30:00`	string (date-time)
modified_by required	수정자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
name required	조직 이름 Example : `My Organization`	string
root_unit_id required	루트 유닛 ID Example : `r-abcd7d6c5b4a3z2y1x0w9v8u7t6s5r`	string
use_scp_yn required	통제 정책 사용 여부 Example : `True`	boolean

2.51 - OrganizationUnit

Name	Description	Schema	Default
created_at required	생성 일시 Example : `2024-12-19 01:09:05.000`	string (date-time)
created_by required	생성자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
creator_name optional	생성자 성, 이름 Example : `John Doe na`	string	-
depth required	계층(0~5) Example : `1`	integer
description optional	조직 단위 설명 Example : `에스코어 조직 단위`	any of [string, null]
id required	조직 단위 ID Example : `ou-c29a138f8f1d78e24dbfa8681fc2fc8`	string
modified_at required	수정 일시 Example : `2023-10-15 14:30:00`	string (date-time)
modified_by required	수정자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
modifier_name optional	수정자 성, 이름 Example : `Alice`	string	-
name required	조직 단위명 Example : `score-organization-unit`	string
parent_unit_id optional	유형(ROOT 또는 조직 단위) Example : `ou-fc8c29a138d78e24bf1fa86812fc8b`	any of [string, null]
service_name required	서비스명 Example : `Organization`	string
srn optional	조직 단위 SRN Example : `srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/ou/ou-c29a138f8f1d78e24dbfa8681fc2fc8`	any of [string, null]
type required	유형(ROOT 또는 조직 단위) Example : `OU`	string

2.52 - OrganizationUnitCreateRequest

Name	Description	Schema
description optional	조직 단위 설명 Example : `에스코어 조직 단위`	any of [string, null]
name required	조직 단위명 Example : `score-organization-unit` Minimum length : `1` Maximum length : `128`	string
organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]
parent_unit_id optional	ROOT 또는 부모 조직 단위 ID Example : `ou-fc8c29a138d78e24bf1fa86812fc8b`	any of [string, null]
policy_ids optional	제어 정책 목록 ID Example : `['f98e76d54c32b10a9z8y7x6w5v4u3']`	any of [array[string], null]

2.53 - OrganizationUnitCreateResponse

Name	Description	Schema	Default
organization_unit required	조직 단위 정보	OrganizationUnitWithPolicy

2.54 - OrganizationUnitDeleteFailCaused

Name	Description	Schema
error_code required	error code Example : `Organization.UnitNotRemovable`	string
failed_caused required	실패 사유 Example : `Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found`	string
failed_id required	조직 단위 ID Example : `ou-abc1f2h1j0l9n8p7r6t5v4x3z2y1w0`	string

2.55 - OrganizationUnitDeleteRequest

Name	Description	Schema	Default
ids required	조직 단위 ID 목록 Example : `['ou-c29a138f8f1d78e24dbfa8681fc2fc8']`	array[string]
organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]

2.56 - OrganizationUnitDeleteResponse

Name	Description	Schema	Default
failed_ids required		array[OrganizationUnitDeleteFailCaused]
success_ids required	조직 단위 ID 목록 Example : `['ou-c29a138f8f1d78e24dbfa8681fc2fc8']`	array[string]

2.57 - OrganizationUnitListResponse

Name	Description	Schema	Default
organization_units required	조직 단위 목록	array[CombinedUnit]

2.58 - OrganizationUnitListResponseV1dot1

Name	Description	Schema	Default
organization_units required	조직 단위 목록	array[CombinedUnitV1dot1]

2.59 - OrganizationUnitParentsResponse

Name	Description	Schema	Default
parents required	부모 조직 단위 정보	array[OrganizationUnit]

2.60 - OrganizationUnitSetRequest

Name	Description	Schema
description optional	조직 단위 설명 Example : `에스코어 조직 단위`	any of [string, null]
name optional	조직 단위명 Example : `score-organization-unit`	any of [string, null]
organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]

2.61 - OrganizationUnitShowResponse

Name	Description	Schema	Default
organization_unit required	조직 단위 정보	OrganizationUnit

2.62 - OrganizationUnitWithPolicy

Name	Description	Schema	Default
control_policies required		array[ConnectedPolicySummary]
created_at required	생성 일시 Example : `2024-12-19 01:09:05.000`	string (date-time)
created_by required	생성자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
creator_name optional	생성자 성, 이름 Example : `John Doe na`	string	-
depth required	계층(0~5) Example : `1`	integer
description optional	조직 단위 설명 Example : `에스코어 조직 단위`	any of [string, null]
id required	조직 단위 ID Example : `ou-c29a138f8f1d78e24dbfa8681fc2fc8`	string
modified_at required	수정 일시 Example : `2023-10-15 14:30:00`	string (date-time)
modified_by required	수정자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
modifier_name optional	수정자 성, 이름 Example : `Alice`	string	-
name required	조직 단위명 Example : `score-organization-unit`	string
parent_unit_id optional	유형(ROOT 또는 조직 단위) Example : `ou-fc8c29a138d78e24bf1fa86812fc8b`	any of [string, null]
service_name required	서비스명 Example : `Organization`	string
srn optional	조직 단위 SRN Example : `srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/ou/ou-c29a138f8f1d78e24dbfa8681fc2fc8`	any of [string, null]
type required	유형(ROOT 또는 조직 단위) Example : `OU`	string

2.63 - OrganizationUserCreateRequest

Name	Description	Schema
login_id required	로그인 ID Example : `log-archive@samsung.com` Maximum length : `60`	string (email)
name required	계정명 Example : `score-account` Pattern : `^[a-zA-Z0-9ㄱ-ㅎㅏ-ㅣ가-힣 \+=_\-@\[\]\.,]$` Minimum length* : `3` Maximum length : `30`	string
organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string
role_name required	역할명 Example : `OrganizationAccountAccessRole` Pattern : `^[a-zA-Z0-9\+=,\.@_\-ㄱ-ㅎㅏ-ㅣ가-힣 ]$` Minimum length* : `1` Maximum length : `64`	string

2.64 - PoliciesForTargetSummary

Name	Description	Schema
created_at required	생성 일시 Example : `2024-12-19 01:09:05.000`	string (date-time)
created_by required	생성자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
id required	ID Example : `0a36e0746dbf4908acf0357829701381`	string
link_types required	연결 유형 Example : `{'DIRECTED': [{'target_id': '1a2b3c4d5e6f7g8h9i0j1k2l3m4n5', 'target_name': 'example-target', 'target_type': 'OU'}], 'INHERITED': [{'target_id': '2a2b3c4d5e6f7g8h9i0j1k2l3m4n5', 'target_name': 'root', 'target_type': 'ROOT'}]}`	object[array[PolicyLinkInfo]]
modified_at required	수정 일시 Example : `2023-10-15 14:30:00`	string (date-time)
modified_by required	수정자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
policy_name required	제어 정책 이름 Example : `test-policy-name`	string
policy_type required	제어 정책 유형 Example : `SYSTEM_MANAGED`	enum (SYSTEM_MANAGED, USER_DEFINED)
source required	정책 생성 주체 Example : `ORGANIZATION`	string

2.65 - PolicyAttachRequest

Name	Description	Schema
entity required	개체 유형 Example : `POLICY`	enum (POLICY, TARGET)
organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]
policy_ids required	제어 정책 목록 ID Example : `['f98e76d54c32b10a9z8y7x6w5v4u3']`	array[string]
target_ids required	타겟 정보 Example : `['ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5']`	array[string]

2.66 - PolicyLinkInfo

Name	Description	Schema
target_id required	타겟 ID Example : `ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5`	string
target_name required	타겟명 Example : `example-target`	any of [string, null]
target_type required	타겟 유형 Example : `OU`	string

2.67 - PolicyRemoveRequest

Name	Description	Schema
entity required	개체 유형 Example : `POLICY`	enum (POLICY, TARGET)
organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]
policy_ids required	제어 정책 목록 ID Example : `['f98e76d54c32b10a9z8y7x6w5v4u3']`	array[string]
target_ids required	타겟 정보 Example : `['ou-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5']`	array[string]

2.68 - RemoveAccountFailCaused

Name	Description	Schema
error_code required	error code Example : `Organization.AccountNotRemovable`	string
failed_caused required	실패 사유 Example : `Account b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0 is not found`	string
failed_id required	조직 계정 ID Example : `1a5xz23h1j0l9n8p7r6t5v4x3z2y1w0`	string
failed_name required	계정명 Example : `score-account`	string

2.69 - RemoveAccountsRequest

Name	Description	Schema	Default
organization_id optional	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	any of [string, null]
target_account_ids required	타겟 계정 아이디 목록 Example : `['b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0']`	array[string]

2.70 - RemoveAccountSuccess

Name	Description	Schema	Default
success_id required	조직 계정 ID Example : `b4d3f2h1j0l9n8p7r6t5v4x3z2y1w0`	string
success_name required	계정명 Example : `score-account`	string

2.71 - ServiceControlPolicy

Name	Description	Schema	Default
category required	정책 카테고리 Example : `SCP`	string
created_at required	생성 일시 Example : `2024-12-19 01:09:05.000`	string (date-time)
created_by required	생성자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
creator_name optional	생성자 성, 이름 Example : `John Doe na`	string	-
description required	정책 설명 Example : `This is an example policy.`	any of [string, null]
document required	정책 문서 Example : `{'Statement': [{'Action': [''], 'Effect': 'Allow', 'Resource': [''], 'Sid': 'statement1'}], 'Version': '2024-07-01'}`	ServiceControlPolicyDocument
id required	서비스 제어 정책 ID Example : `138c2fc8c29a449dbfa8681f8f1d78e2`	string
modified_at required	수정 일시 Example : `2023-10-15 14:30:00`	string (date-time)
modified_by required	수정자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
modifier_name optional	수정자 성, 이름 Example : `Alice`	string	-
name required	서비스 제어 정책 이름 Example : `MyPolicy`	string
organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string
service_name required	서비스명 Example : `Organization`	string
source required	정책 생성 주체 Example : `ORGANIZATION`	string
srn required	정책 SRN Example : `srn:dev2::1b8c29a138d78e24bf1fa86812fcaa:kr-west1::organizations/service-control-policy/138c2fc8c29a449dbfa8681f8f1d78e2`	string
state required	정책 상태 Example : `ACTIVE`	string
type required	서비스 제어 정책 유형 Example : `MANAGED`	string

2.72 - ServiceControlPolicyCreateRequest

Name	Description	Schema	Default
description required	정책 설명 Example : `This is an example policy.`	any of [string, null]
document required	정책 문서 Example : `{'Statement': [{'Action': [''], 'Effect': 'Allow', 'Resource': [''], 'Sid': 'statement1'}], 'Version': '2024-07-01'}`	ServiceControlPolicyDocument
name required	서비스 제어 정책 이름 Example : `MyPolicy` Pattern : `^[a-zA-Z0-9\-.,_+=@ㄱ-ㅎㅏ-ㅣ가-힣]$` Minimum length* : `3` Maximum length : `128`	string
organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string
type optional	서비스 제어 정책 유형 Example : `MANAGED`	enum (SYSTEM_MANAGED, USER_DEFINED)	USER_DEFINED

2.73 - ServiceControlPolicyDeleteFailCaused

Name	Description	Schema
binding_targets required		array[BindingTarget]
error_code required	error code Example : `Policy.PolicyInUseError`	string
failed_caused required	실패 사유 Example : `The specified policy is in use and cannot be deleted.`	string
failed_id required	서비스 제어 정책 ID Example : `138c2fc8c29a449dbfa8681f8f1d78e2`	string

2.74 - ServiceControlPolicyDeleteRequest

Name	Description	Schema	Default
ids required	서비스 제어 정책 목록ID Example : `['138c2fc8c29a449dbfa8681f8f1d78e2']`	array[string]
organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string

2.75 - ServiceControlPolicyDeleteResponse

Name	Description	Schema	Default
failed_ids required		array[ServiceControlPolicyDeleteFailCaused]
success_ids required		array[string]

2.76 - ServiceControlPolicyDocument

Name	Description	Schema	Default
Statement optional	정책 문법	array[ServiceControlPolicyStatement]
Version optional	정책 버전 Example : `2012-10-17`	string	2012-10-17

2.77 - ServiceControlPolicyPageResponse

Name	Description	Schema
count required	count Example : `20`	integer
page required	page Example : `0`	integer
policies required		array[ServiceControlPolicySummary]
size required	size Example : `20`	integer
sort optional	sort Example : `['created_at:asc']`	any of [array[string], null]

2.78 - ServiceControlPolicySetRequest

Name	Description	Schema
description optional	정책 설명 Example : `This is an example policy.`	any of [string, null]
document optional	정책 문서 Example : `{'Statement': [{'Action': [''], 'Effect': 'Allow', 'Resource': [''], 'Sid': 'statement1'}], 'Version': '2024-07-01'}`	any of [ServiceControlPolicyDocument, null]
name optional	서비스 제어 정책 이름 Example : `MyPolicy` Pattern : `^[a-zA-Z0-9\-.,_+=@ㄱ-ㅎㅏ-ㅣ가-힣]*$`	any of [string, null]
organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string

2.79 - ServiceControlPolicyShowResponse

Name	Description	Schema	Default
policy required		ServiceControlPolicy

2.80 - ServiceControlPolicyStatement

Name	Description	Schema	Default
Action optional	정책 액션 Example : `['s3:PutObject', 's3:GetObject']`	any of [array[string], null]	[‘s3:PutObject’, ‘s3:GetObject’]
Condition optional	정책 요건 Example :	any of [object[object[array[object]]], null]
Effect optional	정책 효과 Example : `Allow`	string	Allow
NotAction optional	정책 제외 액션 Example :	any of [array[string], null]
Principal optional	호출 주체 Example :	any of [string, object[array[string]], null]
Resource optional	리소스 Example : `['*']`	array[string]	[’*’]
Sid optional	문법 ID Example : `statement1`	string	statement1

2.81 - ServiceControlPolicySummary

Name	Description	Schema	Default
category required	정책 카테고리 Example : `SCP`	string
created_at required	생성 일시 Example : `2024-12-19 01:09:05.000`	string (date-time)
created_by required	생성자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
creator_name optional	생성자 성, 이름 Example : `John Doe na`	string	-
description required	정책 설명 Example : `This is an example policy.`	any of [string, null]
document required	정책 문서 Example : `{'Statement': [{'Action': [''], 'Effect': 'Allow', 'Resource': [''], 'Sid': 'statement1'}], 'Version': '2024-07-01'}`	ServiceControlPolicyDocument
id required	서비스 제어 정책 ID Example : `138c2fc8c29a449dbfa8681f8f1d78e2`	string
modified_at required	수정 일시 Example : `2023-10-15 14:30:00`	string (date-time)
modified_by required	수정자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
modifier_name optional	수정자 성, 이름 Example : `Alice`	string	-
name required	서비스 제어 정책 이름 Example : `MyPolicy`	string
organization_id required	조직 ID Example : `o-x9y8z7w6v5u4t3s2r1q0p9o8n7m6l5`	string
source required	정책 생성 주체 Example : `ORGANIZATION`	string
state required	정책 상태 Example : `ACTIVE`	string
type required	서비스 제어 정책 유형 Example : `MANAGED`	string

2.82 - TargetsForPolicySummary

Name	Description	Schema
control_policies required	통제 정책 아이디 목록	array[ConnectedPolicySummary]
created_at required	생성 일시 Example : `2024-12-19 01:09:05.000`	string (date-time)
created_by required	생성자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
id required	ID Example : `0a36e0746dbf4908acf0357829701381`	string
modified_at required	수정 일시 Example : `2023-10-15 14:30:00`	string (date-time)
modified_by required	수정자 Example : `c23fb561c689455993874fa5d5ed4a2f`	string
target_name required	타겟명 Example : `example-target`	any of [string, null]