Integration access and safety
Whose account an agent uses, what happens to background tasks, and how to disconnect an app.
Written By Katja Danilina
Last updated About 1 month ago
An integration gives Mantle access to data or actions in another app. Review that access as carefully as you would for a new teammate or automation.
Your connection stays yours
A connected account belongs to the person who connected it. Sharing an agent doesn't give the workspace your sign-in or let others act as you.
When a teammate uses a shared agent, Mantle uses that teammate's own connection when a tool needs one. If they haven't connected the app, the tool may ask them to connect it, or the run stops.
Background tasks need a working connection
An automatic task uses the connection set up for it. If that connection expires, loses permission, or is disconnected, the task may pause or fail. After reconnecting:
review the permissions in the connected app;
check that the agent still has only the tools it needs;
use Run now to test the task;
turn automatic runs back on once the result is correct.
Events that happened while the connection was down may not be processed later.
Limit what an agent can do
Connect the smallest suitable account, team, project, or database.
Prefer read access when the job only needs to look things up.
Turn on individual tools instead of every available action.
Have a person review before an agent sends messages, moves money, deletes data, or publishes content.
Test with non-sensitive data and a reversible action first.
Keys and data
Mantle stores connection credentials securely and never shows secret values back in normal screens. Never paste an API key into a chat, channel, canvas, agent instructions, or a public support post.
When an agent posts results from a connected app into Mantle, the access rules of that chat, channel, or task apply to the copied result. Public links never give visitors your connected account, but any app data already written into a shared chat or canvas is visible.
Disconnect an app
Go to Settings → Integrations, open the app, and disconnect it. Then review agents and tasks that used its tools or triggers, and pause or update them.
If you think a key was exposed, revoke it in the connected app first, create a new one if needed, and tell your organization admin or contact support.
Full guide: https://docs.mantle.chat/integrations/security-and-delivery
Was this helpful?
More in Integrations
Post to a channel with an incoming webhookBuild a bot for your organizationStill need help? Ask the team