Skip to content

Commit 359fbd0

Browse files
Document granular conversation priority levels in Preview spec (#573)
The conversation priority field and the priority_changed conversation part now expose granular levels (none, low, medium, high, urgent) in the Preview spec, replacing the binary priority/not_priority values. Example values are normalized to the new enum. Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 0b5e004 commit 359fbd0

1 file changed

Lines changed: 48 additions & 40 deletions

File tree

descriptions/0/api.intercom.io.yaml

Lines changed: 48 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -10531,7 +10531,7 @@ paths:
1053110531
tags:
1053210532
type: tag.list
1053310533
tags: []
10534-
priority: not_priority
10534+
priority: none
1053510535
sla_applied:
1053610536
statistics:
1053710537
conversation_rating:
@@ -10570,7 +10570,7 @@ paths:
1057010570
open: true
1057110571
state: open
1057210572
read: true
10573-
priority: not_priority
10573+
priority: none
1057410574
admin_assignee_id: 991267715
1057510575
team_assignee_id: 5017691
1057610576
ai_agent_participated: false
@@ -10847,7 +10847,7 @@ paths:
1084710847
applied_by:
1084810848
type: contact
1084910849
id: '1a2b3c'
10850-
priority: not_priority
10850+
priority: none
1085110851
sla_applied:
1085210852
statistics:
1085310853
conversation_rating:
@@ -11027,7 +11027,7 @@ paths:
1102711027
applied_by:
1102811028
type: contact
1102911029
id: '1a2b3c'
11030-
priority: not_priority
11030+
priority: none
1103111031
sla_applied:
1103211032
statistics:
1103311033
conversation_rating:
@@ -11160,7 +11160,7 @@ paths:
1116011160
open: true
1116111161
state: open
1116211162
read: true
11163-
priority: not_priority
11163+
priority: none
1116411164
admin_assignee_id: 991267715
1116511165
team_assignee_id: 5017691
1116611166
ai_agent_participated: false
@@ -11325,15 +11325,15 @@ paths:
1132511325
tags:
1132611326
type: tag.list
1132711327
tags: []
11328-
priority: not_priority
11328+
priority: none
1132911329
sla_applied:
1133011330
statistics:
1133111331
conversation_rating:
1133211332
teammates:
1133311333
title:
1133411334
custom_attributes:
1133511335
issue_type: Billing
11336-
priority: High
11336+
priority: high
1133711337
topics: {}
1133811338
ticket:
1133911339
linked_objects:
@@ -11426,7 +11426,7 @@ paths:
1142611426
tags:
1142711427
type: tag.list
1142811428
tags: []
11429-
priority: not_priority
11429+
priority: none
1143011430
sla_applied:
1143111431
statistics:
1143211432
conversation_rating:
@@ -11518,7 +11518,7 @@ paths:
1151811518
title: new conversation title
1151911519
custom_attributes:
1152011520
issue_type: Billing
11521-
priority: High
11521+
priority: high
1152211522
update_a_conversation_with_an_association_to_a_custom_object_instance:
1152311523
summary: update a conversation with an association to a custom object
1152411524
instance
@@ -11533,7 +11533,7 @@ paths:
1153311533
title: new conversation title
1153411534
custom_attributes:
1153511535
issue_type: Billing
11536-
priority: High
11536+
priority: high
1153711537
delete:
1153811538
summary: Delete a conversation
1153911539
parameters:
@@ -11794,7 +11794,7 @@ paths:
1179411794
tags:
1179511795
type: tag.list
1179611796
tags: []
11797-
priority: not_priority
11797+
priority: none
1179811798
sla_applied:
1179911799
statistics:
1180011800
conversation_rating:
@@ -11833,7 +11833,7 @@ paths:
1183311833
open: true
1183411834
state: open
1183511835
read: true
11836-
priority: not_priority
11836+
priority: none
1183711837
admin_assignee_id: 991267715
1183811838
team_assignee_id: 5017691
1183911839
ai_agent_participated: false
@@ -11954,7 +11954,7 @@ paths:
1195411954
tags:
1195511955
type: tag.list
1195611956
tags: []
11957-
priority: not_priority
11957+
priority: none
1195811958
sla_applied:
1195911959
statistics:
1196011960
conversation_rating:
@@ -12034,7 +12034,7 @@ paths:
1203412034
tags:
1203512035
type: tag.list
1203612036
tags: []
12037-
priority: not_priority
12037+
priority: none
1203812038
sla_applied:
1203912039
statistics:
1204012040
conversation_rating:
@@ -12126,7 +12126,7 @@ paths:
1212612126
tags:
1212712127
type: tag.list
1212812128
tags: []
12129-
priority: not_priority
12129+
priority: none
1213012130
sla_applied:
1213112131
statistics:
1213212132
conversation_rating:
@@ -12209,7 +12209,7 @@ paths:
1220912209
tags:
1221012210
type: tag.list
1221112211
tags: []
12212-
priority: not_priority
12212+
priority: none
1221312213
sla_applied:
1221412214
statistics:
1221512215
conversation_rating:
@@ -12413,7 +12413,7 @@ paths:
1241312413
tags:
1241412414
type: tag.list
1241512415
tags: []
12416-
priority: not_priority
12416+
priority: none
1241712417
sla_applied:
1241812418
statistics:
1241912419
conversation_rating:
@@ -12493,7 +12493,7 @@ paths:
1249312493
tags:
1249412494
type: tag.list
1249512495
tags: []
12496-
priority: not_priority
12496+
priority: none
1249712497
sla_applied:
1249812498
statistics:
1249912499
conversation_rating:
@@ -12573,7 +12573,7 @@ paths:
1257312573
tags:
1257412574
type: tag.list
1257512575
tags: []
12576-
priority: not_priority
12576+
priority: none
1257712577
sla_applied:
1257812578
statistics:
1257912579
conversation_rating:
@@ -12653,7 +12653,7 @@ paths:
1265312653
tags:
1265412654
type: tag.list
1265512655
tags: []
12656-
priority: not_priority
12656+
priority: none
1265712657
sla_applied:
1265812658
statistics:
1265912659
conversation_rating:
@@ -13365,7 +13365,7 @@ paths:
1336513365
tags:
1336613366
type: tag.list
1336713367
tags: []
13368-
priority: not_priority
13368+
priority: none
1336913369
sla_applied:
1337013370
statistics:
1337113371
conversation_rating:
@@ -13527,7 +13527,7 @@ paths:
1352713527
tags:
1352813528
type: tag.list
1352913529
tags: []
13530-
priority: not_priority
13530+
priority: none
1353113531
sla_applied:
1353213532
statistics:
1353313533
conversation_rating:
@@ -18887,28 +18887,28 @@ paths:
1888718887
phone: "+353832345678"
1888818888
custom_attributes:
1888918889
issue_type: Billing
18890-
priority: High
18890+
priority: high
1889118891
bad_request_-_exception_sending_sms:
1889218892
summary: bad request - exception sending sms
1889318893
value:
1889418894
phone: "+353832345678"
1889518895
custom_attributes:
1889618896
issue_type: Billing
18897-
priority: High
18897+
priority: high
1889818898
bad_request_-_invalid_number:
1889918899
summary: bad request - invalid number
1890018900
value:
1890118901
phone: "+353832345678"
1890218902
custom_attributes:
1890318903
issue_type: Billing
18904-
priority: High
18904+
priority: high
1890518905
unprocessable_entity:
1890618906
summary: unprocessable entity
1890718907
value:
1890818908
phone: "+40241100100"
1890918909
custom_attributes:
1891018910
issue_type: Billing
18911-
priority: High
18911+
priority: high
1891218912
"/calls":
1891318913
get:
1891418914
summary: List all calls
@@ -28687,10 +28687,14 @@ components:
2868728687
priority:
2868828688
type: string
2868928689
enum:
28690-
- priority
28691-
- not_priority
28692-
description: If marked as priority, it will return priority or else not_priority.
28693-
example: priority
28690+
- none
28691+
- low
28692+
- medium
28693+
- high
28694+
- urgent
28695+
description: The priority level of the conversation. Returns one of none,
28696+
low, medium, high, or urgent.
28697+
example: high
2869428698
admin_assignee_id:
2869528699
type: integer
2869628700
description: The id of the admin assigned to the conversation. If it's not
@@ -28822,10 +28826,14 @@ components:
2882228826
priority:
2882328827
type: string
2882428828
enum:
28825-
- priority
28826-
- not_priority
28827-
description: If marked as priority, it will return priority or else not_priority.
28828-
example: priority
28829+
- none
28830+
- low
28831+
- medium
28832+
- high
28833+
- urgent
28834+
description: The priority level of the conversation. Returns one of none,
28835+
low, medium, high, or urgent.
28836+
example: high
2882928837
admin_assignee_id:
2883028838
type: integer
2883128839
description: The id of the admin assigned to the conversation. If it's not
@@ -33118,14 +33126,14 @@ components:
3311833126
properties:
3311933127
current_priority:
3312033128
type: string
33121-
enum: ["priority", "not_priority"]
33122-
description: Current priority state
33123-
example: "priority"
33129+
enum: ["none", "low", "medium", "high", "urgent"]
33130+
description: Current priority level
33131+
example: "high"
3312433132
previous_priority:
3312533133
type: string
33126-
enum: ["priority", "not_priority"]
33127-
description: Previous priority state
33128-
example: "not_priority"
33134+
enum: ["none", "low", "medium", "high", "urgent"]
33135+
description: Previous priority level
33136+
example: "none"
3312933137
conversation_sla_applied_by_rule:
3313033138
title: Part type - conversation_sla_applied_by_rule
3313133139
type: object

0 commit comments

Comments
 (0)