curl --request GET \
--url https://api-prod.heliyos.ai/v1/auth/team-memberships \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/auth/team-memberships', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api-prod.heliyos.ai/v1/auth/team-memberships"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"meta": {
"message": "Team members fetched successfully.",
"pagination": {
"count": 2,
"page": 1,
"pageSize": 20
}
},
"data": [
{
"_id": "66a0f1e2d3c4b5a697882222",
"id": "66a0f1e2d3c4b5a697882222",
"email": "avery.chen@example.com",
"roleId": "66a0f1e2d3c4b5a697880a01",
"roleName": "OWNER",
"organizationId": "66a0f1e2d3c4b5a697887766",
"status": "REGISTERED",
"userId": "66a0f1e2d3c4b5a697881111",
"firstName": "Avery",
"lastName": "Chen",
"createdAt": "2026-06-02T08:00:00.000Z",
"updatedAt": "2026-06-02T08:00:00.000Z"
},
{
"_id": "6729e1f2a3b4c5d6e7f80912",
"id": "6729e1f2a3b4c5d6e7f80912",
"email": "jordan.lee@example.com",
"roleId": "66a0f1e2d3c4b5a697880a03",
"roleName": "MEMBER",
"organizationId": "66a0f1e2d3c4b5a697887766",
"status": "SENT",
"createdAt": "2026-11-04T09:30:00.000Z",
"updatedAt": "2026-11-04T09:30:00.000Z"
}
]
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}List team members
Returns the workspace’s memberships: people who joined and invitations still pending, oldest
first. Each entry’s id is what Remove a team member and Change a team member’s role
take.
The list pages by page number: meta.pagination holds page, pageSize and count, the
total number of matching memberships.
curl --request GET \
--url https://api-prod.heliyos.ai/v1/auth/team-memberships \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/auth/team-memberships', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api-prod.heliyos.ai/v1/auth/team-memberships"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"meta": {
"message": "Team members fetched successfully.",
"pagination": {
"count": 2,
"page": 1,
"pageSize": 20
}
},
"data": [
{
"_id": "66a0f1e2d3c4b5a697882222",
"id": "66a0f1e2d3c4b5a697882222",
"email": "avery.chen@example.com",
"roleId": "66a0f1e2d3c4b5a697880a01",
"roleName": "OWNER",
"organizationId": "66a0f1e2d3c4b5a697887766",
"status": "REGISTERED",
"userId": "66a0f1e2d3c4b5a697881111",
"firstName": "Avery",
"lastName": "Chen",
"createdAt": "2026-06-02T08:00:00.000Z",
"updatedAt": "2026-06-02T08:00:00.000Z"
},
{
"_id": "6729e1f2a3b4c5d6e7f80912",
"id": "6729e1f2a3b4c5d6e7f80912",
"email": "jordan.lee@example.com",
"roleId": "66a0f1e2d3c4b5a697880a03",
"roleName": "MEMBER",
"organizationId": "66a0f1e2d3c4b5a697887766",
"status": "SENT",
"createdAt": "2026-11-04T09:30:00.000Z",
"updatedAt": "2026-11-04T09:30:00.000Z"
}
]
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}heliyos_team_members_list.Authorizations
A workspace API key, sent as Authorization: Bearer heliyos_.... Create one in Heliyos under Settings → API keys. A key acts as a workspace admin in the one workspace it was created in.
Query Parameters
Text to match, case-insensitive and literally, in the email address, first name or last name. Up to 200 characters. Empty matches everyone.
200The page number, starting at 1. Defaults to 1.
x >= 1Memberships per page, 1 to 100. Defaults to 20.
1 <= x <= 100Only memberships with this role. Workspace roles are OWNER, ADMIN and MEMBER, plus AGENCY in an agency workspace. The other accepted values are Heliyos staff roles and match no one in a workspace. Empty means every role.
ADMIN, OWNER, MEMBER, AGENCY, SUPER_ADMIN, STAFF, SUPPORT, Was this page helpful?

