Skip to main content
POST
Error

Authorizations

Authorization
string
header
required

API token obtained from the Tokens endpoint or CLI device login. Include as Authorization: Bearer <token>. Requests made with a managed CLI session also include X-Strix-Workspace: <organization_id> to pin a process to the workspace it started in; recovery endpoints report the current workspace after a concurrent switch.

Path Parameters

domainId
string<uuid>
required

UUID of the domain. Use the id field of a domain from listDomains.

Response

Verification result. A 200 status does not mean success. When verified is false, status is pending and next_steps lists the records to add.

Result of a verification attempt. A 200 status does not mean success. Read verified or status.

domain
object
required
verified
boolean
required

True only when Strix confirmed ownership of the domain.

status
enum<string>
required

pending means no verification record was found yet. Add a record, then call this endpoint again.

Available options:
verified,
pending
detail
string
required

Human-readable result and the next action.

verification_method
enum<string>

The method that confirmed ownership. Present only when verified is true.

Available options:
allowlist,
existing,
dns,
file,
meta_tag,
email
next_steps
string[]

One instruction per verification method, plus the retry command. Present only when status is pending.

verification
object

The DNS, file, and meta tag records for this domain. Present only when status is pending.