Overview

Add team members to your ValidGraph account. Team members share the account’s validation quota and can access projects based on their assigned role.

How It Works

1. Account owner invites team members via email
2. Invited users create accounts or link existing ones
3. Each member is assigned a role (Admin, Editor, Viewer)
4. All members share the account’s validation quota
5. Members are managed from the Team dashboard

Tier Availability

| Tier | Seats |
|——|——-|
| Free | 1 (owner only) |
| Pro | 1 (owner only) |
| Agency | 3 |
| Enterprise | 10 |

Related Features

– RBAC Roles: Define what each team member can do
– Viewer Project Scoping: Restrict viewer access to specific projects
– Usage Quotas: Shared quota management

Mini-Tutorial

Step 1: Access Team Settings

Go to Settings > Team Members (Agency+ only).

Step 2: Invite a Team Member

Click “Invite Member” and enter their email address.

Step 3: Choose a Role

Select Admin, Editor, or Viewer based on what they need to do:
– Admin: Full account access
– Editor: Validations, projects, exports
– Viewer: Read-only access (optionally scoped to specific projects)

Step 4: Send Invitation

An email is sent to the invitee. They create or log into their ValidGraph account and accept the invitation.

Step 5: Confirm Acceptance

Once they accept, they appear in your Team Members list with their role and last active date.

Step 6: Manage or Remove

Change roles anytime or remove members. Team members always share the account’s validation quota.

Technical Details

Invite Member

POST /api/v1/team/invite
{
  "email": "[email protected]",
  "role": "editor",
  "projects": []
}

Response:

{
  "invitation_id": "inv_abc123",
  "email": "[email protected]",
  "role": "editor",
  "status": "pending",
  "invited_at": "2025-03-22T14:30:00Z",
  "expires_at": "2025-04-22T14:30:00Z"
}

List Team Members

GET /api/v1/team

Response:

{
  "members": [
    {
      "id": "user_123",
      "email": "[email protected]",
      "role": "owner",
      "joined_at": "2025-01-01T10:00:00Z",
      "last_active": "2025-03-22T14:00:00Z"
    },
    {
      "id": "user_456",
      "email": "[email protected]",
      "role": "editor",
      "joined_at": "2025-02-15T09:00:00Z",
      "last_active": "2025-03-20T11:30:00Z"
    }
  ],
  "pending_invitations": [
    {
      "email": "[email protected]",
      "role": "viewer",
      "status": "pending",
      "expires_at": "2025-04-22T14:30:00Z"
    }
  ],
  "seats_available": 1
}

Remove Member

DELETE /api/v1/team/member/user_456

Immediate removal. User loses all access.

References

– Multi-Tenant User Management Patterns
– Role-Based Access Control (RBAC) Standards
– OAuth 2.0 Invitation Flow
– ValidGraph Team API