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

# Eliminar miembro de la organización

> Elimina un usuario de tu organización. En una única transacción, también limpia sus filas huérfanas de website_members en todos los sitios de la organización. Requiere una clave global. No permite eliminar al usuario propietario de la clave, al propietario de la organización ni al último administrador.



## OpenAPI

````yaml es/api-reference/openapi.json delete /api/v1/organizations/members/{user_id}
openapi: 3.1.0
info:
  title: API de AthenaHQ
  description: >-
    La API de AthenaHQ ofrece acceso programático para gestionar tus sitios web
    y consultas para optimizar el contenido con IA.
  version: 1.0.0
  contact:
    email: support@athenahq.ai
servers:
  - url: https://api.athenahq.ai
    description: Servidor de producción
security:
  - apiKey: []
tags:
  - name: Basics
    description: Operaciones principales de la API para gestionar sitios web y consultas
  - name: Metrics
    description: Endpoints de métricas y análisis para monitorizar la visibilidad en IA
  - name: Billing
    description: Endpoints de facturación y créditos para gestionar el uso
  - name: Team Management
    description: Endpoints para gestionar miembros del equipo e invitaciones
  - name: Groups
    description: Endpoints para gestionar grupos de sitios web
  - name: Content
    description: >-
      Endpoints para acceder a los datos del centro de contenidos: pestañas, URL
      monitorizadas y desglose de consultas por URL.
  - name: Pitch Workspace
    description: >-
      Endpoints para acceder a los informes del espacio de propuestas:
      ejecuciones de propuestas con alcance de organización, con competidores,
      consultas, atributos y métricas agregadas.
  - name: Knowledge Base
    description: >-
      Endpoints para leer la base de conocimientos de la marca: datos aprobados
      sobre la marca y los pilares que los organizan.
paths:
  /api/v1/organizations/members/{user_id}:
    parameters:
      - name: user_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: Identificador único del usuario de destino
    delete:
      tags:
        - Team Management
      summary: Eliminar miembro de la organización
      description: >-
        Elimina un usuario de tu organización. En una única transacción, también
        limpia sus filas huérfanas de website_members en todos los sitios de la
        organización. Requiere una clave global. No permite eliminar al usuario
        propietario de la clave, al propietario de la organización ni al último
        administrador.
      operationId: removeOrgMember
      responses:
        '200':
          description: Miembro eliminado correctamente
          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: >-
                      Número de filas de website_members huérfanas eliminadas
                      como parte de la cascada.
                    example: 0
                required:
                  - success
                  - message
                  - websites_affected
        '400':
          description: 'Solicitud incorrecta: formato de ID de usuario no válido'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: 'Sin autorización: falta la clave de API o no es válida'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: >-
            Acceso denegado: la clave no es global, se intenta modificar a uno
            mismo o al propietario
          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: 'No encontrado: el miembro de la organización no existe'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Organization member not found
        '409':
          description: 'Conflicto: no se puede eliminar al último administrador'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Cannot remove the last admin from the organization
        '500':
          description: Error interno del servidor
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - apiKey: []
components:
  schemas:
    Error:
      type: object
      description: Objeto de respuesta de error
      required:
        - error
      properties:
        error:
          type: string
          description: Mensaje de error que describe qué ha fallado
          example: Unauthorized
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Clave de API para autenticarse. Puedes crear una
        [aquí](https://app.athenahq.ai/organization?tab=api).

````

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