Manage Team Members and Permissions

Invite agents to your ReachOwl team, update their roles, and remove members using the Team API endpoints.

Use the ReachOwl Team API to control workspace membership. This guide shows you how to list your teams, view current members, add new agents, update roles, and remove members.

1. List your teams

   First, retrieve the teams you belong to so you can save the team_id you want to manage.

   Request

   curl -X GET "{{baseUrl}}/api/v1/teams" \
     -H "Authorization: Bearer {token}"
   

   Save the id value from the team you want to work with.

2. List current members

   Get the list of existing members for your team.

   Request

   curl -X GET "{{baseUrl}}/api/v1/team/members" \
     -H "Authorization: Bearer {token}"
   
3. Add a member

   Invite a new member by sending a POST request with the email address and role. The example below invites an agent.

   Request

   curl -X POST "{{baseUrl}}/api/v1/team/add" \
     -H "Authorization: Bearer {token}" \
     -H "Content-Type: application/json" \
     -d '{
       "email": "[e-mail]",
       "role": "agent"
     }'
   
4. Update a member

   Change a member’s role or status by sending a POST request to /api/v1/team/members/store.

   Request

   curl -X POST "{{baseUrl}}/api/v1/team/members/store" \
     -H "Authorization: Bearer {token}" \
     -H "Content-Type: application/json" \
     -d '{
       "id": 11,
       "user_id": 8,
       "status": "active",
       "role": "agent"
     }'
   
5. Remove a member

   Remove a member from the team by sending a DELETE request with the member record ID.

   Request

   curl -X DELETE "{{baseUrl}}/api/v1/team/members/11" \
     -H "Authorization: Bearer {token}"
   

Only team admins can add, update, or remove members. If you receive a 403 response, check that your bearer token belongs to a user with admin permissions on the selected team.