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

# Remove a member

> Take someone off the team and out of every workspace it owns. Admin keys only.

Removes someone from the team and from every workspace it owns. Admin keys only. The founder, the last admin, and the key's own person cannot be removed.


## OpenAPI

````yaml DELETE /v2/members/{id}
openapi: 3.1.0
info:
  title: OpenNous REST API
  version: 2.0.0
  description: >-
    Read and write the OpenNous revenue context graph over HTTP. Authenticate
    with a workspace API key.
servers:
  - url: https://api.opennous.cloud
    description: OpenNous Cloud
security:
  - bearerAuth: []
  - apiKeyHeader: []
tags:
  - name: People
  - name: Accounts
  - name: Deals
  - name: Notes
  - name: Attention
  - name: Insights
  - name: Enrich & score
  - name: Organization
  - name: Workflows
  - name: Webhooks
    description: >-
      Subscribe to events and have them pushed to your own stack, with the
      account record attached.
  - name: Usage
paths:
  /v2/members/{id}:
    delete:
      tags:
        - Organization
      summary: Remove a member
      description: >-
        Take someone off the team and out of every workspace it owns. Admin keys
        only.
      operationId: removeMember
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: The member's `user_id`.
      responses:
        '200':
          description: Removed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  removed:
                    type: boolean
                  user_id:
                    type: string
              example:
                removed: true
                user_id: u2
        '400':
          description: This member cannot be removed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                cannot_remove_founder:
                  summary: cannot_remove_founder
                  value:
                    error: cannot_remove_founder
                cannot_remove_self:
                  summary: cannot_remove_self
                  value:
                    error: cannot_remove_self
                cannot_remove_last_admin:
                  summary: cannot_remove_last_admin
                  value:
                    error: cannot_remove_last_admin
        '401':
          $ref: '#/components/responses/Unauthorized'
        '402':
          $ref: '#/components/responses/UpgradeRequired'
        '403':
          description: Not allowed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                admin_key_required:
                  summary: admin_key_required
                  value:
                    error: admin_key_required
                insufficient_permissions:
                  summary: insufficient_permissions
                  value:
                    error: insufficient_permissions
                read_only_key:
                  summary: read_only_key
                  value:
                    error: read_only_key
        '404':
          description: No such member on the team.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: member_not_found
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    Error:
      type: object
      description: >-
        Every error response. `error` is a stable machine code. Some errors add
        fields such as `detail`, `supported`, `max`, or `reason`.
      required:
        - error
      properties:
        error:
          type: string
          description: Machine-readable error code.
        detail:
          type: string
          description: Human-readable explanation, when there is one.
      additionalProperties: true
  responses:
    Unauthorized:
      description: Missing, unknown, or expired API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            missing:
              summary: api_key_required
              value:
                error: api_key_required
            invalid:
              summary: invalid_api_key
              value:
                error: invalid_api_key
            expired:
              summary: api_key_expired
              value:
                error: api_key_expired
                detail: >-
                  This API key has expired. Create or rotate a key to get a
                  fresh one.
    UpgradeRequired:
      description: The workspace is past its monthly operations limit and grace window.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: upgrade_required
            reason: ops_limit_reached
            current_plan: starter
            upgrade_url: /settings?section=billing
    RateLimited:
      description: More than 600 requests in a minute on this key.
      headers:
        RateLimit-Limit:
          schema:
            type: integer
          description: Requests allowed per window.
        RateLimit-Remaining:
          schema:
            type: integer
          description: Requests left in the window.
        RateLimit-Reset:
          schema:
            type: integer
          description: Seconds until the window resets.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: rate_limited
    InternalError:
      description: Unexpected server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: internal_error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Workspace API key. Create one in **Settings → API keys**.
    apiKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
      description: The same key, sent as a header.

````

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