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.
typeStringLegacy membership tier (owner, readwrite, read).
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/:member_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.

JSON Example

{
    "id": "6a9e99a8-e165-4d0d-9b7d-6062a4be682d",
    "type": "readwrite",
    "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",
            "team_role_id": "391593c7-f439-45ff-a2b5-ffb4cc013037",
            "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."
            }
        }
    ]
}