Quick Reference

Fresh

Common Concepts

Authentication

SignalWire APIs use Basic Authentication with your Project ID and API Token, or Bearer Authentication with JWT tokens.

Base URLs

All REST API calls use your Space URL format:

• your-space.signalwire.com

Phone Number Format

All phone numbers use E.164 format: +1NXXNXXXXXX

SWML Quick Reference

Basic Call Handler

version: 1.0.0
sections:
  main:
    - answer: {}
    - play:
        url: 'say:Hello from SignalWire!'
    - hangup: {}

AI Agent Handler

version: 1.0.0
sections:
  main:
    - ai:
        prompt:
          text: "You are a helpful assistant."
        post_prompt:
          text: "Summarize the conversation."

Compatibility API Quick Reference

cXML Verb Summary

Verb	Purpose
<Say>	Text-to-speech
<Play>	Play audio file
<Gather>	Collect DTMF input
<Dial>	Connect to another party
<Record>	Record audio
<Redirect>	Redirect call flow
<Hangup>	End the call

Common Error Codes

Code	Meaning
400	Bad Request — check your parameters
401	Unauthorized — verify credentials
404	Not Found — check the resource ID
429	Rate Limited — back off and retry
500	Server Error — contact support