Enable a member for a project

PUT

https://{your_space_name}.signalwire.com/api/space/members/:member_id/projects/:project_id

Gives a member access to a root project and, through it, to all of the project’s subprojects. The call is idempotent: repeating it leaves the same single enablement in place and returns 200 again.

Enablement applies to root projects only. Naming a subproject is rejected with subproject_access_is_inherited_from_root, and the message names the root project to enable instead.

Permissions

Authenticate with a Personal access token whose holder is an owner or admin of the space. A project API token is not accepted on this endpoint, and a Personal access token has no scopes: the holder’s role in the space is the whole authorization decision.

Gives a member access to a root project and, through it, to all of the project's subprojects. The call is idempotent: repeating it leaves the same single enablement in place and returns `200` again. Enablement applies to root projects only. Naming a subproject is rejected with `subproject_access_is_inherited_from_root`, and the message names the root project to enable instead. #### Permissions Authenticate with a [Personal access token](/docs/apis/authorization#personal-access-tokens) whose holder is an owner or admin of the space. A project API token is not accepted on this endpoint, and a Personal access token has no scopes: the holder's role in the space is the whole authorization decision.

Authentication

AuthorizationBasic

Personal access token authentication for space-wide administration.

Send HTTP Basic auth with an empty username and the Personal access token as the password. A Personal access token carries your own authority rather than a project’s: it is created from your user menu in the Dashboard, is prefixed pat_, and has no scopes. The holder must be an owner or admin of the space named by the subdomain, and the token acts only on that space.

Example:

Authorization: Basic base64(:pat_...)

Personal access token authentication for space-wide administration. Send HTTP Basic auth with an empty username and the Personal access token as the password. A Personal access token carries your own authority rather than a project's: it is created from your user menu in the Dashboard, is prefixed `pat_`, and has no scopes. The holder must be an owner or admin of the space named by the subdomain, and the token acts only on that space. Example: ``` Authorization: Basic base64(:pat_...) ```

Path parameters

member_idstringRequiredformat: "uuid"

The unique identifier of the membership.

project_idstringRequiredformat: "uuid"

The unique identifier of a root project. A subproject is rejected with subproject_access_is_inherited_from_root, since access to a root project already includes all of its subprojects.

Response

The request has succeeded.

typeenum

The object type. Always project.

idstringformat: "uuid"

The unique identifier of the project.

namestring

The name of the project.

created_atdatetime

The date and time when the project was created.

updated_atdatetime

The date and time when the project was last updated.

subprojectslist of objects

The subprojects reached through this enablement. Present on the enablement endpoints only, not on the nested entries.

Errors

401

Unauthorized Error

422

Unprocessable Entity Error

500

Internal Server Error