Skip to main content
DELETE
/
api
/
public
/
teams
/
{teamId}
/
members
/
{coworkerId}
{
  "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

ContextSource 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.
MethodEndpointDescription
POST/api/public/teams/{teamId}/membersAdd members to a team
GET/api/public/teams/{teamId}/profileFull team profile
GET/api/public/teams/myList the customer’s teams
PUT/api/public/teams/{teamId}/permissions/{memberId}Update member permissions