Delete Site

del https://app.mk.io/api/v1/projects/:project_name/infra/sites/:name

Delete a site. If the site does not exist, this API will return a 204. To learn more about sites, read Site Concept.

RBAC Capability Required: infra.site.delete

Authentication

Authorization Bearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

• project_name string Required
• name string Required

Response

• 200 Site deleted.

No response body.

• 204 Nothing to delete.

No response body.

Errors

• 400 Bad Request
  error object ErrorDetail Required
  Pertinent information about the error

  • code string Required
    The error code.
  • detail string Required
    The error message.
  • extraDetail map from strings to any Optional
    Extra information regarding this error.
  • ref string Required
    A reference to the request that caused the error.
  • status integer Required
    The HTTP status code

• 401 Unauthorized
  error object ErrorDetail Required Pertinent information about the error

  • code string Required
    The error code.
  • detail string Required
    The error message.
  • extraDetail map from strings to any Optional
    Extra information regarding this error.
  • [any key] any
  • ref string Required
    A reference to the request that caused the error.
  • status integer Required
    The HTTP status code

• 403 Forbidden
  error object ErrorDetail Required
  Pertinent information about the error

  • code string Required
    The error code.
  • detail string Required
    The error message.
  • extraDetail map from strings to any Optional
    Extra information regarding this error.
  • ref string Required
    A reference to the request that caused the error.
  • status integer Required
    The HTTP status code

• 404 Not Found
  error object ErrorDetail Required
  Pertinent information about the error

  • code string Required
    The error code.
  • detail string Required
    The error message.
  • extraDetail map from strings to any Optional
    Extra information regarding this error.
  • ref string Required
    A reference to the request that caused the error.
  • status integer Required
    The HTTP status code

• 409 Site is referenced by existing flows or devices.
  error object ErrorDetail Required Pertinent information about the error

  • code string Required
    The error code.
  • detail string Required
    The error message.
  • extraDetail map from strings to any Optional
    Extra information regarding this error.
  • ref string Required
    A reference to the request that caused the error.
  • status integer Required
    The HTTP status code

• 429 Too Many Requests
  error object ErrorDetail Required
  Pertinent information about the error

  • code string Required
    The error code.
  • detail string Required
    The error message.
  • extraDetail map from strings to any Optional
    Extra information regarding this error.
  • ref string Required
    A reference to the request that caused the error.
  • status integer Required
    The HTTP status code

• 500 Internal Server Error
  error object ErrorDetail Required
  Pertinent information about the error

  • code string Required
    The error code.
  • detail string Required
    The error message.
  • extraDetail map from strings to any Optional
    Extra information regarding this error.
  • ref string Required
    A reference to the request that caused the error.
  • status integer Required
    The HTTP status code