Members
Manage organization membership. Member endpoints are scoped to an organization.
Authentication
Authorization: Bearer <YOUR_API_TOKEN>
Roles: OWNER, ADMIN, MEMBER
Status: ACTIVE, INVITED, SUSPENDED
Updating or removing members requires ADMIN or OWNER. Promoting a member to OWNER requires OWNER.
List Members
Lists members of the selected organization.
GET /tha/v3/orgs/{org_slug}/members
| Query | Type | Description |
|---|---|---|
limit | integer | Max items. |
cursor | string | Pagination cursor. |
role | string | Filter by role: OWNER, ADMIN, MEMBER. |
status | string | Filter by status: ACTIVE, INVITED, SUSPENDED. |
Response
Each item in items:
| Field | Type | Description |
|---|---|---|
uid | string | Membership UID. |
user | object | { "email", "username" }. |
role | string | Member role. |
status | string | Membership status. |
invited_by_user | object | { "email", "username" } of inviter. |
joined_at | string | ISO 8601 join timestamp, if active. |
created_at | string | ISO 8601 creation timestamp. |
updated_at | string | ISO 8601 last update timestamp. |
Get Member
Retrieves a member by username.
GET /tha/v3/orgs/{org_slug}/members/{username}
Returns a Membership object.
Update Member
Updates a member's role.
PATCH /tha/v3/orgs/{org_slug}/members/{username}
Request Body
| Field | Type | Description |
|---|---|---|
role | string | Required. New role: OWNER, ADMIN, or MEMBER. |
Delete Member
Removes a member from the organization.
DELETE /tha/v3/orgs/{org_slug}/members/{username}
Returns 204 No Content.
Errors
| Status Code | Description |
|---|---|
| 400 | Invalid request or query parameters. |
| 401 | Invalid or missing token. |
| 403 | Insufficient role. |
| 404 | Member not found. |
| 500 | Server error. |