Skip to main content
DELETE
Cancel a still-pending verification wait

Authorizations

Authorization
string
header
required

Dairo API key, e.g. dairo_test_... or dairo_live_...

Path Parameters

inbox
string
required

Inbox UUID or full address (e.g. agent@dairo.app).

waitId
string<uuid>
required

Verification wait id returned by the register call.

Response

Success

A durable await_verification wait. status is pending until it resolves (a code was extracted from an inbound message) or expires (deadline passed / canceled). Resolution outputs (code, from, messageId, resolvedAt) are present only once resolved.

waitId
string<uuid>
required
inboxId
string<uuid>
required
status
enum<string>
required
Available options:
pending,
resolved,
expired
expiresAt
string<date-time>
required
createdAt
string<date-time>
required
agentId
string<uuid> | null

The Agent Passport that registered this wait, when the API key was agent-bound.

fromHint
string | null
instruction
string | null

The natural-language matcher instruction this wait was registered with.

result
string | null

The value the AI matcher extracted per the instruction (present once resolved) — a code, a link, or a quoted line.

code
string | null

Legacy alias of result, kept for OTP callers (present once resolved).

from
string | null

The From address of the message that resolved the wait.

messageId
string<uuid> | null

The inbound message that resolved the wait.

idempotencyKey
string | null
resolvedAt
string<date-time> | null
expiredAt
string<date-time> | null