Members

Members are the people in your organization who can create assessments, invite candidates, and review scores. Members have one of four roles: owner, admin, member, or reviewer. The hierarchy is owner > admin > member > reviewer, and each role includes what the role below it can do. See Members and permissions for the full matrix.

Role	Permissions
Owner	Full access. Billing, SSO/SCIM/MFA, data retention, and the audit log, plus management of admins and owners.
Admin	Org profile and branding, API keys, ATS integrations, management of members and reviewers, and permanent deletion.
Member	The everyday recruiting work: create and edit assessments, invite candidates, score, calibrate, and release feedback.
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

string

default:"reviewer"

Role to assign: owner, admin, member, or reviewer

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

string

required

New role: owner, admin, member, 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
}

Overview

Endpoints

Members

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

Members

List Members

Invite Member

Update Member Role

Resend Member Invite

Remove Member