> ## 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 l’accès d’un membre de groupe

> Retire l’appartenance directe au groupe et les appartenances explicites aux sites actuellement membres, atomiquement. Idempotent : relance ou ID utilisateur valide sans ligne correspondante renvoie `200` avec `group_membership_removed: false` et `website_memberships_removed: 0`.

Conserve organisation, autres groupes et sites hors groupe. Un autre groupe donnant accès aux mêmes sites maintient cet accès effectif malgré la suppression de la ligne explicite. Les membres d’organisation reçoivent `409`, leur accès global persistant. Clé globale requise ; l’utilisateur de la clé ne peut être retiré. Aucun corps accepté.



## OpenAPI

````yaml fr/api-reference/openapi.json delete /api/v1/groups/{group_id}/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/groups/{group_id}/members/{user_id}:
    parameters:
      - name: group_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: Identifiant unique du groupe
      - 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 l’accès d’un membre de groupe
      description: >-
        Retire l’appartenance directe au groupe et les appartenances explicites
        aux sites actuellement membres, atomiquement. Idempotent : relance ou ID
        utilisateur valide sans ligne correspondante renvoie `200` avec
        `group_membership_removed: false` et `website_memberships_removed: 0`.


        Conserve organisation, autres groupes et sites hors groupe. Un autre
        groupe donnant accès aux mêmes sites maintient cet accès effectif malgré
        la suppression de la ligne explicite. Les membres d’organisation
        reçoivent `409`, leur accès global persistant. Clé globale requise ;
        l’utilisateur de la clé ne peut être retiré. Aucun corps accepté.
      operationId: removeGroupMemberAccess
      responses:
        '200':
          description: Suppression d’adhésion au niveau du groupe terminée
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - group_membership_removed
                  - website_memberships_removed
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                    example: true
                  group_membership_removed:
                    type: boolean
                    description: >-
                      Indique si une appartenance directe au groupe a été
                      supprimée
                    example: true
                  website_memberships_removed:
                    type: integer
                    minimum: 0
                    description: >-
                      Nombre de lignes d’adhésion explicite supprimées pour les
                      sites web actuellement dans le groupe
                    example: 3
        '400':
          description: Requête incorrecte - ID de groupe ou d’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 ou tentative de se retirer soi-même
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                not_global:
                  value:
                    error: 'Forbidden: global API key required'
                self_removal:
                  value:
                    error: You cannot remove your own membership
        '404':
          description: Introuvable — groupe absent de votre organisation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Group not found
        '409':
          description: >-
            Conflit - La cible est un membre de l’organisation dont l’accès
            hérité de l’organisation subsisterait
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: >-
                  User is an organization member: removing group-scoped
                  memberships would not revoke their organization-derived access
        '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.