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

# Terminate an employee

> Deactivate/terminate an employee by setting their termination date.
This endpoint allows payroll providers to process employee terminations
and ensures proper benefit enrollment termination handling.




## OpenAPI

````yaml external-api-schema.yml post /v1/company-members/{company_member_id}/deactivate
openapi: 3.0.3
info:
  title: Vitable External Partner API
  version: 1.0.0
  description: >
    External API for Payroll Providers and PEO platforms to integrate with
    Vitable health plan products 

    for benefit administration. This API enables partner systems to manage
    benefit enrollment, 

    employee data, and plan information for their clients.


    Common integration scenarios:

    - Retrieve active benefit plans for employers

    - List enrolled employees for benefit periods  

    - Create and update employee records

    - Manage benefit enrollments and elections

    - Access enrollment status and eligibility information
servers:
  - url: https://api.vitablehealth.com
    description: Production server
  - url: https://api-staging.vitablehealth.com
    description: Staging server
security:
  - partnerApiKey: []
tags:
  - name: Company Benefits
    description: Benefit plans available to companies (plan years)
  - name: Company Members
    description: Employee management and information
  - name: Benefit Enrollments
    description: Employee benefit enrollment status and management
  - name: Member Benefits
    description: Individual employee benefit information
  - name: Benefit Eligibility
    description: Employee benefit eligibility information
  - name: Payroll Integration
    description: Payroll deduction and contribution calculations
  - name: Quoting
    description: Marketplace plan searches and insurance quotes
paths:
  /v1/company-members/{company_member_id}/deactivate:
    post:
      tags:
        - Company Members
      summary: Terminate an employee
      description: |
        Deactivate/terminate an employee by setting their termination date.
        This endpoint allows payroll providers to process employee terminations
        and ensures proper benefit enrollment termination handling.
      operationId: deactivate_company_member
      parameters:
        - in: path
          name: company_member_id
          schema:
            type: string
            format: uuid
          required: true
          description: Unique identifier for the employee to terminate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeactivateCompanyMemberRequest'
      responses:
        '200':
          description: Employee terminated successfully
      security:
        - partnerApiKey: []
components:
  schemas:
    DeactivateCompanyMemberRequest:
      type: object
      description: Request to terminate/deactivate an employee
      properties:
        termination_date:
          type: string
          format: date
          description: Date when the employee's termination becomes effective
      required:
        - termination_date
  securitySchemes:
    partnerApiKey:
      type: apiKey
      in: header
      name: X-Partner-API-Key
      description: Partner API key for external integrations

````