Skip to content

Fix conversation model assignee ID types to match API responses#453

Merged
VarshSuresh merged 2 commits intomainfrom
VarshSuresh/update-conversation-docs
Apr 16, 2026
Merged

Fix conversation model assignee ID types to match API responses#453
VarshSuresh merged 2 commits intomainfrom
VarshSuresh/update-conversation-docs

Conversation

@VarshSuresh
Copy link
Copy Markdown
Contributor

@VarshSuresh VarshSuresh commented Apr 15, 2026

Why?

Towards Dev Rel PQ

The conversations API (GET /:id, GET /all, POST /search) returns admin_assignee_id and team_assignee_id as integers. However, the docs had team_assignee_id typed as string and search tables listing both as String. The tickets API correctly returns these as strings and its docs are accurate, this PR consolidates the conversation model to match the actual API behavior.

How?

  • Updated team_assignee_id to integer type
  • fixed search table types from String to Integer, and
  • added alternating integer/zero example values in response examples — all scoped to the conversation model across every version (@2.7 through @Preview). Ticket model is intentionally unchanged.

Mirrors intercom/developer-docs#842.

Generated with Claude Code

Updated team_assignee_id to integer type, removed nullable: true,
changed descriptions from "return null" to "return 0", fixed search
table types from String to Integer, and added alternating integer/zero
example values in response examples — all scoped to the conversation
model across every version (2.7 through Preview). Ticket model is
intentionally unchanged.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@VarshSuresh VarshSuresh self-assigned this Apr 15, 2026
@VarshSuresh VarshSuresh requested a review from a team April 15, 2026 18:07
Restore nullable: true and null descriptions on conversation schemas,
use uniform example values (991267715/5017691), preserve original
admin_assignee_id where it was already an integer in the assign
endpoint examples.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@VarshSuresh VarshSuresh merged commit ac8ce3f into main Apr 16, 2026
3 checks passed
@VarshSuresh VarshSuresh deleted the VarshSuresh/update-conversation-docs branch April 16, 2026 14:47
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.

3 participants