Skip to content

UID2-6932: Fix refresh_from data type in public docs #1011

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sophia-chen-ttd merged 1 commit into from
Apr 17, 2026
+6 −6
Merged

UID2-6932: Fix refresh_from data type in public docs #1011

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions docs/endpoints/post-identity-map.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -145,12 +145,12 @@ Response:
{
"u": "AdvIvSiaum0P5s3X/7X8h8sz+OhF2IG8DNbEnkWSbYM=",
"p": "EObwtHBUqDNZR33LNSMdtt5cafsYFuGmuY4ZLenlue4=",
"r": 1735689600000
"r": 1735689600
},
{
"u": "IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ=",
"p": null,
"r": 1735862400000
"r": 1735862400
},
{ "e": "invalid identifier" },
{ "e": "optout" }
Expand Down Expand Up @@ -181,7 +181,7 @@ For successfully mapped DII, the mapped object includes the properties shown in
|:---------|:-----------|:--------------------------------------------------------------------------------------------------------------------------------------|
| `u` | string | The raw UID2 corresponding to the email or phone number provided in the request. |
| `p` | string | One of the following:<ul><li>If the current raw UID2 was rotated in the last 90 days: the previous raw UID2.</li><li>Otherwise: `null`.</li></ul> |
| `r` | number | The Unix timestamp (in milliseconds) that indicates when the raw UID2 might be refreshed. The raw UID2 is valid until this timestamp. |
| `r` | number | The Unix timestamp (in seconds) that indicates when the raw UID2 might be refreshed. The raw UID2 is valid until this timestamp. |

:::note
The raw UID2 does not change before the refresh timestamp. After the refresh timestamp, remapping the DII returns a new refresh timestamp, but the raw UID2 might or might not change. It is possible for the raw UID2 to remain unchanged for multiple refresh intervals.
Expand Down Expand Up @@ -295,7 +295,7 @@ The following example shows an implementation of the v3 approach for checking re
import time

def is_refresh_needed(mapping):
now = int(time.time() * 1000) # Convert to milliseconds
now = int(time.time()) # Current time in seconds
return now >= mapping['refresh_from']

# Check individual mappings for refresh needs
Expand Down
4 changes: 2 additions & 2 deletions docs/guides/integration-snowflake.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -179,7 +179,7 @@ A successful query returns the following information for the specified DII.
|:---------------|:----------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `UID` | TEXT | The value is one of the following:<ul><li>DII was successfully mapped: The UID2 associated with the DII.</li><li>Otherwise: `NULL`.</li></ul> |
| `PREV_UID` | TEXT | The value is one of the following:<ul><li>DII was successfully mapped and the current raw UID2 was rotated in the last 90 days: the previous raw UID2.</li><li>Otherwise: `NULL`.</li></ul> |
| `REFRESH_FROM` | TIMESTAMP | The value is one of the following:<ul><li>DII was successfully mapped: The timestamp (in epoch seconds) indicating when this UID2 should be refreshed.</li><li>Otherwise: `NULL`.</li></ul> |
| `REFRESH_FROM` | NUMBER | The value is one of the following:<ul><li>DII was successfully mapped: The timestamp (in epoch seconds) indicating when this UID2 should be refreshed.</li><li>Otherwise: `NULL`.</li></ul> |
| `UNMAPPED` | TEXT | The value is one of the following:<ul><li>DII was successfully mapped: `NULL`.</li><li>Otherwise: The reason why the identifier was not mapped: `OPTOUT`, `INVALID IDENTIFIER`, or `INVALID INPUT TYPE`.<br/>For details, see [Values for the UNMAPPED Column](#values-for-the-unmapped-column).</li></ul> |

#### Values for the UNMAPPED Column
Expand Down Expand Up @@ -401,7 +401,7 @@ To determine which UID2s need regeneration, compare the current time to the `REF
| Column Name | Data Type | Description |
|:------------------|:--------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `UID` | TEXT | The UID2 associated with the DII. This is the current UID2 value returned by the identity mapping function. |
| `REFRESH_FROM` | TIMESTAMP | The timestamp (in epoch seconds) indicating when this UID2 should be refreshed. Compare this value to the current time to determine if regeneration is needed. |
| `REFRESH_FROM` | NUMBER | The timestamp (in epoch seconds) indicating when this UID2 should be refreshed. Compare this value to the current time to determine if regeneration is needed. |

The following example shows an input table and the query used to find the UID2s in the table that must be regenerated because their refresh time has been reached.

Expand Down
Loading