From 560f93225142821f82ae97d25df43ed46669f5eb Mon Sep 17 00:00:00 2001 From: Brian Scanlan Date: Thu, 19 Nov 2026 13:31:52 +0000 Subject: [PATCH 1/2] Document 403 on List all activity logs Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01PgoPJbcSxvox5NNgHTbcGH --- descriptions/0/api.intercom.io.yaml | 15 +++++++++++++++ descriptions/2.10/api.intercom.io.yaml | 15 +++++++++++++++ descriptions/2.11/api.intercom.io.yaml | 15 +++++++++++++++ descriptions/2.12/api.intercom.io.yaml | 15 +++++++++++++++ descriptions/2.13/api.intercom.io.yaml | 15 +++++++++++++++ descriptions/2.14/api.intercom.io.yaml | 15 +++++++++++++++ descriptions/2.15/api.intercom.io.yaml | 15 +++++++++++++++ descriptions/2.16/api.intercom.io.yaml | 15 +++++++++++++++ descriptions/2.17/api.intercom.io.yaml | 15 +++++++++++++++ descriptions/2.18/api.intercom.io.yaml | 15 +++++++++++++++ descriptions/2.7/api.intercom.io.yaml | 15 +++++++++++++++ descriptions/2.8/api.intercom.io.yaml | 15 +++++++++++++++ descriptions/2.9/api.intercom.io.yaml | 15 +++++++++++++++ 13 files changed, 195 insertions(+) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 20628595..8fc45673 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -448,6 +448,21 @@ paths: message: Not authorized to access resource schema: "$ref": "#/components/schemas/error" + '403': + description: Forbidden. Returned when the access token acts as a teammate + who lacks the permission to access all teammates and team details. + content: + application/json: + examples: + Teammate lacks permission: + value: + type: error.list + request_id: 52609d5a-89ae-4a95-aaae-c25f81ac8806 + errors: + - code: action_forbidden + message: Teammate lacks permission to access all teammates and team details + schema: + "$ref": "#/components/schemas/error" "/admins/activity_logs/search": post: summary: Search activity logs diff --git a/descriptions/2.10/api.intercom.io.yaml b/descriptions/2.10/api.intercom.io.yaml index ada5a4dd..f8330079 100644 --- a/descriptions/2.10/api.intercom.io.yaml +++ b/descriptions/2.10/api.intercom.io.yaml @@ -247,6 +247,21 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '403': + description: Forbidden. Returned when the access token acts as a teammate + who lacks the permission to access all teammates and team details. + content: + application/json: + examples: + Teammate lacks permission: + value: + type: error.list + request_id: 52609d5a-89ae-4a95-aaae-c25f81ac8806 + errors: + - code: action_forbidden + message: Teammate lacks permission to access all teammates and team details + schema: + "$ref": "#/components/schemas/error" "/admins": get: summary: List all admins diff --git a/descriptions/2.11/api.intercom.io.yaml b/descriptions/2.11/api.intercom.io.yaml index 6b4d7253..c86177ca 100644 --- a/descriptions/2.11/api.intercom.io.yaml +++ b/descriptions/2.11/api.intercom.io.yaml @@ -247,6 +247,21 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '403': + description: Forbidden. Returned when the access token acts as a teammate + who lacks the permission to access all teammates and team details. + content: + application/json: + examples: + Teammate lacks permission: + value: + type: error.list + request_id: 52609d5a-89ae-4a95-aaae-c25f81ac8806 + errors: + - code: action_forbidden + message: Teammate lacks permission to access all teammates and team details + schema: + "$ref": "#/components/schemas/error" "/admins": get: summary: List all admins diff --git a/descriptions/2.12/api.intercom.io.yaml b/descriptions/2.12/api.intercom.io.yaml index 3ec6a35f..48a545ca 100644 --- a/descriptions/2.12/api.intercom.io.yaml +++ b/descriptions/2.12/api.intercom.io.yaml @@ -247,6 +247,21 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '403': + description: Forbidden. Returned when the access token acts as a teammate + who lacks the permission to access all teammates and team details. + content: + application/json: + examples: + Teammate lacks permission: + value: + type: error.list + request_id: 52609d5a-89ae-4a95-aaae-c25f81ac8806 + errors: + - code: action_forbidden + message: Teammate lacks permission to access all teammates and team details + schema: + "$ref": "#/components/schemas/error" "/admins": get: summary: List all admins diff --git a/descriptions/2.13/api.intercom.io.yaml b/descriptions/2.13/api.intercom.io.yaml index 494f4b59..8884573e 100644 --- a/descriptions/2.13/api.intercom.io.yaml +++ b/descriptions/2.13/api.intercom.io.yaml @@ -278,6 +278,21 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '403': + description: Forbidden. Returned when the access token acts as a teammate + who lacks the permission to access all teammates and team details. + content: + application/json: + examples: + Teammate lacks permission: + value: + type: error.list + request_id: 52609d5a-89ae-4a95-aaae-c25f81ac8806 + errors: + - code: action_forbidden + message: Teammate lacks permission to access all teammates and team details + schema: + "$ref": "#/components/schemas/error" "/admins": get: summary: List all admins diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml index 39a2c541..4ea1959d 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -272,6 +272,21 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '403': + description: Forbidden. Returned when the access token acts as a teammate + who lacks the permission to access all teammates and team details. + content: + application/json: + examples: + Teammate lacks permission: + value: + type: error.list + request_id: 52609d5a-89ae-4a95-aaae-c25f81ac8806 + errors: + - code: action_forbidden + message: Teammate lacks permission to access all teammates and team details + schema: + "$ref": "#/components/schemas/error" "/admins": get: summary: List all admins diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml index 87f71c19..d4257f89 100644 --- a/descriptions/2.15/api.intercom.io.yaml +++ b/descriptions/2.15/api.intercom.io.yaml @@ -272,6 +272,21 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '403': + description: Forbidden. Returned when the access token acts as a teammate + who lacks the permission to access all teammates and team details. + content: + application/json: + examples: + Teammate lacks permission: + value: + type: error.list + request_id: 52609d5a-89ae-4a95-aaae-c25f81ac8806 + errors: + - code: action_forbidden + message: Teammate lacks permission to access all teammates and team details + schema: + "$ref": "#/components/schemas/error" "/admins": get: summary: List all admins diff --git a/descriptions/2.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml index c0bc28d3..3c1fb378 100644 --- a/descriptions/2.16/api.intercom.io.yaml +++ b/descriptions/2.16/api.intercom.io.yaml @@ -637,6 +637,21 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '403': + description: Forbidden. Returned when the access token acts as a teammate + who lacks the permission to access all teammates and team details. + content: + application/json: + examples: + Teammate lacks permission: + value: + type: error.list + request_id: 52609d5a-89ae-4a95-aaae-c25f81ac8806 + errors: + - code: action_forbidden + message: Teammate lacks permission to access all teammates and team details + schema: + "$ref": "#/components/schemas/error" "/admins/activity_logs/search": post: summary: Search activity logs diff --git a/descriptions/2.17/api.intercom.io.yaml b/descriptions/2.17/api.intercom.io.yaml index 6d437876..0a466169 100644 --- a/descriptions/2.17/api.intercom.io.yaml +++ b/descriptions/2.17/api.intercom.io.yaml @@ -813,6 +813,21 @@ paths: message: Not authorized to access resource schema: "$ref": "#/components/schemas/error" + '403': + description: Forbidden. Returned when the access token acts as a teammate + who lacks the permission to access all teammates and team details. + content: + application/json: + examples: + Teammate lacks permission: + value: + type: error.list + request_id: 52609d5a-89ae-4a95-aaae-c25f81ac8806 + errors: + - code: action_forbidden + message: Teammate lacks permission to access all teammates and team details + schema: + "$ref": "#/components/schemas/error" "/admins/activity_logs/search": post: summary: Search activity logs diff --git a/descriptions/2.18/api.intercom.io.yaml b/descriptions/2.18/api.intercom.io.yaml index abe82a9d..70186479 100644 --- a/descriptions/2.18/api.intercom.io.yaml +++ b/descriptions/2.18/api.intercom.io.yaml @@ -813,6 +813,21 @@ paths: message: Not authorized to access resource schema: "$ref": "#/components/schemas/error" + '403': + description: Forbidden. Returned when the access token acts as a teammate + who lacks the permission to access all teammates and team details. + content: + application/json: + examples: + Teammate lacks permission: + value: + type: error.list + request_id: 52609d5a-89ae-4a95-aaae-c25f81ac8806 + errors: + - code: action_forbidden + message: Teammate lacks permission to access all teammates and team details + schema: + "$ref": "#/components/schemas/error" "/admins/activity_logs/search": post: summary: Search activity logs diff --git a/descriptions/2.7/api.intercom.io.yaml b/descriptions/2.7/api.intercom.io.yaml index 2075d1e2..89ae7b49 100644 --- a/descriptions/2.7/api.intercom.io.yaml +++ b/descriptions/2.7/api.intercom.io.yaml @@ -247,6 +247,21 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '403': + description: Forbidden. Returned when the access token acts as a teammate + who lacks the permission to access all teammates and team details. + content: + application/json: + examples: + Teammate lacks permission: + value: + type: error.list + request_id: 52609d5a-89ae-4a95-aaae-c25f81ac8806 + errors: + - code: action_forbidden + message: Teammate lacks permission to access all teammates and team details + schema: + "$ref": "#/components/schemas/error" "/admins": get: summary: List all admins diff --git a/descriptions/2.8/api.intercom.io.yaml b/descriptions/2.8/api.intercom.io.yaml index 55ef7074..d29fcfe3 100644 --- a/descriptions/2.8/api.intercom.io.yaml +++ b/descriptions/2.8/api.intercom.io.yaml @@ -247,6 +247,21 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '403': + description: Forbidden. Returned when the access token acts as a teammate + who lacks the permission to access all teammates and team details. + content: + application/json: + examples: + Teammate lacks permission: + value: + type: error.list + request_id: 52609d5a-89ae-4a95-aaae-c25f81ac8806 + errors: + - code: action_forbidden + message: Teammate lacks permission to access all teammates and team details + schema: + "$ref": "#/components/schemas/error" "/admins": get: summary: List all admins diff --git a/descriptions/2.9/api.intercom.io.yaml b/descriptions/2.9/api.intercom.io.yaml index 558bb119..1e665291 100644 --- a/descriptions/2.9/api.intercom.io.yaml +++ b/descriptions/2.9/api.intercom.io.yaml @@ -247,6 +247,21 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '403': + description: Forbidden. Returned when the access token acts as a teammate + who lacks the permission to access all teammates and team details. + content: + application/json: + examples: + Teammate lacks permission: + value: + type: error.list + request_id: 52609d5a-89ae-4a95-aaae-c25f81ac8806 + errors: + - code: action_forbidden + message: Teammate lacks permission to access all teammates and team details + schema: + "$ref": "#/components/schemas/error" "/admins": get: summary: List all admins From b31d88d5e1c444a40c7d3ec750fbbb91ed2f36f5 Mon Sep 17 00:00:00 2001 From: Brian Scanlan Date: Thu, 19 Nov 2026 13:36:04 +0000 Subject: [PATCH 2/2] Document 403 on Search activity logs Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01PgoPJbcSxvox5NNgHTbcGH --- descriptions/0/api.intercom.io.yaml | 15 +++++++++++++++ descriptions/2.16/api.intercom.io.yaml | 15 +++++++++++++++ descriptions/2.17/api.intercom.io.yaml | 15 +++++++++++++++ descriptions/2.18/api.intercom.io.yaml | 15 +++++++++++++++ 4 files changed, 60 insertions(+) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 8fc45673..110bd4b9 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -606,6 +606,21 @@ paths: message: Not authorized to access resource schema: "$ref": "#/components/schemas/error" + '403': + description: Forbidden. Returned when the access token acts as a teammate + who lacks the permission to access all teammates and team details. + content: + application/json: + examples: + Teammate lacks permission: + value: + type: error.list + request_id: 52609d5a-89ae-4a95-aaae-c25f81ac8806 + errors: + - code: action_forbidden + message: Teammate lacks permission to access all teammates and team details + schema: + "$ref": "#/components/schemas/error" "/admins/activity_log_event_types": get: summary: List all activity log event types diff --git a/descriptions/2.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml index 3c1fb378..596f2a0b 100644 --- a/descriptions/2.16/api.intercom.io.yaml +++ b/descriptions/2.16/api.intercom.io.yaml @@ -770,6 +770,21 @@ paths: message: Access Token Invalid schema: "$ref": "#/components/schemas/error" + '403': + description: Forbidden. Returned when the access token acts as a teammate + who lacks the permission to access all teammates and team details. + content: + application/json: + examples: + Teammate lacks permission: + value: + type: error.list + request_id: 52609d5a-89ae-4a95-aaae-c25f81ac8806 + errors: + - code: action_forbidden + message: Teammate lacks permission to access all teammates and team details + schema: + "$ref": "#/components/schemas/error" "/admins/activity_log_event_types": get: summary: List all activity log event types diff --git a/descriptions/2.17/api.intercom.io.yaml b/descriptions/2.17/api.intercom.io.yaml index 0a466169..d44c30a7 100644 --- a/descriptions/2.17/api.intercom.io.yaml +++ b/descriptions/2.17/api.intercom.io.yaml @@ -971,6 +971,21 @@ paths: message: Not authorized to access resource schema: "$ref": "#/components/schemas/error" + '403': + description: Forbidden. Returned when the access token acts as a teammate + who lacks the permission to access all teammates and team details. + content: + application/json: + examples: + Teammate lacks permission: + value: + type: error.list + request_id: 52609d5a-89ae-4a95-aaae-c25f81ac8806 + errors: + - code: action_forbidden + message: Teammate lacks permission to access all teammates and team details + schema: + "$ref": "#/components/schemas/error" "/admins/activity_log_event_types": get: summary: List all activity log event types diff --git a/descriptions/2.18/api.intercom.io.yaml b/descriptions/2.18/api.intercom.io.yaml index 70186479..fc0c35ba 100644 --- a/descriptions/2.18/api.intercom.io.yaml +++ b/descriptions/2.18/api.intercom.io.yaml @@ -971,6 +971,21 @@ paths: message: Not authorized to access resource schema: "$ref": "#/components/schemas/error" + '403': + description: Forbidden. Returned when the access token acts as a teammate + who lacks the permission to access all teammates and team details. + content: + application/json: + examples: + Teammate lacks permission: + value: + type: error.list + request_id: 52609d5a-89ae-4a95-aaae-c25f81ac8806 + errors: + - code: action_forbidden + message: Teammate lacks permission to access all teammates and team details + schema: + "$ref": "#/components/schemas/error" "/admins/activity_log_event_types": get: summary: List all activity log event types