Querying Details About an Organization¶
Description¶
Query the details about an organization.
Constraints¶
None
URI¶
GET /v2/manage/namespaces/{namespace}
Parameter  | Mandatory  | Type  | Description  | 
|---|---|---|---|
namespace  | Yes  | String  | Organization name. Enter 1 to 64 characters, starting with a lowercase letter and ending with a lowercase letter or digit. Only lowercase letters, digits, periods (.), underscores (_), and hyphens (-) are allowed. Periods, underscores, and hyphens cannot be placed next to each other. A maximum of two consecutive underscores are allowed.  | 
Request Parameters¶
Parameter  | Mandatory  | Type  | Description  | 
|---|---|---|---|
Content-Type  | Yes  | String  | Message body type (format). The value can be application/json or charset=utf-8 application/json. Default value: application/json  | 
X-Auth-Token  | Yes  | String  | User token. The token can be obtained by calling an IAM API. The value of X-Subject-Token in the response header is the user token.  | 
Response Parameters¶
Status code: 200
Parameter  | Type  | Description  | 
|---|---|---|
id  | Integer  | id  | 
name  | String  | Organization name. Enter 1 to 64 characters, starting with a lowercase letter and ending with a lowercase letter or digit. Only lowercase letters, digits, periods (.), underscores (_), and hyphens (-) are allowed. Periods, underscores, and hyphens cannot be placed next to each other. A maximum of two consecutive underscores are allowed.  | 
creator_name  | String  | IAM username.  | 
auth  | Integer  | User permissions. 7: manage. 3: edit. 1: read.  | 
Example Request¶
GET https://{endpoint}/v2/manage/namespaces/{namespace}
Example Response¶
Status code: 200
Query succeeded.
{
  "id" : 1422,
  "name" : "demo",
  "creator_name" : "lgp",
  "auth" : 7
}
Status Codes¶
Status Code  | Description  | 
|---|---|
200  | Query succeeded.  | 
400  | Request error.  | 
401  | Authentication failed.  | 
404  | Organization not found.  | 
500  | Internal error.  | 
Error Codes¶
For details, see Error Codes.