Skip to main content

Create a phone-control action

POST 
/api/v1/domains/:domain_uuid/phone-control/actions

Controls a registered phone or its active call through the same service used by php artisan phone:control. Vendor support differs, so first use the targets endpoint and choose an action from that phone's supported_actions. Prefer agent when selecting a specific phone. See Supported phones and actions for vendor-specific capabilities and behavior.

Call-state safeguards are enabled by default. Hold, resume, end-call, transfer, and answer-call normally require one unambiguous call in the expected state. force=true bypasses those checks. dry_run=true resolves the target and returns a command preview without sending it.

Access rules:

  • Caller must have access to the target domain.
  • Caller must have the phone_control_call permission.

Request​

Responses​

Dry run