Remove Team Member

Removes a member from a team by their customer ID.

DELETE /api/public/teams/{teamId}/members/{coworkerId}

Remove Team Member

cURL

curl --request DELETE \
  --url https://spaces.nexudus.com/api/public/teams/{teamId}/members/{coworkerId} \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://spaces.nexudus.com/api/public/teams/{teamId}/members/{coworkerId}"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://spaces.nexudus.com/api/public/teams/{teamId}/members/{coworkerId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

200

{
  "401 Unauthorized": {},
  "403 Forbidden": {},
  "400 Bad Request": {},
  "404 Not Found": {}
}

Remove Team Member

Removes a single member from a team. The customer cannot remove themselves — attempting to do so returns a CANNOT_REMOVE_ITSELF error. Members with active contracts should have their contracts cancelled before removal.

Authentication

Requires a valid customer bearer token. The customer must be a team administrator of the specified team.

Path Parameters

teamId · number · required

Numeric identifier of the team. Returned as Id from GET /api/public/teams/my.

coworkerId · number · required

Numeric identifier of the customer to remove. Returned as Id in the AllTeamMembers array from GET /api/public/teams/{teamId} /profile.

Response

Returns HTTP 200 OK with an empty body on success.

Examples

Remove a member

DELETE /api/public/teams/55/members/102
Authorization: Bearer {token}

Status: 200 OK
Body: (empty)

TypeScript Integration

import { endpoints } from '@/api/endpoints'

await httpClient.delete(endpoints.teams.removeMember(teamId, coworkerId))

Usage in Portal

Context	Source file
Team members table (/team/members/{teamId})	src/views/user/team/members/components/TeamMembersTableSection.tsx

Error Responses

401 Unauthorized · error

The customer is not authenticated or the session has expired.

403 Forbidden · error

The customer is not an administrator of the specified team.

400 Bad Request · error

The request is invalid — for example, the member has active contracts, or the response message is CANNOT_REMOVE_ITSELF when attempting self-removal.

404 Not Found · error

Team or member with the specified ID does not exist.

Related Endpoints

Method	Endpoint	Description
POST	/api/public/teams/{teamId}/members	Add members to a team
GET	/api/public/teams/{teamId}/profile	Full team profile
GET	/api/public/teams/my	List the customer’s teams
PUT	/api/public/teams/{teamId}/permissions/{memberId}	Update member permissions