POST/api/v1/workspaces/{workspace_id}/domains/{domain_id}/attach

Turn on a domain

Starts serving a verified domain, with HTTPS.

API token required20 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.
501Domains can't be turned on automatically here. Finish the step by hand.

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

const res = await fetch("https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/domains/DOMAIN_ID/attach", { method: "POST", headers: { Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`, }, }); const data = await res.json();

import os import requests r = requests.post( "https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/domains/DOMAIN_ID/attach", headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"}, ) r.raise_for_status() print(r.json())