> ## Documentation Index
> Fetch the complete documentation index at: https://reach-owl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Team Members: Invite, Update, and Remove

> Manage who has access to your ReachOwl team. List current members, add by email, update role and status, or remove members permanently.

Team members determine who can access your ReachOwl workspace. Invite colleagues by email, change their role or activation status, and remove members who no longer need access. All operations require an authenticated team owner or admin token.

## List team members

Retrieve the current roster of your team.

```bash theme={null}
curl -X GET https://api.reachowl.com/api/v1/team/members \
  -H "Authorization: Bearer <token>"
```

## Invite a member

Send an invitation to a user by email. The default role is `agent`.

```bash theme={null}
curl -X POST https://api.reachowl.com/api/v1/team/add \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "teammate@example.com",
    "role": "agent"
  }'
```

<ParamField body="email" type="string" required>
  The email address of the person you want to invite.
</ParamField>

<ParamField body="role" type="string" required>
  Role to assign. Use `agent` for standard team members.
</ParamField>

## Update a member

Change a member's role or status after they have joined.

```bash theme={null}
curl -X POST https://api.reachowl.com/api/v1/team/members/store \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 56,
    "user_id": 78,
    "status": "active",
    "role": "agent"
  }'
```

<ParamField body="id" type="integer" required>
  The membership record ID.
</ParamField>

<ParamField body="user_id" type="integer" required>
  The user ID associated with this member.
</ParamField>

<ParamField body="status" type="string" required>
  Membership status. Use `active` to enable access.
</ParamField>

<ParamField body="role" type="string" required>
  Role to assign to the member.
</ParamField>

## Remove a member

Permanently delete a member from the team.

```bash theme={null}
curl -X DELETE https://api.reachowl.com/api/v1/team/members/56 \
  -H "Authorization: Bearer <token>"
```

<ParamField path="id" type="integer" required>
  The membership record ID to delete.
</ParamField>