> ## Documentation Index > Fetch the complete documentation index at: https://developer.zeeg.me/llms.txt > Use this file to discover all available pages before exploring further. # Remove a Team Member > Remove a member from a team. Their scheduling pages move to a team manager, switched off, and the response lists them. ## OpenAPI ````yaml DELETE /teams/{teamId}/members/{memberId} openapi: 3.0.0 info: title: Zeeg Public API description: >- Zeeg public API documentation. ## Authentication All endpoints require a Bearer token. You can generate an API token from [your Zeeg dashboard](https://app.zeeg.me/account/settings/api-access). Each token is scoped to specific permissions (e.g. `events:read`, `webhooks:write`). Make sure your token has the required scopes for the endpoints you want to use. ## Responses Every response is JSON, whatever `Accept` header the request sends. version: 2.0.0 x-logo: url: https://app.zeeg.me/img/logo-dark.2ca83593.svg backgroundColor: '#f7f7f9' altText: zeeg contact: name: Zeeg Support email: support@zeeg.me url: https://zeeg.me/en/contact license: name: Proprietary url: https://zeeg.me/en/legal/terms termsOfService: https://zeeg.me/en/legal/terms servers: - url: https://api.zeeg.me/v2 description: Production security: - bearer: [] tags: - name: Scheduled Events description: Management of events scheduled via Zeeg - name: Scheduling Pages description: Scheduling pages information and management - name: Availability Schedule description: Read and change availability for users - name: Webhooks description: Webhooks management - name: Notes description: Notes for scheduled events - name: Workspaces & Teams description: Workspace users and team member management - name: AI Agent description: AI Agent integration endpoints - name: Payloads description: Webhook payload schemas - name: CRM - Objects description: >- Discover the schema of CRM objects (standard and custom) including all attribute definitions - name: CRM - Companies description: Create, read, update, and delete CRM company records - name: CRM - People description: Create, read, update, and delete CRM person records - name: Routing Forms - Forms description: Read routing forms with their questions and their routes - name: Routing Forms - Submissions description: Read and delete the submissions that invitees send through a routing form paths: /teams/{teamId}/members/{memberId}: parameters: - schema: type: string in: path name: teamId required: true description: The UUID or the slug of the team. The slug match ignores case. - schema: type: integer in: path name: memberId required: true description: >- The team-member id, from `GET /teams/{teamId}/members` or `POST /teams/{teamId}/members`. It is not the user's id. delete: tags: - Workspaces & Teams summary: Remove a team member description: >- Removes a member from a team. The person stays in the workspace. Scheduling pages the member hosts alone, and their own pages in the team, move to a manager of the team, switched off and titled with the member's name; the response lists them. When the team has no other manager and you are not in the team, the pages would have nobody to move to, so the removal is refused with 422 and nothing changes: make another member a manager first. The team's managers, the workspace owner and partners can remove members. Nobody can remove themselves or a team's only manager. **Required scope:** `teams:write` operationId: delete-teams-teamId-members-memberId responses: '200': description: OK content: application/json: schema: type: object properties: success: type: boolean example: true status: type: integer example: 200 data: type: object properties: reassignedEventTypes: type: array description: >- The scheduling pages that moved to a manager, switched off. items: type: object properties: id: type: string format: uuid title: type: string previousHostName: type: string examples: Member removed: value: success: true status: 200 data: reassignedEventTypes: - id: 5b0c7d2e-8f41-4a39-9d6e-2c3f1a7b8e90 title: '[Marco Rossi''s] Onboarding call' previousHostName: Marco Rossi '401': $ref: '#/components/responses/401' '403': description: The token misses the scope, or you may not remove this member. content: application/json: schema: $ref: '#/components/schemas/WorkspaceError' examples: Only manager: value: success: false message: The user is the only team's manager. status: 403 '404': description: No such member in a team of your workspace. content: application/json: schema: $ref: '#/components/schemas/WorkspaceError' '422': description: >- The removal would delete scheduling pages that nobody can take over. Nothing was removed. content: application/json: schema: $ref: '#/components/schemas/WorkspaceError' examples: Pages would be deleted: value: success: false message: >- Nothing was removed: this member is the only host of "Sales demo", and with no other team manager to take them over, these scheduling pages would be deleted. Make another member a manager first, then try again. The pages then move to that manager, switched off. status: 422 security: - bearer: [] components: responses: '401': description: Unauthorized content: application/json: schema: type: object properties: message: type: string example: Unauthenticated. examples: Unauthenticated: value: message: Unauthenticated. schemas: WorkspaceError: type: object description: The error envelope of the team and invitation endpoints. properties: success: type: boolean example: false message: type: string status: type: integer securitySchemes: bearer: type: http scheme: bearer description: '' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.