Delete Org

curl --request DELETE \
  --url https://api.example.com/api/organizations/{org_id} \
  --header 'X-Access-Token: <api-key>'

const options = {method: 'DELETE', headers: {'X-Access-Token': '<api-key>'}};

fetch('https://api.example.com/api/organizations/{org_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/organizations/{org_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "X-Access-Token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/organizations/{org_id}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("X-Access-Token", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/organizations/{org_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["X-Access-Token"] = '<api-key>'

response = http.request(request)
puts response.read_body

{}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Orgs

Delete Org

Delete an organization.

This endpoint permanently deletes an organization and all associated data including organization members, conversations, billing data, and external LiteLLM team resources. Access requires the DELETE_ORGANIZATION permission, which is granted only to owners.

Args: org_id: Organization ID to delete (UUID) user_id: Authenticated user ID (injected by require_permission dependency)

Returns: dict: Confirmation message with deleted organization details

Raises: HTTPException: 401 if user is not authenticated HTTPException: 403 if user lacks DELETE_ORGANIZATION permission HTTPException: 404 if organization not found HTTPException: 500 if deletion fails

DELETE

api

organizations

{org_id}

Delete Org

curl --request DELETE \
  --url https://api.example.com/api/organizations/{org_id} \
  --header 'X-Access-Token: <api-key>'

const options = {method: 'DELETE', headers: {'X-Access-Token': '<api-key>'}};

fetch('https://api.example.com/api/organizations/{org_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/organizations/{org_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "X-Access-Token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/organizations/{org_id}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("X-Access-Token", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/organizations/{org_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["X-Access-Token"] = '<api-key>'

response = http.request(request)
puts response.read_body

{}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

X-Access-Token

string

header

required

Headers

X-Org-Id

string | null

Path Parameters

org_id

string<uuid> | null

required

Response

Successful Response

The response is of type Response Delete Org Api Organizations Org Id Delete · object.

OpenHands Cloud

Settings

Integrations

Cloud API

Organizations

Delete Org

Authorizations

Headers

Path Parameters

Response