> ## Documentation Index
> Fetch the complete documentation index at: https://developer.meetergo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a user

> Permanently deletes a user from your company with optional resource transfer. Only company admins can delete users. You cannot delete yourself or the company owner. Before deletion, you can optionally transfer the user's resources (meeting types, forms, workflows, showcases, availabilities, qualifiers) to another user in your company by providing a targetUserId. This operation cannot be undone.



## OpenAPI

````yaml /openapi.json delete /v4/user/{id}
openapi: 3.0.0
info:
  title: meetergo Platform API
  description: >-
    Comprehensive scheduling API for creating users, managing availability,
    handling bookings, and connecting calendar providers. Enables seamless
    integration with external platforms and applications.
  version: 0.0.0
  contact: {}
  termsOfService: https://www.meetergo.com/tos/
servers: []
security: []
tags:
  - name: User V4
    description: Create and manage users in your workspace
  - name: Meeting Type V4
    description: Configure meeting templates with durations, buffers, and conferencing
  - name: availability
    description: Manage weekly schedules and availability settings
  - name: Booking V4
    description: Create new bookings
  - name: Booking Availability V4
    description: Query available time slots for booking
  - name: Appointment V4
    description: Manage existing appointments
  - name: Attendee V4
    description: Manage attendee details and notes
  - name: Calendar Connections V4
    description: Connect and sync external calendars
  - name: One Time Booking Link V4
    description: Create single-use booking links
  - name: availability-exception
    description: Override availability for specific dates
  - name: Booking Link V4
    description: Configure various booking page types
  - name: Personal Page V4
    description: Manage user profile pages
  - name: Handoff V4
    description: Reassign meetings to other hosts
  - name: Calendar Auth V4
    description: OAuth callbacks for calendar providers
  - name: Queue V4
    description: Round-robin and queue-based routing (Beta)
  - name: Queue User Group V4
    description: Manage queue user groups (Beta)
  - name: Meeting Type Template V4
    description: Reusable meeting type configurations (Beta)
  - name: Attendee Pending V4
    description: Manage pending attendee approvals (Beta)
  - name: Provisional Booking V4
    description: Manage provisional/unconfirmed bookings (Beta)
paths:
  /v4/user/{id}:
    delete:
      tags:
        - User V4
      summary: Delete a user
      description: >-
        Permanently deletes a user from your company with optional resource
        transfer. Only company admins can delete users. You cannot delete
        yourself or the company owner. Before deletion, you can optionally
        transfer the user's resources (meeting types, forms, workflows,
        showcases, availabilities, qualifiers) to another user in your company
        by providing a targetUserId. This operation cannot be undone.
      operationId: deleteUser
      parameters:
        - name: id
          required: true
          in: path
          description: Unique identifier of the user to delete
          schema:
            example: 123e4567-e89b-12d3-a456-426614174000
            type: string
      requestBody:
        required: false
        description: >-
          Optional resource transfer configuration. Specify targetUserId to
          transfer resources to another user. You can selectively choose which
          resource types to transfer (all enabled by default).
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteUserWithTransferDto'
            examples:
              withTransfer:
                summary: Delete with resource transfer
                description: Delete user and transfer all resources to another user
                value:
                  targetUserId: 987e6543-e21b-12d3-a456-426614174000
                  transferMeetingTypes: true
                  transferForms: true
                  transferWorkflows: true
                  transferShowcases: true
                  transferAvailabilities: true
                  transferQualifiers: true
              withoutTransfer:
                summary: Delete without transfer
                description: Delete user without transferring resources
                value: {}
              selectiveTransfer:
                summary: Selective resource transfer
                description: Transfer only meeting types and forms
                value:
                  targetUserId: 987e6543-e21b-12d3-a456-426614174000
                  transferMeetingTypes: true
                  transferForms: true
                  transferWorkflows: false
                  transferShowcases: false
                  transferAvailabilities: false
                  transferQualifiers: false
      responses:
        '200':
          description: User deleted successfully
        '400':
          description: Bad request - Cannot delete yourself or user not found
        '403':
          description: >-
            Forbidden - Only admins can delete users or cannot delete company
            owner
        '404':
          description: User not found or does not belong to your company
      security:
        - ApiUserHeader: []
        - JWT: []
        - ApiKey: []
components:
  schemas:
    DeleteUserWithTransferDto:
      type: object
      properties:
        transferMeetingTypes:
          type: boolean
          default: true
          description: Whether to transfer meeting types
        transferForms:
          type: boolean
          default: true
          description: Whether to transfer forms
        transferWorkflows:
          type: boolean
          default: true
          description: Whether to transfer workflows/reminders
        transferShowcases:
          type: boolean
          default: true
          description: Whether to transfer showcases/funnels
        transferAvailabilities:
          type: boolean
          default: true
          description: Whether to transfer availabilities
        transferQualifiers:
          type: boolean
          default: true
          description: Whether to transfer qualifiers
        targetUserId:
          type: string
          format: uuid
          description: ID of the user to transfer resources to
          example: 123e4567-e89b-12d3-a456-426614174000
  securitySchemes:
    ApiUserHeader:
      type: apiKey
      in: header
      name: x-meetergo-api-user-id
      description: >-
        User ID to act on behalf of. Platform API Keys only (required with an
        API Key unless the endpoint states otherwise). Requests authenticated
        with a Personal Access Token are rejected if this header names another
        user.
    JWT:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: JWT Bearer token for standard user authentication
    ApiKey:
      scheme: bearer
      bearerFormat: API Key
      type: http
      description: >-
        Bearer token: a Platform API Key (format: ak_live:<uuid>:<secret>) or a
        Personal Access Token (format: rgo-...). PATs always act as the token
        owner.

````