Skip to main content
Integrations

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:

  1. review the permissions in the connected app;

  2. check that the agent still has only the tools it needs;

  3. use Run now to test the task;

  4. 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