Gamma API
OrganizationsProfiles

Update a profile

PATCH
/api/organizations/{slug}/profiles/{profileId}

Fields left out are unchanged; permissions replaces the whole map. Refused with 409 while archived or when the name is taken, and with 422 for an unknown area or level.

Who may call it: An owner, security admin or admin of the organization. API keys: no.

Authorization

session
cookiegamma.session_token<token>

The session cookie a sign-in sets. Over HTTPS its name carries the __Secure- prefix. Browsers send it on their own; other clients keep it from the sign-in response.

Path Parameters

slug*string

The organization's slug, as in its URL.

profileId*string

Request Body

application/json
  1. body
name?string
Length1 <= length <= 120
permissions?

A level per area: view, create, edit or full. An area left out grants nothing.

companyRestricted?boolean

Its holders see only the issues and forms their own company created or that are assigned to them.

Response Body

OK.

application/json
  1. response
profile*

A permission profile: what a project member may do with each content area.

Example Request
curl -X PATCH 'http://localhost:3000/api/organizations/string/profiles/string' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "profile": {    "id": "string",    "name": "string",    "permissions": {      "property1": "view",      "property2": "view"    },    "companyRestricted": true,    "archivedAt": "2019-08-24T14:15:22Z",    "createdAt": "2019-08-24T14:15:22Z",    "updatedAt": "2019-08-24T14:15:22Z"  }}