setting/channel_group/get - Equotix One API

This returns the list of channel groups available in the Equotix One account.

Request

Body Params application/json

domain

string

required

The domain you are assigned to authenticate your Equotix One account.

api_key

string

required

The email address assigned to the user account in your Equotix One.

auth_timestamp

integer

required

The unix timestamp used to sign this API request.

auth_signature

string

required

The calculated signature for this API request.

channel_group_id

integer

optional

The channel group ID to search for specifically.

filter_name

string

optional

Filter the list of channel groups by name.

filter_channel_id

integer

optional

Filter the list of channel groups by the channel ID.

filter_date_modified

string

optional

Filter the list of channel groups modified after the spcified date.

filter_deleted

boolean

optional

Filter the list of channel groups to include deleted records.

page

integer

optional

Page number of the results.

sort

string

optional

The key for the ordering of the results. Accepts "name", "date_modified"

order

string

optional

The direction for the ordering of the results. Accepts "ASC", "DESC"

limit

integer

optional

The number of results per page. Accepts 1 to 100.

Example

{
  "domain": "string",
  "api_key": "string",
  "auth_timestamp": 0,
  "auth_signature": "string",
  "channel_group_id": 0,
  "filter_name": "string",
  "filter_channel_id": 0,
  "filter_date_modified": "string",
  "filter_deleted": true,
  "page": 0,
  "sort": "string",
  "order": "string",
  "limit": 0
}

Responses

🟢200Success

application/json

Body

error

array[string]

optional

Returns only if there is an error.

total

integer

optional

The total number of results available.

channel_groups

array [object {5}]

optional

The list of channel groups.

channel_group_id

integer

required

The channel group ID.

name

string

required

The channel group name.

channels

array[integer]

required

The channels in the group.

date_modified

string

required

The date time this channel group was last modified.

deleted

boolean

optional

Indicates if the channel group has been deleted. Only returned if filter_deleted is "1".

Example

{
  "error": [
    "string"
  ],
  "total": 0,
  "channel_groups": [
    {
      "channel_group_id": 0,
      "name": "string",
      "channels": [
        0
      ],
      "date_modified": "string",
      "deleted": true
    }
  ]
}