Get Channel Integrations

Print
Dark
Light
PDF

Get Channel Integrations

Print
Dark
Light
PDF

Article summary

Did you find this summary helpful?

Thank you for your feedback

Get

/api/v1/channels.getIntegrations

Retrieves the integrations that the channel has. The endpoint requires at least one of the following integration permissions:

manage-incoming-integrations
manage-own-incoming-integrations
manage-outgoing-integrations
manage-own-outgoing-integrations.

It will return the integrations based on the user's permission.

Changelog

Version	Description
1.1.0	Separate permissions in `incoming` and `outgoing`.
0.49.0	Added

Header parameters

X-Auth-Token

stringRequired

The authToken of the authenticated user.

ExampleRScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f

X-User-Id

stringRequired

The userId of the authenticated user.

ExamplerbAXPnMktTFbNpwtJ

Query parameters

roomId

stringRequired

The room id.

Examplejdiue8TGkodp

offset

integer

Number of items to "skip" in the query, i.e. requests return count items, skipping the first offset items.

Example50

sort

List of fields to order by, and in which direction. This is a JSON object, with properties listed in desired order, with values of 1 for ascending, or -1 for descending. For example, {"value": -1, "_id": 1}

fields

string

This parameter accepts a JSON object with properties that have a value of 1 or 0 to include or exclude them in the response. For example, to only retrieve the usernames of users: fields={ "username": 1 }

query

This parameter allows you to use MongoDB query operators to search for specific data. For example, to query users with a name that contains the letter "g": query={ "name": { "$regex": "g" } }

count

integer

The number of items to return.

Example50

Responses

200

Example 1

{
  "integrations": [
    {
      "_id": "WMQDChpnYTRmFre9h",
      "enabled": true,
      "username": "rocket.cat",
      "alias": "Guggy",
      "avatar": "http://res.guggy.com/logo_128.png",
      "name": "Guggy",
      "triggerWords": [
        "!guggy",
        "guggy",
        "gif+"
      ],
      "urls": [
        "http://text2gif.guggy.com/guggify"
      ],
      "token": "8DFS89DMKLWEN",
      "script": "const config = {color: '#ffffff'};class Script{}",
      "scriptEnabled": true,
      "impersonateUser": false,
      "scriptCompiled": "function _classCallCheck(instance,Constructor){if(!(instance instanceof Constructor));",
      "scriptError": "",
      "type": "webhook-outgoing",
      "userId": "rocket.cat",
      "channel": [],
      "_createdAt": "2017-01-05T17:06:05.660Z",
      "_createdBy": {
        "username": "graywolf336",
        "_id": "R4jgcQaQhvvK6K3iY"
      },
      "_updatedAt": "2017-01-05T17:06:05.660Z"
    }
  ],
  "success": true
}

Expand All

object

integrations

Array of object

object

_id

string

enabled

boolean

username

string

alias

string

avatar

string

name

string

triggerWords

Array of string

string

urls

Array of string

string

token

string

script

string

scriptEnabled

boolean

impersonateUser

boolean

scriptCompiled

string

scriptError

string

type

string

userId

string

channel

Array of object

object

_createdAt

string

_createdBy

object

username

string

_id

string

_updatedAt

string

success

boolean

Was this article helpful?

What's Next

Convert channel to team