VEverdun
telephony

Call Owner

Call the site's property contact. SAME PERMISSION AS TEXTING THEM (owner decision, 2026-09-10): an account manager who may notify the owner may reach them by phone as well as by text.

ONE EXCEPTION, channel='phone_bridge', which ALSO requires escalate_dispatch: the bridge's first leg is the caller-supplied operator_number, so it can ring any number at all, and there is no verified operator callback number on file to constrain it. Notify-only operators get a 403 there and use channel='browser_call', whose operator leg is the softphone client itself.

The row this writes is a dispatch_call with target_type='owner' — it reuses the dispatch transport but is NOT dispatch: it never appears in GET /events/{id}/dispatch-calls, and it surfaces on the event's communications timeline instead.

post/events/{event_id}/call-owner

Request

  • Base URL
    https://api.verdun.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.verdun.ai/events/{event_id}/call-owner
  • Auth
    HTTP bearer

Path parameters

event_idstring required

Request body

contact_idstring required

Site contact to call; must belong to the event's site

number'primary' | 'afterhours'

Which of the contact's phone numbers on file to call

channel'phone_bridge' | 'browser_call'

How the operator's leg is placed: a PSTN callback bridge or the browser softphone.

operator_numberstring nullable

The operator's callback number; the bridge rings this leg first, then dials the contact when answered. phone_bridge only — browser_call has no callback leg.

idempotency_keystring nullable

Client-generated key for this call intent. Retries and double-submits with the same key return the original attempt instead of placing a second call. A key already used for a DIFFERENT action on this event is a 409, never a returned row of the other kind.

Example request

{
  "contact_id": "2dd7154e-21dc-408f-ac25-b2918d591e29",
  "channel": "browser_call",
  "operator_number": "(847) 555-0142",
  "idempotency_key": "9c9be1a2-4a6e-4a71-b8a0-2f6d1f6f2f5e"
}

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 2 revisions of this API.