Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
docs(security): consolidate Security and Data into one page with redacted screenshot
Palash Kala9cfbb653717b
diff --git a/docs/content/docs/meta.json b/docs/content/docs/meta.jsonindex ff7286f4f..e76b7503c 100644--- a/docs/content/docs/meta.json+++ b/docs/content/docs/meta.json@@ -23,9 +23,7 @@"setting-up-triggers","webhook-verification","---Security and Data---",- "security/overview",- "security/data-retention",- "security/sub-processors",+ "security-and-data","---Direct Tool Execution Guides (Legacy)---","sessions-vs-direct-execution","tools-direct",diff --git a/docs/content/docs/security-and-data.mdx b/docs/content/docs/security-and-data.mdxnew file mode 100644index 000000000..116034fdb--- /dev/null+++ b/docs/content/docs/security-and-data.mdx@@ -0,0 +1,88 @@+---+title: Security and data+description: How Composio secures your data, what it stores, how long it is retained, and how to run with Zero Data Retention.+keywords: [security, data retention, zero data retention, ZDR, log storage, sub-processors, compliance, trust center, encryption]+---++Composio is built with security at its core. We use least-privilege defaults, isolate every organization and project, encrypt credentials, and give you controls over what we store, including your end users' data.++## Compliance and the Trust Center++Composio is SOC 2 Type II compliant. For our latest reports and certifications (the SOC 2 Type II report, our sub-processor list, and more), visit the [Composio Trust Center](https://trust.composio.dev).++{/* TRUST-OWNER: confirm the full certification list to name inline (ISO 27001?). SOC 2 Type II is the only one currently stated in our public FAQ. */}++## Isolation and access control++- Organizations and projects isolate your resources. Data from one project is not visible to another.+- API keys are scoped, support per-key IP allowlisting, and can opt in to capabilities such as Proxy Execute at creation.+- Multi-factor authentication (MFA) is available for Dashboard sign-in and can be enforced by an organization admin.++## Credential protection++- Connected-account credentials, auth configs, and API keys are encrypted at rest using AES-256-GCM, and all traffic is encrypted in transit using TLS.+- Connected-account tokens are redacted by default in API responses, for both Composio-managed and custom auth configs. To act on a provider directly, use [Proxy Execute](/docs/proxy-execute).+- Webhook deliveries are signed; verify the `webhook-signature` header (see [Webhook verification](/docs/webhook-verification)).++## Customer data vs. your end users' data++Throughout this guide, *you* are the Composio customer, and *your end users* are the people your agent acts on behalf of, each identified by the opaque `user_id` you supply. When a tool runs, its request and response often contain **your end users' data**. Composio never stores your end users' identities (only the `user_id` you provide), so their data lives entirely in the **tool-call payloads**, which is exactly what the **Log storage** control below governs.++## What Composio stores++When your agent runs a tool, Composio writes an execution log. Each log records:++- which toolkit and action ran, success or failure and the status, the connection and auth-config IDs, the `user_id` you supplied, timing, and the runtime/source;+- by default, the **request arguments** and the **response data** of the call.++Trigger events are logged similarly.++## How long we retain it++Tool execution logs and trigger event logs are retained for up to **one year**, after which they are automatically deleted.++{/* TRUST-OWNER: code-confirmed TTL is 1 year for tool/trigger logs. Confirm windows for other data classes before stating them. */}++## Zero Data Retention: the Log storage setting++You control how much of each call is stored, per project, in **Settings → General → Log storage**:++- **Store all logs** (default) — the full request and response payloads are stored on the execution log.+- **Don't store data** — Composio does not persist the request arguments or the response data of your tool calls. It keeps only the audit record: which tool ran, when, success or failure, the IDs, and timing.++Selecting **Don't store data** lets you run Composio with **zero retention of tool-call payloads**, including your end users' data, while keeping an audit trail. The same setting governs [Proxy Execute](/docs/proxy-execute) logging, which fails closed: if the setting cannot be read, payloads are not stored.++++<Callout type="info">+To enable: open the Dashboard, choose your project, go to **Settings → General → Log storage**, and select **Don't store data**.+</Callout>++### What "Don't store data" does and does not cover++- **Covered:** the request arguments and response data are dropped from the durable execution log.+- **Not covered** (inherent to running a tool call): while a call runs, the data is still sent to the destination provider and passes through Composio's execution path; file payloads may transit object storage; and trigger payloads are delivered to your configured destinations in real time.++## Data flow and sub-processors++Composio relies on a small set of infrastructure providers to host the platform, execute your tool calls, and deliver triggers. The **authoritative, current list of our sub-processors** lives in the [Composio Trust Center](https://trust.composio.dev/subprocessors). At a category level:++- **Tool calls** are made to the **destination provider** you integrate with, which receives the request and returns the response.+- **Execution and logging** run on Composio's infrastructure; whether payloads are stored is governed by your Log storage setting above.+- **Files** in tool calls may pass through object storage while a call runs.+- **Code execution** runs in an isolated sandbox, only when you use the workbench or code execution.+- **Triggers** are delivered to the destinations you configure, in real time.+- **Tool discovery** sends your natural-language search query (not your execution payloads) to a model and embeddings provider.++Composio's primary processing region is the United States (AWS `us-east-1`).++{/* TRUST-OWNER: reconcile the sub-processor list (Trust Center lists 5; actual egress is broader) and confirm EU/region options before pointing customers here as authoritative. */}++## Stronger guarantees++For a contractual zero-data-retention agreement or shorter retention windows, [contact sales](https://composio.dev/contact?utm_source=docs). For our data-handling policies and the current sub-processor list, see the [Composio Trust Center](https://trust.composio.dev).++## Reporting a vulnerability++{/* TRUST-OWNER: confirm the disclosure channel. */}+To report a security issue, contact `[email protected]`. Please do not disclose vulnerabilities publicly until we have addressed them.diff --git a/docs/content/docs/security/data-retention.mdx b/docs/content/docs/security/data-retention.mdxdeleted file mode 100644index 30c763349..000000000--- a/docs/content/docs/security/data-retention.mdx+++ /dev/null@@ -1,56 +0,0 @@-----title: Data retention and Zero Data Retention-description: What Composio stores from your tool calls, how long it is retained, and how to minimize or eliminate payload storage with the Log storage setting.-keywords: [data retention, zero data retention, ZDR, logs, log storage, privacy, dont store data]------Composio stores an audit log of tool executions so you can observe and debug your agents. You control how much of each call is stored, including running with no payload retention at all.--## Customer data vs. your end users' data--Throughout this guide, *you* are the Composio customer, and *your end users* are the people your agent acts on behalf of, each identified by the opaque `user_id` you supply. When a tool runs, its request and response often contain **your end users' data**. Composio never stores your end users' identities (only the `user_id` you provide), so their data lives entirely in the **tool-call payloads**, which is exactly what the **Log storage** control below governs. Set it to **Don't store data** to keep an audit trail of which tools ran while ensuring Composio does not retain your end users' data.--## What Composio stores--When your agent runs a tool, Composio writes an execution log. Each log records:--- which toolkit and action ran, success or failure and the status, the connection and auth-config IDs, the `user_id` you supplied, timing, and the runtime/source;-- by default, the **request arguments** and the **response data** of the call.--Trigger events are logged similarly. Composio identifies your end users only by the opaque `user_id` you provide; it does not store end-user identities beyond that.--## How long we retain it--Tool execution logs and trigger event logs are retained for up to **one year**, after which they are automatically deleted.--{/* TRUST-OWNER: code-confirmed TTL is 1 year for tool_execution_logs and trigger_event_logs. Confirm retention windows for other data classes (connected-account data, webhook delivery records, support transcripts) before stating them. The "30 days" figure mentioned on a call is NOT in code. */}--## Log storage: control what we store--You control how much of each call is stored, per project, in **Settings → General → Log storage**:--- **Store all logs** (default) — the full request and response payloads are stored on the execution log.-- **Don't store data** — Composio does not persist the request arguments or the response data of your tool calls. It keeps only the audit record: which tool ran, when, success or failure, the IDs, and timing.--Selecting **Don't store data** lets you run Composio with **zero retention of tool-call payloads**, including your end users' data, while keeping an audit trail. The same setting governs [Proxy Execute](/docs/proxy-execute) logging, which fails closed: if the setting cannot be read, payloads are not stored.--<Callout type="info">-To enable: open the Dashboard, choose your project, go to **Settings → General → Log storage**, and select **Don't store data**.-</Callout>--## What "Don't store data" does and does not cover--- **Covered:** the request arguments and response data are dropped from the durable execution log.-- **Not covered** (this is inherent to running a tool call): while a call runs, the data is still sent to the destination provider and passes through Composio's execution path; file payloads may transit object storage; and trigger payloads are delivered to your configured destinations in real time. See [Sub-processors and data flow](/docs/security/sub-processors).--{/* TRUST-OWNER: real-time trigger delivery is not gated by this setting; confirm phrasing. */}--## Encryption--Connected-account credentials, auth configs, and API keys are encrypted at rest using AES-256-GCM, and all traffic is encrypted in transit using TLS.--{/* TRUST-OWNER: at-rest encryption of the execution-log store itself is NOT asserted here. Only secret-field AES-256-GCM is code-confirmed. Confirm with the Trust Center before adding a broader at-rest claim. */}--## Stronger guarantees--For a contractual zero-data-retention agreement or shorter retention windows, [contact sales](https://composio.dev/contact?utm_source=docs). For our data-handling policies and the current sub-processor list, see the [Composio Trust Center](https://trust.composio.dev).diff --git a/docs/content/docs/security/overview.mdx b/docs/content/docs/security/overview.mdxdeleted file mode 100644index ec1f50364..000000000--- a/docs/content/docs/security/overview.mdx+++ /dev/null@@ -1,43 +0,0 @@-----title: Security-description: How Composio secures your data, credentials, and tool execution, and where to find our compliance reports.-keywords: [security, compliance, SOC 2, trust center, encryption, isolation, data]------Composio is built with security at its core. We use least-privilege defaults, isolate every organization and project, encrypt credentials, and give you controls over what we store, including your end users' data.--## Compliance and the Trust Center--Composio is SOC 2 Type II compliant. For our latest reports and certifications (the SOC 2 Type II report, our sub-processor list, and more), visit the [Composio Trust Center](https://trust.composio.dev).--{/* TRUST-OWNER: confirm the full certification list to name inline. SOC 2 Type II is the only one currently stated in our public FAQ; add ISO 27001 etc. only if confirmed. */}--## Isolation and access control--- Organizations and projects isolate your resources. Data from one project is not visible to another.-- API keys are scoped, support per-key IP allowlisting, and can opt in to capabilities such as Proxy Execute at creation.-- Multi-factor authentication (MFA) is available for Dashboard sign-in and can be enforced by an organization admin.--## Credential protection--- Connected-account credentials, auth configs, and API keys are encrypted at rest using AES-256-GCM, and all traffic is encrypted in transit using TLS.-- Connected-account tokens are redacted by default in API responses, for both Composio-managed and custom auth configs. To act on a provider directly, use [Proxy Execute](/docs/proxy-execute).--## Webhooks and triggers--Webhook deliveries are signed. Verify the `webhook-signature` header before trusting a payload. See [Webhook verification](/docs/webhook-verification).--## Your responsibilities--Composio executes the tools and connections you configure. You control which toolkits are enabled, which accounts are connected, and what your agents are allowed to do. Review the access you grant, and treat connected-account scopes as you would any production credential. Composio does not security-audit the third-party tools or MCP servers you choose to connect.--## Reporting a vulnerability--{/* TRUST-OWNER: confirm the disclosure channel ([email protected] / bug-bounty URL). */}-To report a security issue, contact `[email protected]`. Please do not disclose vulnerabilities publicly until we have addressed them.--## Related resources--- [Data retention and Zero Data Retention](/docs/security/data-retention)-- [Sub-processors and data flow](/docs/security/sub-processors)-- [Composio Trust Center](https://trust.composio.dev): security certifications and compliance.diff --git a/docs/content/docs/security/sub-processors.mdx b/docs/content/docs/security/sub-processors.mdxdeleted file mode 100644index cb36047bd..000000000--- a/docs/content/docs/security/sub-processors.mdx+++ /dev/null@@ -1,28 +0,0 @@-----title: Sub-processors and data flow-description: How your data flows when you use Composio, and where to find the authoritative list of our sub-processors.-keywords: [sub-processors, subprocessors, data flow, third parties, data residency, gdpr]------Composio relies on a small set of infrastructure providers to host the platform, execute your tool calls, and deliver triggers. The **authoritative, current list of our sub-processors** — with each provider's purpose and region — lives in the [Composio Trust Center](https://trust.composio.dev/subprocessors). Always refer to that list for specific vendors and regions.--This page explains, at a category level, where your data goes so you can reason about exposure.--## How your data flows--- **Tool calls** are made to the **destination provider** you are integrating with (for example, your CRM or email service). That provider receives the request and returns the response.-- **Execution and logging** run on Composio's infrastructure. Whether the request and response payloads are stored is controlled by your [Log storage setting](/docs/security/data-retention) — set it to "Don't store data" to keep only the audit record.-- **Files** in tool calls may pass through object storage while a call runs.-- **Code execution** runs in an isolated sandbox, only when you use the workbench or code execution.-- **Triggers** are delivered to the destinations you configure, in real time.-- **Tool discovery** sends your natural-language search query (not your execution payloads) to a model and embeddings provider to find relevant tools.--## What is not sent--Operational monitoring and billing systems receive metadata and usage information, not your tool-call payloads.--## Data residency--Composio's primary processing region is the United States (AWS `us-east-1`).--For the current list of sub-processors and our data-processing terms, see the [Composio Trust Center](https://trust.composio.dev/subprocessors).diff --git a/docs/public/images/log-storage-dont-store-data.png b/docs/public/images/log-storage-dont-store-data.pngnew file mode 100644index 000000000..c2d64df1fBinary files /dev/null and b/docs/public/images/log-storage-dont-store-data.png differ