Inbound

Release a held message — by the agent-safety verdict or by an inbound policy (a human decides)

Dispatches now, to the mailbox channels (respecting a restrict_channels the policy recorded — if it would leave a recipient without channels it is dropped, with the tag would_restrict_channels:<name>), a message that was held at arrival — with the verdict and message.quarantine (heldAt, releasedAt, releasedBy) in the payload. Scope write:inbound: release is an operator gesture, never a tool of the model (the key that replies does not release). Records who released (api:<key prefix>). Without a body it releases EVERY held copy; { "recipient": "<mailbox>" } releases only the copy of that mailbox (each recipient is held by its own mailbox choices and policies).

post/inbound/{uid}/release

Request

  • Base URL: https://api.oveyon.com/v1
  • URL: https://api.oveyon.com/v1/inbound/{uid}/release
  • Auth: HTTP bearer

Path parameters

uidstring required

Request body

recipientstring

Release only the copy of this mailbox (one of recipients[].to).

Response

Released

idstring uuid
status'released'
deliveriesinteger

How many channel deliveries were queued now. 0 with noChannel=true means the mailbox has no active channel — the message stays readable in the panel and the API.

noChannelboolean
releasedAtstring date-time
releasedBystring
recipientsstring[]

The mailboxes whose copies this call released.

stillHeldinteger

Copies of the message still held after this call (releasing one recipient of several).

Changes

No recorded changes to this operation across all 1 revision of this API.