Skip to main content
GET
/
v1
/
api
/
slack
/
channels
List Slack channels
curl --request GET \
  --url https://api.hq.zone/v1/api/slack/channels \
  --header 'Authorization: Bearer <token>'
{
  "channels": [
    {
      "id": "<string>",
      "is_private": true,
      "name": "<string>"
    }
  ],
  "connected": true
}

Authorizations

​
Authorization
string
header
required

Personal Access Token. Send as Authorization: Bearer hq_pat_....

Response

200 - application/json

Channels the HQ bot belongs to

​
channels
object[]
required
​
connected
boolean
required

Whether this workspace has a live (non-revoked) Slack install. false means the picker should prompt to connect Slack rather than show an empty list.