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

# Deactivate an organization user

> Block a teammate from an organization without removing them. Their roles are cleared, and you can reactivate them later.

A deactivated user keeps their membership, team memberships, assigned sessions, and history, but can't use the organization, and all of their roles are cleared. In [list users](https://docs.open.cx/api-reference/users/list.md), they appear with `status: "deactivated"`.

A user deactivated in every organization they belong to can't sign in, and their open sessions end, unless an invitation is waiting for them. The organization owner can't be deactivated.

Deactivating someone who is already deactivated changes nothing. To undo it, [reactivate the user](https://docs.open.cx/api-reference/users/reactivate.md). Requires the `users:write` scope.


## OpenAPI

````yaml post /users/{user_id}/deactivate
openapi: 3.1.0
info:
  title: OpenCX API
  description: >

    OpenCX is an AI-powered, all-in-one platform for customer support and
    outbound communications.


    Use this API to manage your OpenCX organization's AI agents, actions,
    conversations, contacts, and more.


    To get started, generate a new API key from the dashboard.


    ## Authentication

    All API endpoints require authentication using a Bearer token. You can
    generate an API key from your OpenCX dashboard.


    ## Rate Limiting

    API requests are rate limited to ensure fair usage. The current limits are:

    - 100 requests per minute for standard endpoints

    - 1000 requests per minute for streaming endpoints


    ## Error Handling

    The API uses standard HTTP status codes and returns detailed error messages
    in the response body.
  version: 1.0-beta
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
  - url: http://localhost:8080
    description: Development
  - url: https://api.open.cx
    description: Production
security:
  - bearerAuth: []
paths:
  /users/{user_id}/deactivate:
    post:
      summary: Deactivate a user in the organization
      description: >-
        Keep the user's membership but block their access to this organization
        and clear their roles. Their team memberships, assigned sessions and
        history stay as they are. A user deactivated in every organization they
        belong to can no longer sign in. The organization owner cannot be
        deactivated. Unlike removing a user, this can be undone with the
        reactivate endpoint.
      operationId: deactivateOrgUser
      parameters:
        - schema:
            type: integer
            exclusiveMinimum: 0
            maximum: 9007199254740991
          in: path
          name: user_id
          required: true
          description: Organization user ID
      responses:
        '204':
          description: Default Response
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
components:
  schemas:
    ErrorDto:
      type: object
      properties:
        statusCode:
          type: integer
        message:
          type: string
        error:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.