From 8fe5968924799cdec8826ea5cc58cb1e4919a959 Mon Sep 17 00:00:00 2001 From: Vedran Zoricic Date: Mon, 16 Nov 2026 17:28:58 +0000 Subject: [PATCH 1/2] Say execution result bodies are omitted for third-party apps Updates the include_bodies parameter and the retrieve execution result description in 2.16, 2.17, 2.18 and Preview: request and response bodies are not returned to apps owned by another workspace. Co-Authored-By: Claude Opus 5.5 --- descriptions/0/api.intercom.io.yaml | 4 ++-- descriptions/2.16/api.intercom.io.yaml | 4 ++-- descriptions/2.17/api.intercom.io.yaml | 4 ++-- descriptions/2.18/api.intercom.io.yaml | 4 ++-- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 7ef3db1e..73aa4268 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -26154,7 +26154,7 @@ paths: - name: include_bodies in: query required: false - description: Include request/response bodies in the response (default false). + description: Include request/response bodies in the response (default false). Ignored for third-party apps (apps owned by another workspace), which never receive bodies. schema: type: string enum: @@ -26298,7 +26298,7 @@ paths: operationId: showDataConnectorExecutionResult description: | Retrieve details for a specific data connector execution result. - Includes the request/response bodies and sanitised request URL when they are available. + Includes the sanitised request URL, and the request/response bodies when they are available. Bodies are omitted when the request comes from a third-party app (an app owned by another workspace). OAuth tokens must have the `read_workflow_connector_execution_result` or `read_write_data_connectors` scope. responses: diff --git a/descriptions/2.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml index 02e93eae..e6284554 100644 --- a/descriptions/2.16/api.intercom.io.yaml +++ b/descriptions/2.16/api.intercom.io.yaml @@ -16854,7 +16854,7 @@ paths: - name: include_bodies in: query required: false - description: Include request/response bodies in the response (default false). + description: Include request/response bodies in the response (default false). Ignored for third-party apps (apps owned by another workspace), which never receive bodies. schema: type: string enum: @@ -16983,7 +16983,7 @@ paths: operationId: showDataConnectorExecutionResult description: | Retrieve details for a specific data connector execution result. - Always includes request/response bodies and the sanitised request URL. + Includes the sanitised request URL, and the request/response bodies unless the request comes from a third-party app (an app owned by another workspace). responses: '200': description: successful diff --git a/descriptions/2.17/api.intercom.io.yaml b/descriptions/2.17/api.intercom.io.yaml index f0f6cfbc..58ab8e7d 100644 --- a/descriptions/2.17/api.intercom.io.yaml +++ b/descriptions/2.17/api.intercom.io.yaml @@ -24880,7 +24880,7 @@ paths: - name: include_bodies in: query required: false - description: Include request/response bodies in the response (default false). + description: Include request/response bodies in the response (default false). Ignored for third-party apps (apps owned by another workspace), which never receive bodies. schema: type: string enum: @@ -25024,7 +25024,7 @@ paths: operationId: showDataConnectorExecutionResult description: | Retrieve details for a specific data connector execution result. - Includes the request/response bodies and sanitised request URL when they are available. + Includes the sanitised request URL, and the request/response bodies when they are available. Bodies are omitted when the request comes from a third-party app (an app owned by another workspace). OAuth tokens must have the `read_workflow_connector_execution_result` or `read_write_data_connectors` scope. responses: diff --git a/descriptions/2.18/api.intercom.io.yaml b/descriptions/2.18/api.intercom.io.yaml index 0392f1ce..a1a2a13d 100644 --- a/descriptions/2.18/api.intercom.io.yaml +++ b/descriptions/2.18/api.intercom.io.yaml @@ -25885,7 +25885,7 @@ paths: - name: include_bodies in: query required: false - description: Include request/response bodies in the response (default false). + description: Include request/response bodies in the response (default false). Ignored for third-party apps (apps owned by another workspace), which never receive bodies. schema: type: string enum: @@ -26029,7 +26029,7 @@ paths: operationId: showDataConnectorExecutionResult description: | Retrieve details for a specific data connector execution result. - Includes the request/response bodies and sanitised request URL when they are available. + Includes the sanitised request URL, and the request/response bodies when they are available. Bodies are omitted when the request comes from a third-party app (an app owned by another workspace). OAuth tokens must have the `read_workflow_connector_execution_result` or `read_write_data_connectors` scope. responses: From 8414bfab049355a2690fd168690365f2bb65d276 Mon Sep 17 00:00:00 2001 From: Vedran Zoricic Date: Mon, 16 Nov 2026 18:02:18 +0000 Subject: [PATCH 2/2] Say third-party apps never get bodies in the list description too The list operation still told readers include_bodies=true includes the bodies. Adds that apps owned by another workspace never receive them. Co-Authored-By: Claude Opus 5.5 --- descriptions/0/api.intercom.io.yaml | 2 +- descriptions/2.16/api.intercom.io.yaml | 2 +- descriptions/2.17/api.intercom.io.yaml | 2 +- descriptions/2.18/api.intercom.io.yaml | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 73aa4268..6fb72af2 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -26167,7 +26167,7 @@ paths: Retrieve paginated execution logs for a specific data connector. Results from the last hour are returned by default. Use `start_ts` and `end_ts` to customize the time range. - Request/response bodies are excluded by default. Use `include_bodies=true` to include them. + Request/response bodies are excluded by default. Use `include_bodies=true` to include them. Apps owned by another workspace never receive them. OAuth tokens must have the `read_workflow_connector_execution_result` or `read_write_data_connectors` scope. responses: diff --git a/descriptions/2.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml index e6284554..c44c49d0 100644 --- a/descriptions/2.16/api.intercom.io.yaml +++ b/descriptions/2.16/api.intercom.io.yaml @@ -16867,7 +16867,7 @@ paths: Retrieve paginated execution logs for a specific data connector. Results from the last hour are returned by default. Use `start_ts` and `end_ts` to customize the time range. - Request/response bodies are excluded by default. Use `include_bodies=true` to include them. + Request/response bodies are excluded by default. Use `include_bodies=true` to include them. Apps owned by another workspace never receive them. responses: '200': description: successful diff --git a/descriptions/2.17/api.intercom.io.yaml b/descriptions/2.17/api.intercom.io.yaml index 58ab8e7d..c2f0399f 100644 --- a/descriptions/2.17/api.intercom.io.yaml +++ b/descriptions/2.17/api.intercom.io.yaml @@ -24893,7 +24893,7 @@ paths: Retrieve paginated execution logs for a specific data connector. Results from the last hour are returned by default. Use `start_ts` and `end_ts` to customize the time range. - Request/response bodies are excluded by default. Use `include_bodies=true` to include them. + Request/response bodies are excluded by default. Use `include_bodies=true` to include them. Apps owned by another workspace never receive them. OAuth tokens must have the `read_workflow_connector_execution_result` or `read_write_data_connectors` scope. responses: diff --git a/descriptions/2.18/api.intercom.io.yaml b/descriptions/2.18/api.intercom.io.yaml index a1a2a13d..e62216e4 100644 --- a/descriptions/2.18/api.intercom.io.yaml +++ b/descriptions/2.18/api.intercom.io.yaml @@ -25898,7 +25898,7 @@ paths: Retrieve paginated execution logs for a specific data connector. Results from the last hour are returned by default. Use `start_ts` and `end_ts` to customize the time range. - Request/response bodies are excluded by default. Use `include_bodies=true` to include them. + Request/response bodies are excluded by default. Use `include_bodies=true` to include them. Apps owned by another workspace never receive them. OAuth tokens must have the `read_workflow_connector_execution_result` or `read_write_data_connectors` scope. responses: