API Reference
Log In
API Reference

Approve a join request

Approves a PENDING join request and creates the requester's User in your account's default team. Set role to ROLE_READ_ONLY, ROLE_ORG_ADMIN or ROLE_TENANT_ADMIN. If you leave role out, the person gets ROLE_READ_ONLY, the least access. The person is emailed that they were approved. Returns 409 if the request was already decided and 422 if it has expired. Callable by an Account Administrator (ROLE_TENANT_ADMIN) or a Team Administrator (ROLE_ORG_ADMIN). A Team Administrator can grant ROLE_READ_ONLY or ROLE_ORG_ADMIN. Only an Account Administrator of this account, or a platform administrator, can grant ROLE_TENANT_ADMIN.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Your account ID. Format: Revenium hashid (URL-safe encoded string).

string
required

The join request's id, from the list call.

Body Params

The role to give the person. Leave it out to give ROLE_READ_ONLY.

string | null
enum

The role to grant the approved member. Defaults to the least-privilege ROLE_READ_ONLY when omitted or blank.

Allowed:
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/hal+json
*/*