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

original_name

swr_02_0042.html

Creating Organization Permissions

Function

Grant permissions of an organization to certain users so that they can manage, edit, and read images from the organization.

URI

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

Table 1 <swr_02_0042__table1860452124716> describes the parameters.

Table 1 Parameter description

Parameter	Mandatory	Type	Description
namespace	Yes	String	Organization name.

Request

• Request parameters

  Table 2 Request body description

  Parameter	Mandatory	Type	Description
  [Array element]	Yes	Array of objects <swr_02_0042__table196185211479>	Information required for creating organization permissions.

  Table 3 [Array element]

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

• Example request

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

  Body:

  [
      {
          "user_id": "fb3f175c1fd146ab8cdae3272be6107b",
          "user_name": "user01",
          "auth": 1
      }
  ]

Response

• Response parameters

  N/A

• Example response

  {}

Status Code

Status Code	Description
201	Creation successful.
400	Request error.
401	Authentication failed.
404	The organization does not exist.
409	The organization permission already exists.
500	Internal error.