Guides
API reference
MCP server
ChangelogRemove a team member
curl --request DELETE \
--url https://api-prod.heliyos.ai/v1/auth/team-memberships/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/auth/team-memberships/{id}', 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/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text){
"meta": {
"message": "Team membership revoked successfully."
},
"data": {
"deleted": true
}
}{
"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>"
}
}Team
Remove a team member
Removes a person from the workspace, or cancels a pending invitation, by membership id.
For a person who joined, removal takes effect at once: their sessions in the workspace end, the API keys they created in it are revoked, and they no longer appear in the workspace. A cancelled invitation’s link stops working. To bring someone back, invite them again.
Only owners and admins can remove members. Only an owner can remove an owner, and the workspace’s last owner cannot be removed.
DELETE
/
v1
/
auth
/
team-memberships
/
{id}
Remove a team member
curl --request DELETE \
--url https://api-prod.heliyos.ai/v1/auth/team-memberships/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/auth/team-memberships/{id}', 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/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text){
"meta": {
"message": "Team membership revoked successfully."
},
"data": {
"deleted": true
}
}{
"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>"
}
}API keys cannot call this endpoint: it answers
403 FORBIDDEN_ACTION (“API keys cannot
access this endpoint.”). Remove members in Heliyos under Settings, Team. Removal cannot be
undone.In the Heliyos MCP server:
heliyos_team_members_remove.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.
Path Parameters
The membership id, from List team members.
Pattern:
^[0-9a-fA-F]{24}$Was this page helpful?