Skip to content

Update A Workspace Member By Email

PATCH
/shares/workspace/members/by-email/{email}
curl --request PATCH \
--url https://app.metakip.com/api/v1/shares/workspace/members/by-email/hello%40example.com \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "role": "viewer" }'
email
required
string format: email

The recipient email address.

Media typeapplication/json
object
role
required
string
Allowed values: viewer commenter editor admin

Workspace role updated.

Media typeapplication/json
object
ok
required
boolean
message
required
string
Example
{
"ok": true
}

The API token is missing a required scope: pages:write.

Media typeapplication/json

Structured error returned when the request cannot be completed.

object
error
required

Error details for programmatic handling.

object
code
required

Stable error code.

string
message
required

Human-readable explanation.

string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}