> ## Documentation Index
> Fetch the complete documentation index at: https://developers.flowestate.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Members

> List the people in your FlowEstate organization.

Members are the human users who belong to the calling organization. Useful for assigning leads (`assignedToId`), routing notifications, or building dashboards that show team activity.

***

## List members

```http theme={null}
GET /members
```

**Scope:** `members:read`. Lists the organization's members with their role.

### Response 200

```json theme={null}
{
  "data": [
    {
      "id": "mem_...",
      "role": "owner",
      "createdAt": "2025-08-01T12:00:00.000Z",
      "updatedAt": "2025-08-01T12:00:00.000Z",
      "user": {
        "id": "user_...",
        "name": "Ada Lovelace",
        "email": "ada@example.com",
        "image": null,
        "locale": "es"
      }
    }
  ]
}
```

### Fields

| Field         | Description                                                             |
| ------------- | ----------------------------------------------------------------------- |
| `id`          | Membership identifier. Use this to look up a single member.             |
| `role`        | `owner`, `admin`, or `member`.                                          |
| `user.id`     | The user identifier — pass this on `assignedToId` when assigning leads. |
| `user.name`   | Display name.                                                           |
| `user.email`  | Email.                                                                  |
| `user.image`  | URL of the avatar, or `null`.                                           |
| `user.locale` | Preferred locale code (`en`, `es`).                                     |

***

## Get a member

```http theme={null}
GET /members/{memberId}
```

**Scope:** `members:read`. Same shape, single record. `404 NOT_FOUND` for cross-org lookups.
