Skip to content

Commit 10c4328

Browse files
Add qualified_id field to Reporting Data Export API schema (#366)
* Add qualified_id field to Reporting Data Export API schema Updates the Unstable OpenAPI spec to include the new qualified_id field for attribute disambiguation in the get_datasets response. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * fix: Update attribute_ids to require qualified_id format The public_id fallback has been removed from find_attribute, so attribute_ids must use qualified_id format (e.g., "standard.conversation_id") instead of plain public_id (e.g., "conversation_id"). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> * Revert attribute_ids example to use simple format Keep the description explaining qualified_id format, but revert the example back to plain attribute IDs since the endpoint accepts both formats. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 8780018 commit 10c4328

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

descriptions/0/api.intercom.io.yaml

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1520,6 +1520,7 @@ paths:
15201520
example: conversation
15211521
attribute_ids:
15221522
type: array
1523+
description: List of attribute identifiers to include in the export. Requires qualified_id format (e.g., "people.Brand", "standard.conversation_id"). Use the qualified_id returned from the get_datasets response.
15231524
items:
15241525
type: string
15251526
example: [conversation_id, conversation_started_at]
@@ -1740,7 +1741,12 @@ paths:
17401741
properties:
17411742
id:
17421743
type: string
1744+
description: The simple attribute identifier. Note that this may be ambiguous if the same name exists across different attribute types. Use qualified_id when calling the enqueue endpoint.
17431745
example: conversation_id
1746+
qualified_id:
1747+
type: string
1748+
description: A namespaced identifier that uniquely identifies the attribute across all types. Format is "prefix.name" (e.g., "people.Brand", "conversation.Brand"). Required when calling the enqueue endpoint.
1749+
example: conversation.conversation_id
17441750
name:
17451751
type: string
17461752
example: Conversation ID

0 commit comments

Comments
 (0)