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
| Property | Type | Description |
|---|---|---|
id | UUID | Membership unique identifier. |
created_date | Date | Date when the user joined the team. |
updated_date | Date | Last modification timestamp. |
type | String | Legacy membership tier (owner, readwrite, read). |
state | String | Membership state (active, inactive). |
user | Object | Associated user details (id, first_name, last_name, email, picture_url, two_factor_enabled). |
team_role_assignments | Array | List 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."
}
}
]
}
