Skip to main content

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

QueryTypeDescription
limitintegerMax items.
cursorstringPagination cursor.
rolestringFilter by role: OWNER, ADMIN, MEMBER.
statusstringFilter by status: ACTIVE, INVITED, SUSPENDED.

Response

Each item in items:

FieldTypeDescription
uidstringMembership UID.
userobject{ "email", "username" }.
rolestringMember role.
statusstringMembership status.
invited_by_userobject{ "email", "username" } of inviter.
joined_atstringISO 8601 join timestamp, if active.
created_atstringISO 8601 creation timestamp.
updated_atstringISO 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

FieldTypeDescription
rolestringRequired. 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 CodeDescription
400Invalid request or query parameters.
401Invalid or missing token.
403Insufficient role.
404Member not found.
500Server error.