For Developers

Team Members Overview

A Team Member represents a user membership within an Edlink team organization. Memberships associate users with the team and hold one or more role assignments (team_role_assignments) that dictate system permissions.

Properties

PropertyTypeDescription
idUUIDMembership unique identifier.
created_dateDateDate when the user joined the team.
updated_dateDateLast modification timestamp.
stateStringMembership state (active, inactive).
userObjectAssociated user details (id, first_name, last_name, email, picture_url, two_factor_enabled).
team_role_assignmentsArrayList of team role assignments granted to this member, populated with their assigned team_role objects.

Role Assignments

Role assignments are managed through dedicated sub-resource endpoints (/api/v2/teams/:team_id/members/:membership_id/assignments). A member can hold multiple roles simultaneously, and their effective permissions on the team represent the union of all permissions across their assigned roles. Creating or deleting an assignment of the Edlink-managed Owner role requires the caller to already hold that role.

The available assignment operations are:

MethodPath (relative to /api/v2/teams/:team_id/members/:membership_id)PermissionReference
GET/assignmentsteam_role_assignments.readList assignments
POST/assignmentsteam_role_assignments.createAssign a role
GET/assignments/:assignment_idteam_role_assignments.readFetch assignment
DELETE/assignments/:assignment_idteam_role_assignments.deleteRevoke assignment

There is no assignment PATCH or PUT endpoint. To change an assigned role, revoke the old assignment and create a new one. POST accepts only team_role_id; targets is returned as an empty array for new assignments and cannot be set through these endpoints. POST returns HTTP 201, including when it returns an existing assignment. Fetching or deleting an assignment from a different membership returns 403; a missing assignment returns 404.

JSON Example

{
    "id": "6a9e99a8-e165-4d0d-9b7d-6062a4be682d",
    "state": "active",
    "created_date": "2026-10-01T12:00:00.000Z",
    "updated_date": "2026-10-01T12:00:00.000Z",
    "user": {
        "id": "7ca194a2-1982-4f91-8841-59128aa10234",
        "first_name": "Jane",
        "last_name": "Doe",
        "email": "jane.doe@acmelearning.com",
        "two_factor_enabled": true
    },
    "team_role_assignments": [
        {
            "id": "e0b5f126-7c39-4458-9419-f53eb49f4851",
            "targets": [],
            "team_role": {
                "id": "391593c7-f439-45ff-a2b5-ffb4cc013037",
                "name": "Editor",
                "description": "Broad read and write access to team resources, without role/block administration or team create."
            }
        }
    ]
}