Skip to content

Commit cc6ad5d

Browse files
committed
Document GET /data_connectors/{id} - missing show endpoint
1 parent 35a19b9 commit cc6ad5d

2 files changed

Lines changed: 72 additions & 0 deletions

File tree

descriptions/0/api.intercom.io.yaml

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10090,6 +10090,76 @@ paths:
1009010090
message: Access Token Invalid
1009110091
schema:
1009210092
"$ref": "#/components/schemas/error"
10093+
"/data_connectors/{id}":
10094+
get:
10095+
summary: Retrieve a data connector
10096+
parameters:
10097+
- name: Intercom-Version
10098+
in: header
10099+
schema:
10100+
"$ref": "#/components/schemas/intercom_version"
10101+
- name: id
10102+
in: path
10103+
description: The unique identifier of the data connector
10104+
example: '12345'
10105+
required: true
10106+
schema:
10107+
type: string
10108+
tags:
10109+
- Data Connectors
10110+
operationId: RetrieveDataConnector
10111+
description: |
10112+
You can retrieve a single data connector by its ID.
10113+
10114+
The response includes full detail about the connector including its configuration, data inputs, response fields, and object mappings.
10115+
responses:
10116+
'200':
10117+
description: Data connector found
10118+
content:
10119+
application/json:
10120+
examples:
10121+
Data connector found:
10122+
value:
10123+
type: data_connector
10124+
id: '12345'
10125+
name: Slack Notification Service
10126+
description: Posts conversation updates to Slack channel
10127+
state: live
10128+
http_method: post
10129+
direct_fin_usage: false
10130+
created_at: '2025-11-15T09:30:00Z'
10131+
updated_at: '2026-01-20T14:22:15Z'
10132+
execution_results_url: "/data_connectors/12345/execution_results"
10133+
schema:
10134+
"$ref": "#/components/schemas/data_connector"
10135+
'404':
10136+
description: Data connector not found
10137+
content:
10138+
application/json:
10139+
examples:
10140+
Data connector not found:
10141+
value:
10142+
type: error.list
10143+
request_id: b4a45e2c-7a8d-4f3e-9c1a-2d5e8f7a6b3c
10144+
errors:
10145+
- code: data_connector_not_found
10146+
message: Data connector not found
10147+
schema:
10148+
"$ref": "#/components/schemas/error"
10149+
'401':
10150+
description: Unauthorized
10151+
content:
10152+
application/json:
10153+
examples:
10154+
Unauthorized:
10155+
value:
10156+
type: error.list
10157+
request_id: test-uuid-replacement
10158+
errors:
10159+
- code: unauthorized
10160+
message: Access Token Invalid
10161+
schema:
10162+
"$ref": "#/components/schemas/error"
1009310163
"/data_connectors/{data_connector_id}/execution_results":
1009410164
get:
1009510165
summary: List execution results for a data connector

descriptions/0/changelog.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
## `GET /data_connectors/{id}` added
2+
Added missing show endpoint for retrieving a single data connector by ID.

0 commit comments

Comments
 (0)