[{"label":"Latest (v1.0)","version":"latest"}]
csp

Get Organization By ID

Description

Get organization details.

Access Policy

Role User Accounts Service Accounts (Client Credentials Applications)
Organization Member ✔️ ✔️
Organization Admin ✔️ ✔️
Organization Owner ✔️ ✔️

Request

Request

URL

URL


get
https://{api_host}/csp/gateway/am/api/orgs/{orgId}
Copy

Path Parameters

Path Parameters

string
orgId Required

Unique identifier (GUID) of the organization.

Parameter Serialization Style: SIMPLE Explode:false

Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

200 OK

Returns OrganizationDto of type application/json
{
	"auditLogsInstanceId": "string",
	"displayName": "string",
	"enforceUserApiTokenMfa": false,
	"isMfaRequired": false,
	"language": "string",
	"locale": "string",
	"maxAllowedAuthExemptedUserCount": 0,
	"metadata": {
		"key": "string"
	},
	"name": "string",
	"parentRefLink": "string",
	"refLink": "string",
	"status": "string",
	"trustedOrgs": [
		{
			"id": "string"
		}
	]
}
string
displayName Required

The display name of the organization.


string
auditLogsInstanceId Optional

The instance of the LINT service in the region to which we will redirect audit logs. The organization must already have been granted access to the LINT service and assigned to one or more LINT service instances.


boolean
enforceUserApiTokenMfa Optional

Flag to enforce the user Api token multi-factor authentication (MFA).
If enabled then user needs to provide additional multi-factor authentication passcode when exchange API token for AccessToken.


boolean
isMfaRequired Optional

If the flag is enabled, vmwid users will be able to login only when they enabled multi-factor authentication (MFA).


string
language Optional

Default locale lang code preference for the organization.


string
locale Optional

Default locale lang country preference for the organization.


integer as int32
maxAllowedAuthExemptedUserCount Optional

Maximum number of users allowed to be auth exempted in the Organization


map of string
metadata Optional

Metadata related to the organization.


string
name Optional

Name or short unique identifier.


string
parentRefLink Optional

Document Ref Link of parent organization.


string
refLink Optional

Document Ref Link of organization.


string
status Optional

Shows whether the organization is active/inactive.


trustedOrgs Optional

The description about the trust.

Errors

Errors

CspErrorResponse
401

The user is not authorized to use the API


CspErrorResponse
403

The user is forbidden to use the API


CspErrorResponse
404

Organization with this identifier is not found.


CspErrorResponse
429

The user has sent too many requests


CspErrorResponse
500

An unexpected error has occurred while processing the request

Code Samples

Code Samples

cURL Command

curl https://{api_host}/csp/gateway/am/api/orgs/{orgId}


[{"label":"Latest (v1.0)","version":"latest"}]
csp
Feedback

Was this page helpful?