Delete a domain (republishes edge config)

DELETE

/api/v1/domains/{id}

const url = 'https://app.routeseam.com/api/v1/domains/1';
const options = {method: 'DELETE', headers: {'X-Api-Key': '<X-Api-Key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url https://app.routeseam.com/api/v1/domains/1 \
  --header 'X-Api-Key: <X-Api-Key>'

Authorizations

ApiKeyAuth

Parameters

Path Parameters

required

integer

Responses

204

No content

401

Missing or invalid API key

application/json

The ONLY error envelope — produced by Api::V1::BaseController#render_error_response

object

error

required

string

errors

Array<string>

validation_errors

object

key

additional properties

Array<string>

Example

{
  "error": "Invalid API key",
  "errors": [],
  "validation_errors": {}
}

404

Not found (cross-tenant ids are indistinguishable from missing ones)

application/json

The ONLY error envelope — produced by Api::V1::BaseController#render_error_response

object

error

required

string

errors

Array<string>

validation_errors

object

key

additional properties

Array<string>

Example

{
  "error": "Not found",
  "errors": [],
  "validation_errors": {}
}

429

Over 300 requests/minute for this key

application/json

The ONLY error envelope — produced by Api::V1::BaseController#render_error_response

object

error

required

string

errors

Array<string>

validation_errors

object

key

additional properties

Array<string>

Example

{
  "error": "Rate limit exceeded",
  "errors": [],
  "validation_errors": {}
}