ExTwilio.Call
Represents an Call resource in the Twilio API.
Summary↑
| all(options \\ []) | Retrieve all of the Call records from the Twilio API, paging through all the API response pages |
| cancel(sid) | |
| children() | |
| complete(sid) | |
| create(data, options \\ []) | Create a new Call in the Twilio API. Any field supported by Twilio's Call API can be passed in the 'data' keyword list |
| destroy(sid, options \\ []) | Delete any Call from your Twilio account, using its SID |
| find(sid, options \\ []) | Find any Call by its Twilio SID |
| first_page(metadata) | Get the first page of calls, using metadata from any page's response |
| last_page(metadata) | Get the last page of calls, using metadta from any page's response |
| list(options \\ []) | Retrieve a list of Calls from the API |
| new() | Creates a new ExTwilio.Call struct. Optionally, you can pass in attributes to set their initial value in the struct |
| new(attrs) | |
| next_page(metadata) | Get the next page of calls, using the metadata from the previous response. See |
| parents() | |
| previous_page(metadata) | Get the previous page of calls, using metadata from a previous response |
| resource_collection_name() | Underscored and lowercased collection name for a given resource. Delegates the real work to |
| resource_name() | CamelCase resource name as it would be used in Twilio's API. Delegates the real work to |
| stream(options \\ []) | Create a stream of all Call records from the Twilio API |
| update(sid, data, options \\ []) | Update an Call in the Twilio API. You can pass it a binary SID as the identifier, or a whole %ExTwilio.Call{} struct |
Functions
Specs:
- all(list) :: [%{}]
Retrieve all of the Call records from the Twilio API, paging through all the API response pages.
Delegates to ExTwilio.Api.all/2.
Examples
calls = ExTwilio.Call.allSpecs:
- children :: list
Specs:
- create(list, list) :: ExTwilio.Parser.parsed_response
Create a new Call in the Twilio API. Any field supported by Twilio's Call API can be passed in the 'data' keyword list.
Delegates to ExTwilio.Api.create/3.
Specs:
- destroy(String.t, list) :: ExTwilio.Parser.success_delete | ExTwilio.Parser.error
Delete any Call from your Twilio account, using its SID.
Delegates to ExTwilio.Api.destroy/3.
Specs:
- find(String.t | nil, list) :: ExTwilio.Parser.parsed_list_response
Find any Call by its Twilio SID.
Delegates to ExTwilio.Api.find/3.
Examples
{:ok, call} = ExTwilio.Call.find("...")
{:error, msg, http_status} = ExTwilio.Call.find("...")Specs:
- first_page(%{}) :: ExTwilio.Parser.parsed_list_response
Get the first page of calls, using metadata from any page's response.
Delegates to ExTwilio.Api.fetch_page/2.
Examples
{:ok, page10, meta} = ExTwilio.Call.list(page: 10)
{:ok, page1, meta} = ExTwilio.Call.first_page(meta)Specs:
- last_page(%{}) :: ExTwilio.Parser.parsed_list_response
Get the last page of calls, using metadta from any page's response.
Delegates to ExTwilio.Api.fetch_page/2.
Examples
{:ok, page10, meta} = ExTwilio.Call.list(page: 10)
{:ok, last_page, meta} = ExTwilio.Call.last_page(meta)Specs:
- list(list) :: ExTwilio.Parser.parsed_list_response
Retrieve a list of Calls from the API.
Delegates to ExTwilio.Api.list/2.
Examples
# Successful response
{:ok, calls, metadata} = ExTwilio.Call.list
# Error response
{:error, msg, http_code} = ExTwilio.Call.listSpecs:
- new :: %ExTwilio.Call{account_sid: term, answered_by: term, caller_name: term, date_created: term, date_updated: term, direction: term, duration: term, end_time: term, forwarded_from: term, from: term, parent_call_sid: term, phone_number_sid: term, price: term, price_unit: term, sid: term, start_time: term, status: term, to: term, uri: term}
Creates a new ExTwilio.Call struct. Optionally, you can pass in attributes to set their initial value in the struct.
Example
%ExTwilio.Call{} = ExTwilio.Call.new
%ExTwilio.Call{sid: "sid"} = ExTwilio.Call.new(sid: "sid")Specs:
- new(list) :: %ExTwilio.Call{account_sid: term, answered_by: term, caller_name: term, date_created: term, date_updated: term, direction: term, duration: term, end_time: term, forwarded_from: term, from: term, parent_call_sid: term, phone_number_sid: term, price: term, price_unit: term, sid: term, start_time: term, status: term, to: term, uri: term}
Specs:
- next_page(%{}) :: ExTwilio.Parser.parsed_list_response
Get the next page of calls, using the metadata from the previous response. See all/0 for an easy way to get all the records.
Delegates to ExTwilio.Api.fetch_page/2.
Examples
{:ok, page1, meta} = ExTwilio.Call.list
{:ok, page2, meta} = ExTwilio.Call.next_page(meta)Specs:
- parents :: list
Specs:
- previous_page(%{}) :: ExTwilio.Parser.parsed_list_response
Get the previous page of calls, using metadata from a previous response.
Delegates to ExTwilio.Api.fetch_page/2.
Examples
{:ok, page2, meta} = ExTwilio.Call.list(page: 2)
{:ok, page1, meta} = ExTwilio.Call.previous_page(meta)Underscored and lowercased collection name for a given resource. Delegates the real work to ExTwilio.Api.resource_collection_name/1 by default.
Override in your module before use ExTwilio.Resource if you need something different.
CamelCase resource name as it would be used in Twilio's API. Delegates the real work to ExTwilio.Api.resource_name/1 by default.
Override in your module before use ExTwilio.Resource if you need something different.
Create a stream of all Call records from the Twilio API.
Delegates to ExTwilio.Api.stream/2.
Specs:
- update(String.t, list, list) :: ExTwilio.Parser.parsed_response
Update an Call in the Twilio API. You can pass it a binary SID as the identifier, or a whole %ExTwilio.Call{} struct.
Delegates to ExTwilio.Api.update/4.
Examples
{:ok, call} = ExTwilio.Call.update(%ExTwilio.Call{...}, field: "new_value")
{:ok, call} = ExTwilio.Call.update("<SID HERE>", field: "new_value")