---
updatedAt: 2026-05-11T14:55:41.000Z
agentTools:
  projectIndex: https://api.authaction.com/llms.txt
---

# Delete organization by id

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "paths": {
    "/api/v1/organizations/{orgId}": {
      "delete": {
        "operationId": "OrganizationsController_deleteOne",
        "summary": "Delete organization by id",
        "parameters": [
          {
            "name": "orgId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "The organization has been successfully deleted."
          },
          "400": {
            "description": "Invalid organization id"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "User not member of tenant"
          }
        },
        "tags": [
          "Organizations"
        ],
        "security": [
          {
            "bearer": []
          }
        ]
      }
    }
  },
  "info": {
    "title": "AuthAction",
    "description": "authentication and authorization",
    "version": "1.0",
    "contact": {}
  },
  "tags": [
    {
      "name": "Organizations",
      "description": "Organization related endpoints"
    }
  ],
  "servers": [
    {
      "url": "https://{tenant}.{region}.authaction.com",
      "description": "Dynamic server based on tenant",
      "variables": {
        "tenant": {
          "default": "your-tenant-name",
          "description": "The tenant identifier"
        },
        "region": {
          "default": "eu",
          "description": "The tenant region (au|ca|cn|eu|in|jp|us)"
        }
      }
    }
  ],
  "components": {
    "securitySchemes": {
      "bearer": {
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "type": "http",
        "description": "Obtain a Bearer token by passing M2M client app credential through the /oauth2/m2m/token endpoint"
      }
    }
  }
}
```