Moab logoMoab
Get started
Moab Docs

Tracking Domains

Tracking hosts for outbound links — pending until the dash-links worker answers on the host, verified after, retired instead of deleted.

Base path /api/v1/link-domains on https://moabcrm.com. Authenticate with Authorization: Bearer $DASH_API_KEY and name the project with the Project-ID header. Writes are validated in strict mode; an operation this resource does not declare answers 405 operation_not_supported.

List tracking domains

GET /api/v1/link-domains

curl "https://moabcrm.com/api/v1/link-domains?status=pending" \
  -H "Authorization: Bearer $DASH_API_KEY" \
  -H "Project-ID: pr_zest"
Show me the tracking domains filtered by status
data_query {
  "collection": "link_domains",
  "where": {
    "status": "pending"
  }
}

Returns a paginated list of link-domain objects, newest first.

{
  "object": "list",
  "data": [
    {
      "object": "link-domain",
      "id": "obj_123",
      "status": "pending",
      "created_at": "2026-07-25T12:00:00.000Z",
      "updated_at": "2026-07-25T12:00:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Parameters

ParameterTypeKindDescription
statusstringfilterpending → verified | retired. Verification is a positive probe (the dash-links worker answering on this host), never inferred. A pending row older than 72h renders the named domain_verify_timeout — never a silent pending. One of pending, verified, retired.
sortstringsortOne of verified_at; prefix with - to reverse.
limitnumberpageRows to return, 1–100. Defaults to 20.
cursorstringpagenext_cursor from the previous page.

GET /api/v1/link-domains/draft-001

curl "https://moabcrm.com/api/v1/link-domains/draft-001" \
  -H "Authorization: Bearer $DASH_API_KEY" \
  -H "Project-ID: pr_zest"
Open the link-domain {id}
data_get {
  "collection": "link_domains",
  "object_id": "draft-001"
}

Returns the link-domain object.

{
  "object": "link-domain",
  "id": "obj_123",
  "status": "pending",
  "created_at": "2026-07-25T12:00:00.000Z",
  "updated_at": "2026-07-25T12:00:00.000Z"
}

Parameters

ParameterTypeKindDescription
idstringpathThe link-domain's id or slug.

POST /api/v1/link-domains/{id}/events

curl -X POST "https://moabcrm.com/api/v1/link-domains/draft-001/events" \
  -H "Authorization: Bearer $DASH_API_KEY" \
  -H "Project-ID: pr_zest" \
  -H "Content-Type: application/json" \
  -d '{"event":"Noted by the operator","context":{"source":"api"}}'
Add a note to the link-domain {id}
data_event {
  "collection": "link_domains",
  "object_id": "draft-001",
  "event": "Noted by the operator"
}

Returns the appended event object.

{
  "object": "event",
  "id": "evt_123",
  "event": "Noted by the operator"
}

Parameters

FieldTypeRequiredDescription
eventstringyesThe human-readable timeline entry.
contextobjectnoProvenance — source, integration, worker_run_id, …

What comes back (read-only)

Every link-domain carries the envelope below. The fields under it are computed or stamped by the platform — they are returned, never sent.

FieldTypeDescription
objectstringAlways link-domain.
idstringStable object id. Also accepted in place of slug on any path.
slugstringURL-safe name, unique within the collection.
created_atstringISO-8601 timestamp of the first write.
updated_atstringISO-8601 timestamp of the most recent write. The cursor sorts on this.
first_checked_atdateWhen verification polling started — the 72h timeout clock.
last_checked_atdateThe most recent verification probe.
verified_atdateWhen the host first answered as the dash-links worker.
verify_errorstringThe named failure from the last probe (e.g. domain_verify_timeout, dns_not_resolving, wrong_service) — absent when pending-and-fresh or verified.

Errors

Failures use { error: { type, code, message, param } }. The full code table is generated at Error Codes.

On this page

Moab logoMoab

Ready to build? Connect an agent and go — no credit card needed to start.

Get startedSee our plans