Skip to content

Commit 774eec8

Browse files
Remove limited-availability framing from Office Hours API docs (#557)
Remove the Preview-version and limited-availability framing from the Office Hours tag description, and drop the plan-restricted 403 response from the schedules and exceptions endpoints. Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 8f369af commit 774eec8

1 file changed

Lines changed: 2 additions & 144 deletions

File tree

descriptions/0/api.intercom.io.yaml

Lines changed: 2 additions & 144 deletions
Original file line numberDiff line numberDiff line change
@@ -2682,20 +2682,6 @@ paths:
26822682
"$ref": "#/components/schemas/office_hours_schedule_list"
26832683
'401':
26842684
"$ref": "#/components/responses/Unauthorized"
2685-
'403':
2686-
description: API plan restricted
2687-
content:
2688-
application/json:
2689-
examples:
2690-
API plan restricted:
2691-
value:
2692-
type: error.list
2693-
request_id: 591a0c2f-78b3-41bb-bfa7-f1fae15107b9
2694-
errors:
2695-
- code: api_plan_restricted
2696-
message: Office Hours API feature not enabled for this workspace
2697-
schema:
2698-
"$ref": "#/components/schemas/error"
26992685
post:
27002686
summary: Create an office hours schedule
27012687
parameters:
@@ -2744,20 +2730,6 @@ paths:
27442730
"$ref": "#/components/schemas/office_hours_schedule"
27452731
'401':
27462732
"$ref": "#/components/responses/Unauthorized"
2747-
'403':
2748-
description: API plan restricted
2749-
content:
2750-
application/json:
2751-
examples:
2752-
API plan restricted:
2753-
value:
2754-
type: error.list
2755-
request_id: 591a0c2f-78b3-41bb-bfa7-f1fae15107b9
2756-
errors:
2757-
- code: api_plan_restricted
2758-
message: Office Hours API feature not enabled for this workspace
2759-
schema:
2760-
"$ref": "#/components/schemas/error"
27612733
'422':
27622734
"$ref": "#/components/responses/ValidationError"
27632735
"/office_hours_schedules/{id}":
@@ -2802,20 +2774,6 @@ paths:
28022774
"$ref": "#/components/schemas/office_hours_schedule"
28032775
'401':
28042776
"$ref": "#/components/responses/Unauthorized"
2805-
'403':
2806-
description: API plan restricted
2807-
content:
2808-
application/json:
2809-
examples:
2810-
API plan restricted:
2811-
value:
2812-
type: error.list
2813-
request_id: 591a0c2f-78b3-41bb-bfa7-f1fae15107b9
2814-
errors:
2815-
- code: api_plan_restricted
2816-
message: Office Hours API feature not enabled for this workspace
2817-
schema:
2818-
"$ref": "#/components/schemas/error"
28192777
'404':
28202778
"$ref": "#/components/responses/ObjectNotFound"
28212779
put:
@@ -2871,20 +2829,6 @@ paths:
28712829
"$ref": "#/components/schemas/office_hours_schedule"
28722830
'401':
28732831
"$ref": "#/components/responses/Unauthorized"
2874-
'403':
2875-
description: API plan restricted
2876-
content:
2877-
application/json:
2878-
examples:
2879-
API plan restricted:
2880-
value:
2881-
type: error.list
2882-
request_id: 591a0c2f-78b3-41bb-bfa7-f1fae15107b9
2883-
errors:
2884-
- code: api_plan_restricted
2885-
message: Office Hours API feature not enabled for this workspace
2886-
schema:
2887-
"$ref": "#/components/schemas/error"
28882832
'404':
28892833
"$ref": "#/components/responses/ObjectNotFound"
28902834
'422':
@@ -2932,20 +2876,6 @@ paths:
29322876
example: true
29332877
'401':
29342878
"$ref": "#/components/responses/Unauthorized"
2935-
'403':
2936-
description: API plan restricted
2937-
content:
2938-
application/json:
2939-
examples:
2940-
API plan restricted:
2941-
value:
2942-
type: error.list
2943-
request_id: 591a0c2f-78b3-41bb-bfa7-f1fae15107b9
2944-
errors:
2945-
- code: api_plan_restricted
2946-
message: Office Hours API feature not enabled for this workspace
2947-
schema:
2948-
"$ref": "#/components/schemas/error"
29492879
'404':
29502880
"$ref": "#/components/responses/ObjectNotFound"
29512881
"/office_hours_schedules/{office_hours_schedule_id}/office_hours_exceptions":
@@ -3004,20 +2934,6 @@ paths:
30042934
"$ref": "#/components/schemas/office_hours_exception_list"
30052935
'401':
30062936
"$ref": "#/components/responses/Unauthorized"
3007-
'403':
3008-
description: API plan restricted
3009-
content:
3010-
application/json:
3011-
examples:
3012-
API plan restricted:
3013-
value:
3014-
type: error.list
3015-
request_id: 591a0c2f-78b3-41bb-bfa7-f1fae15107b9
3016-
errors:
3017-
- code: api_plan_restricted
3018-
message: Office Hours API feature not enabled for this workspace
3019-
schema:
3020-
"$ref": "#/components/schemas/error"
30212937
'404':
30222938
"$ref": "#/components/responses/ObjectNotFound"
30232939
post:
@@ -3075,20 +2991,6 @@ paths:
30752991
"$ref": "#/components/schemas/office_hours_exception"
30762992
'401':
30772993
"$ref": "#/components/responses/Unauthorized"
3078-
'403':
3079-
description: API plan restricted
3080-
content:
3081-
application/json:
3082-
examples:
3083-
API plan restricted:
3084-
value:
3085-
type: error.list
3086-
request_id: 591a0c2f-78b3-41bb-bfa7-f1fae15107b9
3087-
errors:
3088-
- code: api_plan_restricted
3089-
message: Office Hours API feature not enabled for this workspace
3090-
schema:
3091-
"$ref": "#/components/schemas/error"
30922994
'404':
30932995
"$ref": "#/components/responses/ObjectNotFound"
30942996
'422':
@@ -3141,20 +3043,6 @@ paths:
31413043
"$ref": "#/components/schemas/office_hours_exception"
31423044
'401':
31433045
"$ref": "#/components/responses/Unauthorized"
3144-
'403':
3145-
description: API plan restricted
3146-
content:
3147-
application/json:
3148-
examples:
3149-
API plan restricted:
3150-
value:
3151-
type: error.list
3152-
request_id: 591a0c2f-78b3-41bb-bfa7-f1fae15107b9
3153-
errors:
3154-
- code: api_plan_restricted
3155-
message: Office Hours API feature not enabled for this workspace
3156-
schema:
3157-
"$ref": "#/components/schemas/error"
31583046
'404':
31593047
"$ref": "#/components/responses/ObjectNotFound"
31603048
put:
@@ -3221,20 +3109,6 @@ paths:
32213109
"$ref": "#/components/schemas/office_hours_exception"
32223110
'401':
32233111
"$ref": "#/components/responses/Unauthorized"
3224-
'403':
3225-
description: API plan restricted
3226-
content:
3227-
application/json:
3228-
examples:
3229-
API plan restricted:
3230-
value:
3231-
type: error.list
3232-
request_id: 591a0c2f-78b3-41bb-bfa7-f1fae15107b9
3233-
errors:
3234-
- code: api_plan_restricted
3235-
message: Office Hours API feature not enabled for this workspace
3236-
schema:
3237-
"$ref": "#/components/schemas/error"
32383112
'404':
32393113
"$ref": "#/components/responses/ObjectNotFound"
32403114
'422':
@@ -3289,20 +3163,6 @@ paths:
32893163
example: true
32903164
'401':
32913165
"$ref": "#/components/responses/Unauthorized"
3292-
'403':
3293-
description: API plan restricted
3294-
content:
3295-
application/json:
3296-
examples:
3297-
API plan restricted:
3298-
value:
3299-
type: error.list
3300-
request_id: 591a0c2f-78b3-41bb-bfa7-f1fae15107b9
3301-
errors:
3302-
- code: api_plan_restricted
3303-
message: Office Hours API feature not enabled for this workspace
3304-
schema:
3305-
"$ref": "#/components/schemas/error"
33063166
'404':
33073167
"$ref": "#/components/responses/ObjectNotFound"
33083168
"/export/reporting_data/enqueue":
@@ -37350,10 +37210,8 @@ tags:
3735037210
description: Everything about your Notes
3735137211
- name: Office Hours
3735237212
description: |
37353-
Manage office hours schedules and their exceptions. These endpoints are part of
37354-
the `Preview` API version and require an OAuth token with the `read_write_office_hours`
37355-
scope. The API is in limited availability — the scope becomes available once the
37356-
feature is enabled for your workspace; until then requests return `403 api_plan_restricted`.
37213+
Manage office hours schedules and their exceptions. These endpoints require an
37214+
OAuth token with the `read_write_office_hours` scope.
3735737215
- name: Procedures
3735837216
description: |
3735937217
Submit human-collected input to Fin Procedures via the HITL (Human in the Loop) API.

0 commit comments

Comments
 (0)