Connections
A connection is an outside app or account linked to the workspace, such as an accounting system or a mailbox. Connecting one needs a sign-in in the app; everything after that can be done here.
Is it working?
connectionswith actionlist: the connections you can use — your own, ones teammates opened to you, and ones for the whole workspace. Each says whether it works: active, pending (waiting for an approval) or incomplete (setup left part-way).- Action
check: ask the outside app again whether your pending connection was approved. - Action
progress: the setup steps, how far yours got and what comes next. - Only active connections can be used. Tell the user what is missing rather than trying anyway.
Who may use it
connections with action access shows it and manage_connections with action set_access changes it: only the person who connected it, selected teammates, or the whole workspace. Only the person who connected it may change this, and opening it to everyone lets every member use that account.
Actions in connected apps
connections with action actions shows what you can do and the details each needs; manage_connections with action run_action runs one. Actions that change something in the outside app wait for a person to approve them in the app first.
Disconnecting
Call connections with action disconnect_impact first and tell the user which workflows would stop. manage_connections with action disconnect cannot be undone; connecting again makes a new connection.


