Manage the members of your organization, including listing members, updating roles, and transferring ownership.
Endpoints
| Method | Endpoint | Description |
|---|
GET | /v1/orgs/:org_id/members | List members |
DELETE | /v1/orgs/:org_id/members/:member_id | Remove member (admin+) |
PATCH | /v1/orgs/:org_id/members/:member_id/role | Update role (owner only) |
POST | /v1/orgs/:org_id/members/:member_id/transfer-ownership | Transfer ownership (owner only) |
POST | /v1/orgs/:org_id/leave | Leave organization |
Member Object
{
"id": 1,
"email": "jane@example.com",
"first_name": "Jane",
"last_name": "Doe",
"role": "admin",
"created_at": "2025-01-01T00:00:00Z"
}
| Field | Type | Description |
|---|
id | integer | Unique identifier |
email | string | Member’s email address |
first_name | string | Member’s first name |
last_name | string | Member’s last name |
role | string | owner, admin, or member |
created_at | string | ISO 8601 timestamp |
Roles
| Role | Description |
|---|
owner | Full access, one per organization. Can manage all members and transfer ownership. |
admin | Can invite and remove members, manage resources. Cannot remove other admins. |
member | Can view and use resources. |
List Members
Retrieve all members of an organization.
curl https://api.thunderphone.com/v1/orgs/{org_id}/members \
-H "Authorization: Token YOUR_API_TOKEN"
Remove a Member
Remove a member from the organization. Requires admin or owner role.
curl -X DELETE https://api.thunderphone.com/v1/orgs/{org_id}/members/5 \
-H "Authorization: Token YOUR_API_TOKEN"
204 No Content
Admins can remove members, but only the owner can remove admins. You cannot remove yourself — use the leave endpoint instead. The owner cannot be removed.
Update Member Role
Change a member’s role. Only the organization owner can update roles.
curl -X PATCH https://api.thunderphone.com/v1/orgs/{org_id}/members/5/role \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"role": "admin"
}'
| Field | Type | Description |
|---|
role | string | New role: admin or member |
Transfer Ownership
Transfer organization ownership to another member. Only the current owner can perform this action. The current owner becomes an admin.
curl -X POST https://api.thunderphone.com/v1/orgs/{org_id}/members/5/transfer-ownership \
-H "Authorization: Token YOUR_API_TOKEN"
This action is irreversible without the new owner’s cooperation. The current owner will be demoted to admin.
Leave Organization
Leave an organization you are a member of.
curl -X POST https://api.thunderphone.com/v1/orgs/{org_id}/leave \
-H "Authorization: Token YOUR_API_TOKEN"
The organization owner cannot leave. You must transfer ownership first. You also cannot leave if it is your only organization. 