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

# Revoke Organization Invite

> Soft-revokes a **pending** organization invite by setting its status to `revoked`. The invite row is preserved for audit purposes. Returns 409 if the invite is in any other state (already accepted, declined, expired, or revoked), since revoking an accepted invite would leave a misleading audit trail while the underlying membership row remains untouched. To remove an already-accepted member, use `DELETE /api/v1/organizations/members/{user_id}` instead. Requires a global API key.



## OpenAPI

````yaml /api-reference/openapi.json delete /api/v1/invites/org/{invite_id}
openapi: 3.1.0
info:
  title: AthenaHQ API
  description: >-
    AthenaHQ API provides programmatic access to manage your websites and
    prompts for AI-powered content optimization.
  version: 1.0.0
  contact:
    email: support@athenahq.ai
servers:
  - url: https://api.athenahq.ai
    description: Production server
security:
  - apiKey: []
tags:
  - name: Basics
    description: Core API operations for managing websites and prompts
  - name: Metrics
    description: Metrics and analytics endpoints for tracking AI visibility
  - name: Billing
    description: Billing and credits endpoints for managing usage
  - name: Team Management
    description: Endpoints for managing team members and invitations
  - name: Groups
    description: Endpoints for managing groups of websites
  - name: Content
    description: >-
      Endpoints for accessing Content Hub data — tabs, tracked URLs, and per-URL
      prompt breakdowns.
  - name: Pitch Workspace
    description: >-
      Endpoints for accessing pitch workspace reports — org-scoped pitch runs
      with competitors, prompts, attributes, and aggregate metrics.
paths:
  /api/v1/invites/org/{invite_id}:
    parameters:
      - name: invite_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: The unique identifier of the organization invite
    delete:
      tags:
        - Team Management
      summary: Revoke Organization Invite
      description: >-
        Soft-revokes a **pending** organization invite by setting its status to
        `revoked`. The invite row is preserved for audit purposes. Returns 409
        if the invite is in any other state (already accepted, declined,
        expired, or revoked), since revoking an accepted invite would leave a
        misleading audit trail while the underlying membership row remains
        untouched. To remove an already-accepted member, use `DELETE
        /api/v1/organizations/members/{user_id}` instead. Requires a global API
        key.
      operationId: revokeOrgInvite
      responses:
        '200':
          description: Invite revoked successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Invite revoked
                  invite_id:
                    type: string
                    format: uuid
                required:
                  - success
                  - message
                  - invite_id
        '400':
          description: Bad request - Invalid invite ID format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Invalid invite ID format
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Forbidden - Global API key required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: 'Forbidden: global API key required'
        '404':
          description: >-
            Not found - Invite does not exist or does not belong to your
            organization
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Invite not found
        '409':
          description: Conflict - Invite is not in pending state
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: 'Invite is not pending (current status: accepted)'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - apiKey: []
components:
  schemas:
    Error:
      type: object
      description: Error response object
      required:
        - error
      properties:
        error:
          type: string
          description: Error message describing what went wrong
          example: Unauthorized
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key for authentication. You can create one
        [here](https://app.athenahq.ai/organization?tab=api).

````