Broadcasts

• A broadcast can be used to notify specific Account Users and Teams.

The Broadcast Object

Property	Type	Description
title	string	The title of the broadcast.
description	string	The description of the broadcast.
tag_list	string[]	A list of tags.
destination_team_ids	string[]	An array of Team IDs this broadcast should be sent to.
destination_account_user_ids	string[]	An array of Account User IDs this broadcast should be sent to.
status	string	The current status state of the broadcast. queued|open|closed|errored
response_requested	boolean	If a response was requested from the destinations.
response_requested_by	timestamp	The deadline of when the destinations have to respond by.
broadcast_response_options	BroadcastResponseOption[]	:id, :value, :position, :broadcast_responses_count
broadcast_responses	BroadcastResponses[]	:id, :prefix_id, :account_user_id, :broadcast_response_option_id, :channel, :created_at

Create a Broadcast

POST https://api.pagertree.com/api/v4/broadcasts

Allowed Parameters

def broadcast_params
  params.permit(
    :title,
    :description,
    :tag_list,
    :response_requested,
    :response_requested_by,
    destination_team_ids: [],
    destination_account_user_ids: [],
    broadcast_response_options_attributes: [
      :value
    ]
  )
end

Required Parameters

• title

• at least 1 destination (Team or Account User)

• if response requested, at least 1 response option

Retrieve a Broadcast

GET https://api.pagertree.com/api/v4/broadcasts/:id

Update a Broadcast

PUT https://api.pagertree.com/api/v4/broadcasts/:id

Delete a Broadcast

DELETE https://api.pagertree.com/api/v4/broadcasts/:id

List all Broadcasts

GET https://api.pagertree.com/api/v4/broadcasts

Comment on a Broadcast

POST https://api.pagertree.com/api/v4/broadcasts/:id/comments

Required Parameters

• body

List a Broadcast's Comments

GET https://api.pagertree.com/api/v4/broadcasts/:id/comments