> ## 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.

# Modifier le rôle d’un membre du site

> Modifie le rôle d’un membre du site. Accepte une clé globale ou limitée si le site est autorisé et le créateur de la clé administrateur du site. Ne peut pas modifier le propriétaire de la clé ni celui de l’organisation.



## OpenAPI

````yaml fr/api-reference/openapi.json patch /api/v1/websites/{website_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/websites/{website_id}/members/{user_id}:
    parameters:
      - name: website_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: Identifiant unique du site
      - name: user_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: Identifiant unique de l’utilisateur cible
    patch:
      tags:
        - Team Management
      summary: Modifier le rôle d’un membre du site
      description: >-
        Modifie le rôle d’un membre du site. Accepte une clé globale ou limitée
        si le site est autorisé et le créateur de la clé administrateur du site.
        Ne peut pas modifier le propriétaire de la clé ni celui de
        l’organisation.
      operationId: updateWebsiteMemberRole
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateMemberRoleRequest'
      responses:
        '200':
          description: Rôle du membre mis à jour
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  member:
                    $ref: '#/components/schemas/WebsiteMember'
                required:
                  - success
                  - member
        '400':
          description: Requête incorrecte — corps ou paramètres de chemin invalides
          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 — accès au site non autorisé, modification de soi-même ou
            du propriétaire
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Introuvable — membre du site absent
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Erreur interne du serveur
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - apiKey: []
components:
  schemas:
    UpdateMemberRoleRequest:
      type: object
      description: Corps de modification du rôle d’un membre
      required:
        - role
      properties:
        role:
          type: string
          enum:
            - admin
            - viewer
          description: Nouveau rôle à attribuer au membre
          example: admin
    WebsiteMember:
      type: object
      description: Appartenance d’un utilisateur à un site précis
      required:
        - user_id
        - website_id
        - role
      properties:
        user_id:
          type: string
          format: uuid
          description: Identifiant unique de l’utilisateur
        website_id:
          type: string
          format: uuid
          description: Identifiant unique du site
        role:
          type: string
          enum:
            - admin
            - viewer
          description: Rôle du membre sur ce site
    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.