Skip to content
Updawg

`DELETE /v1/orgs/{org}`: delete the organization (DAWG-170).

DELETE
/v1/orgs/{org}
curl --request DELETE \
  --url https://api.updawg.net/v1/orgs/example \
  --header 'Content-Type: application/json' \
  --data '{ "confirm": "example" }'

Gone for everybody at once: its members lose it, its API, enrollment and SCIM tokens stop working and its hosts’ check-ins are refused. Everything that was its own is purged a week later by the nightly maintenance run. The owner’s alone, in person, never with an API token; refused while Stripe is still billing it.

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
org
required
string

Organization slug.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
confirm
required

The organization’s slug, exactly as it is now: a thing typed on purpose rather than a click somebody could make by accident.

string

Example generated

{
  "confirm": "example"
}

Responses

Section titled “Responses”

204

Section titled “204”

Deleted. Its data is purged in seven days.

400

Section titled “400”

confirm is not this organization’s slug.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string

Example generated

{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

401

Section titled “401”

No session.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string

Example generated

{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

403

Section titled “403”

Not the owner, or an API token: only an owner, signed in, can.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string

Example generated

{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

404

Section titled “404”

No such organization, or not yours — one answer for both.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string

Example generated

{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

409

Section titled “409”

subscription-active: a paid subscription is still being billed. Cancel it in billing first.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string

Example generated

{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

421

Section titled “421”

The organization’s data is in another region (wrong-region, DAWG-159). detail names that region’s API; send the request there.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string

Example generated

{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

429

Section titled “429”

Over the organization’s request limit. Retry-After says when to try again; RateLimit-Limit is the burst.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string

Example generated

{
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}