Skip to navigation

Set Member App Role

Set a member’s role in one app: admin, member or viewer. Requires appRoles:write. A key may set anybody’s, in any app; so may a signed-in workspace owner or admin. An admin of the app may set roles in that app alone, other admins of it included (403 forbidden elsewhere). A workspace owner’s or admin’s app roles cannot be changed: they are admin of every app (409 workspace_admin). Setting the role somebody already has changes nothing. A role neither gives nor takes a seat.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

userIdstringRequired
appstringRequired

The app’s slug, such as okrhub.

Request

This endpoint expects an object.
roleenumRequired

What somebody may do in one app, on top of their workspace role. A workspace owner or admin is admin of every app, always.

Allowed values:

Response

This endpoint returns an object.
userIdstring
appstring
The app's slug.
roleenum
Their role in the app now.
Allowed values:
previousenum
Their role in it before.
Allowed values:

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
422
Validation Error
429
Too Many Requests Error