Events¶
Method | Path (Parameters are case-sensitive) | Return Model | Summary |
---|---|---|---|
GET | /events | Message | WebSocket connection for events. |
POST | /events/user/{eventName} | void | Generate a user event. |
eventWebsocket¶
GET /events¶
WebSocket connection for events.
Query parameters¶
- app: string - (required) Applications to subscribe to.
- Allows comma separated values.
- subscribeAll: boolean - Subscribe to all Asterisk events. If provided, the applications listed will be subscribed to all events, effectively disabling the application specific subscriptions. Default is 'false'.
userEvent¶
POST /events/user/{eventName}¶
Generate a user event.
Path parameters¶
Parameters are case-sensitive. * eventName: string - Event name
Query parameters¶
- application: string - (required) The name of the application that will receive this event
- source: string - URI for event source (channel:{channelId}, bridge:{bridgeId}, endpoint:{tech}/{resource}, deviceState:{deviceName}
- Allows comma separated values.
Body parameter¶
- variables: containers - The "variables" key in the body object holds custom key/value pairs to add to the user event. Ex. { "variables": { "key": "value" } }
Error Responses¶
- 404 - Application does not exist.
- 422 - Event source not found.
- 400 - Invalid even tsource URI or userevent data.