Twilio.Addresses (twilio v0.2.0)

Copy Markdown

API calls: create, delete, list, retrieve, update.

Summary

Functions

POST /2010-04-01/Accounts/{AccountSid}/Addresses.json

Like create/2, but returns the result or raises Infusion.Runtime.Error.

DELETE /2010-04-01/Accounts/{AccountSid}/Addresses/{Sid}.json

Like delete/2, but returns the result or raises Infusion.Runtime.Error.

GET /2010-04-01/Accounts/{AccountSid}/Addresses.json

Like list/2, but returns the result or raises Infusion.Runtime.Error.

Like list/2, but returns every item, from every page: a lazy stream of Twilio.Schemas.Address.t() that fetches pages as it is read.

GET /2010-04-01/Accounts/{AccountSid}/Addresses/{Sid}.json

Like retrieve/2, but returns the result or raises Infusion.Runtime.Error.

POST /2010-04-01/Accounts/{AccountSid}/Addresses/{Sid}.json

Functions

create(params \\ %{}, opts \\ [])

@spec create(map() | keyword(), keyword()) ::
  {:ok, Twilio.Schemas.Address.t()} | {:error, Infusion.Runtime.Error.t()}

POST /2010-04-01/Accounts/{AccountSid}/Addresses.json

{AccountSid} in the path is the :account_sid setting; pass account_sid: "..." as an option to use another.

Parameters

  • auto_correct_address - Whether we should automatically correct the address. Can be: true or false and the default is true. If empty or true, we will correct the address you provide if necessary. If false, we won't alter the address you provide.
  • city (required) - The city of the new address.
  • customer_name (required) - The name to associate with the new address.
  • emergency_enabled - Whether to enable emergency calling on the new address. Can be: true or false.
  • friendly_name - A descriptive string that you create to describe the new address. It can be up to 64 characters long for Regulatory Compliance addresses and 32 characters long for Emergency addresses.
  • iso_country (required) - The ISO country code of the new address.
  • postal_code (required) - The postal code of the new address.
  • region (required) - The state or region of the new address.
  • street (required) - The number and street address of the new address.
  • street_secondary - The additional number and street address of the address.

create!(params \\ %{}, opts \\ [])

@spec create!(map() | keyword(), keyword()) :: Twilio.Schemas.Address.t()

Like create/2, but returns the result or raises Infusion.Runtime.Error.

delete(sid, opts \\ [])

@spec delete(String.t(), keyword()) ::
  {:ok, nil} | {:error, Infusion.Runtime.Error.t()}

DELETE /2010-04-01/Accounts/{AccountSid}/Addresses/{Sid}.json

Path parameters

  • sid (required) - The Twilio-provided string that uniquely identifies the Address resource to delete.

{AccountSid} in the path is the :account_sid setting; pass account_sid: "..." as an option to use another.

delete!(sid, opts \\ [])

@spec delete!(String.t(), keyword()) :: nil

Like delete/2, but returns the result or raises Infusion.Runtime.Error.

list(params \\ %{}, opts \\ [])

@spec list(map() | keyword(), keyword()) ::
  {:ok, Twilio.Schemas.AddressesListResponse.t()}
  | {:error, Infusion.Runtime.Error.t()}

GET /2010-04-01/Accounts/{AccountSid}/Addresses.json

{AccountSid} in the path is the :account_sid setting; pass account_sid: "..." as an option to use another.

Parameters

  • customer_name - The customer_name of the Address resources to read.
  • friendly_name - The string that identifies the Address resources to read.
  • emergency_enabled - Whether the address can be associated to a number for emergency calling.
  • iso_country - The ISO country code of the Address resources to read.
  • page_size - How many resources to return in each list page. The default is 50, and the maximum is 1000.
  • page - The page index. This value is simply for client state.
  • page_token - The page token. This is provided by the API.

To read every item across all pages, use list_all.

list!(params \\ %{}, opts \\ [])

Like list/2, but returns the result or raises Infusion.Runtime.Error.

list_all(params \\ %{}, opts \\ [])

@spec list_all(map() | keyword(), keyword()) ::
  {:ok, Enumerable.t()} | {:error, Infusion.Runtime.Error.t()}

Like list/2, but returns every item, from every page: a lazy stream of Twilio.Schemas.Address.t() that fetches pages as it is read.

The first page is fetched right away, so its errors are returned; a later page that fails raises Infusion.Runtime.Error. Stopping early (Enum.take/2) fetches no more pages.

list_all!(params \\ %{}, opts \\ [])

@spec list_all!(map() | keyword(), keyword()) :: Enumerable.t()

Like list_all/2, but returns the stream or raises Infusion.Runtime.Error.

retrieve(sid, opts \\ [])

@spec retrieve(String.t(), keyword()) ::
  {:ok, Twilio.Schemas.Address.t()} | {:error, Infusion.Runtime.Error.t()}

GET /2010-04-01/Accounts/{AccountSid}/Addresses/{Sid}.json

Path parameters

  • sid (required) - The Twilio-provided string that uniquely identifies the Address resource to fetch.

{AccountSid} in the path is the :account_sid setting; pass account_sid: "..." as an option to use another.

retrieve!(sid, opts \\ [])

@spec retrieve!(String.t(), keyword()) :: Twilio.Schemas.Address.t()

Like retrieve/2, but returns the result or raises Infusion.Runtime.Error.

update(sid, params \\ %{}, opts \\ [])

@spec update(String.t(), map() | keyword(), keyword()) ::
  {:ok, Twilio.Schemas.Address.t()} | {:error, Infusion.Runtime.Error.t()}

POST /2010-04-01/Accounts/{AccountSid}/Addresses/{Sid}.json

Path parameters

  • sid (required) - The Twilio-provided string that uniquely identifies the Address resource to update.

{AccountSid} in the path is the :account_sid setting; pass account_sid: "..." as an option to use another.

Parameters

  • auto_correct_address - Whether we should automatically correct the address. Can be: true or false and the default is true. If empty or true, we will correct the address you provide if necessary. If false, we won't alter the address you provide.
  • city - The city of the address.
  • customer_name - The name to associate with the address.
  • emergency_enabled - Whether to enable emergency calling on the address. Can be: true or false.
  • friendly_name - A descriptive string that you create to describe the new address. It can be up to 64 characters long for Regulatory Compliance addresses and 32 characters long for Emergency addresses.
  • postal_code - The postal code of the address.
  • region - The state or region of the address.
  • street - The number and street address of the address.
  • street_secondary - The additional number and street address of the address.

update!(sid, params \\ %{}, opts \\ [])

@spec update!(String.t(), map() | keyword(), keyword()) :: Twilio.Schemas.Address.t()

Like update/3, but returns the result or raises Infusion.Runtime.Error.