markdropDocs
Open Markdrop
POST/api/v1/workspaces/{workspace_id}/domains/{domain_id}/detach

Take a domain offline

Stops serving a domain without losing its verification, so you can turn it back on later.

API token required30 per minute per IP
Code samples and Try it

Path parameters

#
  • workspace_idstringRequired

    The workspace's id, from the address of its settings page (markdrop.in/settings/workspaces/<workspace-id>) or from List workspaces.

  • domain_idstringRequired

    The domain's id, from List domains.

Responses

#
  • 200OK.
  • 401No token, or the token is revoked or mistyped.
  • 422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).
  • 429Too many requests from your IP address. Wait the seconds in Retry-After.
200 response: 26 fields (DomainResponse)
  • idstring
  • hoststring
  • kind"app" | "cdn"
  • status"pending" | "verified" | "failed" | "lapsed"
  • created_atstring (date-time)

    ISO 8601, for example 2026-11-30T12:00:00Z.

  • verified_atstring (date-time) | null

    ISO 8601, for example 2026-11-30T12:00:00Z.

  • last_checked_atstring (date-time) | null

    ISO 8601, for example 2026-11-30T12:00:00Z.

  • last_errorstring | null
  • attachedboolean

    Default false.

  • is_primaryboolean

    Default false.

  • dns_record_namestring | null
  • dns_record_typestring | null

    Default "TXT".

  • dns_record_valuestring | null
  • dns_target_namestring | null
  • dns_target_typestring | null
  • dns_target_valuestring | null
  • warningstring | null
  • liveboolean

    Default false.

  • routing_okboolean | null
  • txt_okboolean | null
  • failuresinteger

    Default 0.

  • first_failed_atstring (date-time) | null

    ISO 8601, for example 2026-11-30T12:00:00Z.

  • lapsed_atstring (date-time) | null

    ISO 8601, for example 2026-11-30T12:00:00Z.

  • expires_atstring (date-time) | null

    ISO 8601, for example 2026-11-30T12:00:00Z.

  • apex_certainboolean | null

    Default true.

  • dns_routing_optionsarray of object
    3 fields inside
    • typestring
    • namestring
    • valuestring
Did this page help?