software-repository-container/api-ref/source/api/querying_organization_permissions.rst

original_name

swr_02_0045.html

Querying Organization Permissions

Function

Query organization permissions.

URI

GET /v2/manage/namespaces/{namespace}/access

For details about parameters, see Table 1 <swr_02_0045__table73271639103420>.

Table 1 Parameter description

Parameter	Mandatory	Type	Description
namespace	Yes	String	Organization name.

Request

• Request parameters

  N/A

• Example request

  GET https://{Endpoint}/v2/manage/namespaces/group/access

Response

• Response parameters

  Table 2 Response body parameters

  Parameter	Type	Description
  id	Integer	Permission ID.
  name	String	Organization name.
  creator_name	String	Organization creator.
  self_auth	Object <swr_02_0045__table16690123312516>	Permissions of the current user.
  others_auths	Array of objects <swr_02_0045__table2060620585538>	Permissions of other users.

  Table 3 self_auth parameter description

  Parameter	Type	Description
  user_id	String	User ID.
  user_name	String	Username.
  auth	Integer	User permission 7: Manage 3: Write 1: Read

  Table 4 others_auths parameter description

  Parameter	Type	Description
  user_id	String	User ID.
  user_name	String	Username.
  auth	Integer	User permission 7: Manage 3: Write 1: Read

• Example response

  {
      "id": 1334795,
      "name": "group",
      "creator_name": "user",
      "self_auth": {
          "user_id": "050b12577f00269a1fcfc01f65239697",
          "user_name": "user",
          "auth": 7
      },
      "others_auths": [
          {
              "user_id": "06d89c3b6d800f2d1f28c01f0d882285",
              "user_name": "user_01",
              "auth": 1
          },
          {
              "user_id": "050b12577f00269a1fcfc01f65239697",
              "user_name": "user",
              "auth": 7
          }
      ]
  }

Status Code

Status Code	Description
200	Request successful.
400	Request error.
401	Authentication failed.
404	The organization does not exist.
500	Internal error.