Sign in
Alias Addresses

Create alias address

Creates an alias address that forwards to an existing resource in your project. name and resource_id are required; display_name defaults to name, channels to all three, codecs to none, and context to public. The handler resource can't be changed later: to point an alias at a different resource, delete it and create a new one.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Calling, Fax, Messaging, or Video.

Learn more about API scopes.

post/api/fabric/alias_addresses

Request body

namestring required

URL-safe name for the alias — lowercase letters and numbers, with underscores or dashes in place of spaces. Dashes can't start or end the name or appear twice in a row. Must be unique within its context and is used to build the alias's address.

resource_idstring uuid required

Universal Unique Identifier.

display_namestring

Human-friendly label for the alias. Defaults to name.

channelsAliasAddressChannel[]

Channels to enable on the alias. At least one is required. Defaults to all three.

codecsAddressCodec[]

Codecs to enable for calls to the alias. Defaults to none.

context'public' | 'private'

Access context an alias address lives in.

Example request

{
  "name": "support",
  "display_name": "Support Line",
  "channels": [
    "audio",
    "messaging"
  ],
  "codecs": [
    "OPUS",
    "PCMU"
  ]
}

Response

The request has succeeded and a new resource has been created as a result.

idstring uuid required

Universal Unique Identifier.

type'alias' required

The object type. Always alias.

resource_idstring uuid required

Universal Unique Identifier.

namestring required

URL-safe name for the alias. Used to build its address.

display_namestring required

Human-friendly label for the alias. Defaults to name.

display_type'app' | 'room' | 'call' | 'subscriber' required

DisplayTypes

channelsAliasAddressChannel[] required

Channels enabled on this alias.

codecsAddressCodec[] required

Codecs enabled for calls to this alias. Empty when none are set.

context'public' | 'private' required

Access context an alias address lives in.

uristring required

The resource address this alias resolves to, in the form /<context>/<name>.

created_atstring date-time required

Date and time when the alias address was created.

updated_atstring date-time required

Date and time when the alias address was last updated.

Example response

{
  "type": "alias",
  "name": "support",
  "display_name": "Support Line",
  "channels": [
    "audio",
    "messaging",
    "video"
  ],
  "codecs": [],
  "uri": "/public/support",
  "created_at": "2024-05-06T12:20:00Z",
  "updated_at": "2024-05-06T12:20:00Z"
}

Changes

Changed in 1 of the 161 revisions of this API.1

Of the 161 revisions, 3 have a changelog that could not be searched.