list_connections
Retrieve all your platform connections (Slack, Discord, file imports) with metadata including status, platform, and last sync time. Use this before listing channels.
Instructions
List the platform connections (Slack workspaces, Discord servers, file imports, etc.) this principal owns, with each connection's metadata.
Use this when you need a connection's platform, status, or sync metadata —
not just its id. If you only need the connection ids, whoami is cheaper.
After picking a connection here, call list_channels(connection_id) to see
its actual channels. Results are ownership-filtered: you only see your own.
Latency: instant (read-only; no sync triggered).
Returns {"connections": [<entry>, ...]} (empty list if none). Each entry:
connection_id(str): e.g."conn_abc123"— pass tolist_channels.platform(str): e.g."slack","discord","file".display_name(str): human label, e.g."Acme Workspace".status(str): connection health, e.g."connected".last_synced_at(str|null): ISO timestamp of the most recent sync of a PICKED channel;nullwhen the pick-list is empty (see caveat below).selected_channel_count(int): size of the sync pick-list (see caveat).source(str): how the connection was created, e.g."oauth".
Caveats (do NOT misread): selected_channel_count is the user's opted-in
sync pick-list, NOT how many channels exist. A value of 0 does not mean
the connection is empty — a Slack workspace with 0 picks can still have
dozens of bot-readable channels. last_synced_at is scoped to the same
pick-list, so an empty pick-list yields null even if channels were synced
another way. For ground-truth channel availability, always call
list_channels(connection_id) — never infer it from these counts.
Error modes: returns {"error": "authentication_missing"} when no valid
principal is attached. Never raises access-denied (output is self-scoped).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||