Members

Members are the admin users in your organization who can create assessments, invite candidates, and review scores. Members have one of three roles: owner, admin, or reviewer.

Role	Permissions
Owner	Full access. Can manage members, billing, and all settings.
Admin	Can create/edit assessments, invite candidates, review scores, manage API keys.
Reviewer	Read-only access to assessments, sessions, and scores.

List Members

GET /api/members

Requires admin role (owner or admin).

Response

{
  "members": [
    {
      "id": "uuid",
      "email": "alice@company.com",
      "name": "Alice Chen",
      "role": "owner",
      "createdAt": "2025-01-10T09:00:00Z"
    }
  ]
}

Invite Member

POST /api/members

Invites a new member to your organization. They’ll receive an email with a magic link to join.

string

required

Email address of the person to invite

role

string

default:"reviewer"

Role to assign: owner, admin, or reviewer

sendEmail

boolean

default:"true"

When false, the member is created but Gradient does not send the magic-link invitation email — deliver your own using the member’s email. The response’s inviteEmailSent reflects what actually happened.

Response - 201 Created

name defaults to the email’s local part (before the @) until the member sets their own; inviteEmailSent reports whether the invitation email was sent.

{
  "member": {
    "id": "uuid",
    "email": "bob@company.com",
    "name": "bob",
    "role": "admin",
    "createdAt": "2025-01-15T10:00:00Z"
  },
  "inviteEmailSent": true
}

Update Member Role

PATCH /api/members/:id

role

string

required

New role: owner, admin, or reviewer

Response

{
  "member": {
    "id": "uuid",
    "email": "bob@company.com",
    "role": "admin"
  }
}

Resend Member Invite

POST /api/members/:id/resend

Resends the invitation email to a member who hasn’t yet accepted.

Response

{
  "ok": true
}

Remove Member

DELETE /api/members/:id

Removes a member from your organization. You cannot remove yourself.

An organization must always have at least one owner.

Response

{
  "ok": true
}

​Members

​List Members

​Invite Member

​Update Member Role

​Resend Member Invite

​Remove Member

Members

List Members

Invite Member

Update Member Role

Resend Member Invite

Remove Member