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

# Delete Organization Member

> Offboard a member from your organization. The member is removed from the organization in the identity provider so they can no longer access it, all API keys they created in the organization are invalidated, and they are removed from all of the organization's groups. The member keeps their account and any other organization memberships; if they sign in with no memberships left, a fresh default organization is created for them. Requires an API key with write manage permissions. The endpoint is idempotent: calling it for a user who is not (or no longer) a member returns 200, so it is safe to retry after a partial failure.

Offboard a member from your organization. When this endpoint is called:

* The member is removed from your organization in the identity provider, so they can no longer access it.
* All API keys created by the member in your organization are invalidated.
* The member is removed from all of your organization's groups.

Use the [List Organization Members](/api-reference/endpoint/manage-org-member-list) endpoint to look up the `user_id` for the member you want to offboard.

<Warning>
  Offboarding cannot be undone. All requests using API keys the member created in your organization will fail shortly after the call returns.
</Warning>

<Note>
  The member keeps their account and any memberships in other organizations. If they sign in with no memberships left, a fresh default organization is created for them.
</Note>

This endpoint is idempotent: calling it again for an already-offboarded member returns `200`, so it is safe to retry until it succeeds — for example after a `502` from the identity provider.


## OpenAPI

````yaml DELETE /v1/manage/org/member/{user_id}
openapi: 3.0.3
info:
  title: Requesty Management API
  description: >-
    Requesty Management API for API key management, groups, members, and
    organization settings.
  version: 1.0.0
servers:
  - url: https://api-v2.requesty.ai
    description: Management API endpoint
security:
  - BearerAuth: []
paths:
  /v1/manage/org/member/{user_id}:
    delete:
      summary: Delete organization member
      description: >-
        Offboard a member from your organization. The member is removed from the
        organization in the identity provider so they can no longer access it,
        all API keys they created in the organization are invalidated, and they
        are removed from all of the organization's groups. The member keeps
        their account and any other organization memberships; if they sign in
        with no memberships left, a fresh default organization is created for
        them. Requires an API key with write manage permissions. The endpoint is
        idempotent: calling it for a user who is not (or no longer) a member
        returns 200, so it is safe to retry after a partial failure.
      operationId: deleteOrgMember
      parameters:
        - name: user_id
          in: path
          required: true
          schema:
            type: string
          description: >-
            The user ID of the member, as returned by the list organization
            members endpoint
          example: user_2abCdEfGhIjKlMnOpQrStUvWxYz
      responses:
        '200':
          description: >-
            Member offboarded successfully (also returned when the user is not a
            member, making retries safe)
        '400':
          description: Bad request - missing or invalid user ID.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - missing or invalid Authorization header.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden - API key does not have write manage permissions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '502':
          description: >-
            Bad gateway - the identity provider could not remove the user from
            the organization. The user's API keys and data in your organization
            have already been invalidated; retry the request to complete the
            removal.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - origin
            - message
          properties:
            origin:
              type: string
              enum:
                - router
                - provider
              description: >-
                Whether the error originated from Requesty's router or an
                upstream provider.
            message:
              type: string
              description: Human-readable error description.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: API key for authentication

````