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

# Retirer un membre de l’organisation

> Supprime un utilisateur de votre organisation. Nettoie également les éventuelles lignes website_members superflues de cet utilisateur sur tous les sites de l’organisation, dans une transaction unique. Nécessite une clé API globale. Ne peut supprimer l’utilisateur propriétaire de la clé API, le propriétaire de l’organisation ou le dernier administrateur restant.



## OpenAPI

````yaml fr/api-reference/openapi.json delete /api/v1/organizations/members/{user_id}
openapi: 3.1.0
info:
  title: API AthenaHQ
  description: >-
    L’API AthenaHQ permet de gérer vos sites et prompts par programme pour
    l’optimisation de contenu par IA.
  version: 1.0.0
  contact:
    email: support@athenahq.ai
servers:
  - url: https://api.athenahq.ai
    description: Serveur de production
security:
  - apiKey: []
tags:
  - name: Basics
    description: Opérations API principales pour gérer sites et prompts
  - name: Metrics
    description: Points de terminaison de métriques et analyses de visibilité IA
  - name: Billing
    description: Points de facturation et crédits pour gérer la consommation
  - name: Team Management
    description: Points de terminaison de gestion des membres et invitations
  - name: Groups
    description: Points de terminaison de gestion des groupes de sites
  - name: Content
    description: >-
      Points de terminaison Content Hub : onglets, URL suivies et détail des
      prompts par URL.
  - name: Pitch Workspace
    description: >-
      Points de terminaison des rapports Pitch Workspace : exécutions à
      l’échelle de l’organisation avec concurrents, prompts, attributs et
      métriques agrégées.
  - name: Knowledge Base
    description: >-
      Endpoints de lecture de la base de connaissances de la marque — faits
      approuvés et piliers qui les organisent.
paths:
  /api/v1/organizations/members/{user_id}:
    parameters:
      - name: user_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: Identifiant unique de l’utilisateur cible
    delete:
      tags:
        - Team Management
      summary: Retirer un membre de l’organisation
      description: >-
        Supprime un utilisateur de votre organisation. Nettoie également les
        éventuelles lignes website_members superflues de cet utilisateur sur
        tous les sites de l’organisation, dans une transaction unique. Nécessite
        une clé API globale. Ne peut supprimer l’utilisateur propriétaire de la
        clé API, le propriétaire de l’organisation ou le dernier administrateur
        restant.
      operationId: removeOrgMember
      responses:
        '200':
          description: Membre supprimé
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: User removed from organization
                  websites_affected:
                    type: integer
                    description: >-
                      Nombre de lignes website_members résiduelles nettoyées
                      lors de la suppression en cascade.
                    example: 0
                required:
                  - success
                  - message
                  - websites_affected
        '400':
          description: Requête incorrecte - Format d’ID utilisateur invalide
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Non autorisé — clé API invalide ou absente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: >-
            Interdit - Clé non globale, modification de soi-même ou du
            propriétaire
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                not_global:
                  value:
                    error: 'Forbidden: global API key required'
                self_modification:
                  value:
                    error: You cannot modify your own membership
                owner_modification:
                  value:
                    error: Cannot modify the organization owner
        '404':
          description: Introuvable - Le membre de l’organisation n’existe pas
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Organization member not found
        '409':
          description: Conflit — impossible de retirer le dernier administrateur
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Cannot remove the last admin from the organization
        '500':
          description: Erreur interne du serveur
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - apiKey: []
components:
  schemas:
    Error:
      type: object
      description: Objet de réponse d’erreur
      required:
        - error
      properties:
        error:
          type: string
          description: Message expliquant l’erreur
          example: Unauthorized
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Clé API d’authentification. Créez-en une
        [ici](https://app.athenahq.ai/organization?tab=api).

````

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