Skip to content

Clarify Tag applied_at/applied_by are only present in tagging operations#449

Merged
anubhav-intercom merged 2 commits intomainfrom
anubhavbohidar/clarify-tag-applied-fields
Apr 14, 2026
Merged

Clarify Tag applied_at/applied_by are only present in tagging operations#449
anubhav-intercom merged 2 commits intomainfrom
anubhavbohidar/clarify-tag-applied-fields

Conversation

@anubhav-intercom
Copy link
Copy Markdown
Contributor

Why?

Customers report confusion because the Tag schema on the docs page shows applied_at and applied_by fields, but these are absent from direct tag lookups (GET /tags, GET /tags/{id}). These fields are only populated when a tag is returned as part of a tagging operation on a contact, conversation, or ticket — the tag schema is used by attach/detach endpoints, while tag_basic (without these fields) is used by direct lookups.

How?

Updates the applied_at and applied_by descriptions in the tag component schema across all API versions to clarify they are context-dependent. No schema structure change — just improved descriptions.

Note: This change needs to be manually synced to intercom/developer-docs after merge (the OpenAPI specs are copied manually per the developer-docs README).

Generated with Claude Code

These fields are only present when a tag is returned as part of a
tagging operation (attach/detach/list on a contact/conversation/ticket).
They are not included in direct tag lookups (GET /tags, GET /tags/{id}).

Customers were confused because the Tag docs page showed these fields,
but GET /tags/{id} uses the tag_basic schema which excludes them.

Fixes intercom/intercom#283507

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@anubhav-intercom anubhav-intercom self-assigned this Apr 14, 2026
Copy link
Copy Markdown
Contributor

@ellicenelson ellicenelson left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Correct fix!

Nit: For consistency you could probably use the same short clarification for both descriptions

e.g."Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket." append on both applied_at and applied_by, instead of verbose "Only present when the tag is returned as part of a tagging operation on a contact, conversation, or ticket. Not included in direct tag lookups (GET /tags or GET /tags/{id})."

Both fields now use the same clarification suffix for consistency.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@anubhav-intercom anubhav-intercom merged commit 76db2fe into main Apr 14, 2026
3 checks passed
@anubhav-intercom anubhav-intercom deleted the anubhavbohidar/clarify-tag-applied-fields branch April 14, 2026 12:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants