Change a member's role

PATCH /spaces/{spaceId}/members/{email}

Updated 17 Sep 20261 min read

PATCH/spaces/{spaceId}/members/{email}Try it

Basehttps://api.mockflow.com/v1Scopesmembers:write

Request

curl https://api.mockflow.com/v1/spaces/spc_92kd/members/jane@acme.com \
  -X PATCH \
  -H "Authorization: Bearer $MOCKFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "role": "admin"
}'

const response = await fetch("https://api.mockflow.com/v1/spaces/spc_92kd/members/jane@acme.com", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.MOCKFLOW_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "role": "admin"
})
});

const data = await response.json();

import os, requests

response = requests.patch(
    "https://api.mockflow.com/v1/spaces/spc_92kd/members/jane@acme.com",
    headers={"Authorization": f"Bearer {os.environ['MOCKFLOW_API_KEY']}"},
    json={
  "role": "admin"
},
)

response.raise_for_status()
data = response.json()

Response

{
  "id": "string",
  "email": "jane@acme.com",
  "name": "Q4 Launch Planning",
  "role": "owner",
  "hasAccount": false,
  "invited": false
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests.",
    "docsUrl": "https://mockflow.com/developers/concepts/errors#rate_limited"
  },
  "requestId": "req_45d49816999bac40"
}

Authorization

Authorizationstringheaderrequired

Bearer <key>. The key needs members:write scope. Create and manage keys in the developer console; what each scope unlocks is on the scopes page.

Path parameters

spaceIdstringpathrequired

emailstringpathrequired

Body

application/json

roleenum<string>required

One of admin, editor or reviewer.

Response

200 · application/json

idstring

emailstring

namestring

roleenum<string>

The product's roles. Owner is the workspace that holds the board or space and cannot be granted or transferred. Admin can rename and share, editor can edit, reviewer can view, export and add comment items. There is no viewer role and no pending state. One of owner, admin, editor or reviewer.

hasAccountboolean

False for someone invited who has not signed up yet.

invitedboolean

Set on the response to a first add when the invitation mail went out.

Errors

429rate_limited

Too many requests.

Was this page helpful?