Skip to content

Document exact-second UTC timestamp filtering for contacts search on 2.17 - #733

Merged
adisan19 merged 2 commits into
mainfrom
adisanarula/contact-search-217-utc-docs
Oct 16, 2026
Merged

adisan19 merged 2 commits into
mainfrom
adisanarula/contact-search-217-utc-docs

Conversation

@adisan19

@adisan19 adisan19 commented Oct 16, 2026 •

Copy link
Copy Markdown
Contributor

Why?

In API version 2.17, contacts search filters standard timestamp fields on the exact UTC second and accepts !=, >= and <= on them, and Date custom attributes match by UTC calendar day. The 2.17 reference still describes the 2.16 behaviour of whole-day matching in the workspace timezone.

How?

Copies the Preview wording added in the PR below into the 2.17 search contacts description and the search operator description, for this change only.

Generated with Claude Code

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@geetikabagga geetikabagga left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

One gap: datetime is missing from the Data Attributes data_type enum. Everything else matches Preview.

  • Preview #627 has five hunks. This PR copies four of them: the three in the search description and the operator schema line, each identical to descriptions/0. The fifth adds - datetime to components.schemas.data_attribute.data_type.enum, and 2.17 still lists only string, integer, float, boolean, date.
  • 2.17 does return that value. GetDataAttributes only maps the standard timestamps back to date when ContactSearchDateUtcAnchor is inactive, and that change is in the 2.17 block. The new search text says so too ("These fields report a type of datetime on the Data Attributes endpoint"), and so does the 2.17 changelog. SDKs generated from this spec would reject datetime as an unknown enum value.
  • One more difference from Preview is owner_id (Integer in Preview, String here). It's unrelated: it comes from #314, which predates this change. Leaving it as it is here is correct.

Add - datetime after - date in the data_attribute enum and this is good to go.

~ Automated via Claude

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@adisan19
adisan19 marked this pull request as ready for review October 16, 2026 15:59
@adisan19

Copy link
Copy Markdown
Contributor Author

Added - datetime to the data_attribute.data_type enum in ef077bf, matching Preview. Thanks!

~ Automated via Claude

@adisan19
adisan19 merged commit 126ed68 into main Oct 16, 2026
4 checks passed
@adisan19
adisan19 deleted the adisanarula/contact-search-217-utc-docs branch October 16, 2026 16:09
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