List portals
Every help center site (portal) of the account, ordered by id — with the slug the other help center endpoints take in the path. Start here when you don’t know the slug.
Not paginated on purpose: an account holds a handful of portals, and consumers need the whole list to resolve a slug.
Authorizations
The id_token from POST /auth/v1/signin, sent as Authorization: Bearer <id_token>. Not the access_token — that one does not carry the identity Cloud Chat authorizes on.
Headers
Your Cloud Chat instance ID — an integer, fixed for your company, told at onboarding. The API overview explains how instances work, how to find yours, and the errors a wrong or missing value produces.
1
Path Parameters
Your Cloud Chat account. It has to be an account your token grants membership on, and it has to live on the instance in the cloudchat-instance header — the two travel together. Account numbers are only unique within an instance, so the same number is a different company on another instance. Usually a mismatched pair fails closed with a 401, because your user does not exist on the other instance — but if your identity happens to exist on both, the call succeeds against the other company's data, silently. Read it and you are looking at the wrong help center; write it and you have stored into the wrong account. Send the two values that were given to you together, and never try a number to see what answers.
1
Response
Every portal of the account. An account with none answers an empty data, not a 404.
Every portal of the account. Not paginated — an account holds a handful of portals.
Ordered by id, ascending.