---
title: "TeamMember"
description: "The `TeamMember` entity."
section: "Reference"
group: "Types"
order: 227
---

## Definition

```ts
interface TeamMember {
  id: string;
  teamId: string;
  userId: string;
  role: "viewer" | "editor" | "admin";
  createdAt: string;
}
```

## Fields

| Field       | Type                              | Notes                                                                                                                                          |
| ----------- | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`        | `string`                          | `readonly` `required`                                                                                                                          |
| `teamId`    | `string`                          | `required` — Team the membership is in.                                                                                                        |
| `userId`    | `string`                          | `required` — User represented by this membership.                                                                                              |
| `role`      | `"viewer" \| "editor" \| "admin"` | `required` — Member role within the team (gates team management — rename, add/remove members — only; does NOT affect entity permission tiers). |
| `createdAt` | `string`                          | `readonly` `required` — ISO-8601 timestamp when the membership was created.                                                                    |