User Identity And Change Monitor Notifications
These resources model the authenticated Firetiger user, their typed linked external identities, and the Change Monitor notification preference used to send Slack DMs to PR authors.
User
User is Firetiger’s local projection of the authenticated Clerk user.
| Field | Type | Behavior | Description |
|---|---|---|---|
name |
string | OUTPUT_ONLY | Resource name (users/{user}) |
clerk_user_id |
string | OUTPUT_ONLY | Authenticated Clerk user identifier |
primary_email |
string | User’s primary email address | |
full_name |
string | User’s display name, when available | |
image_url |
string | User avatar URL, when available | |
create_time |
timestamp | OUTPUT_ONLY | When the user projection was created |
update_time |
timestamp | OUTPUT_ONLY | When the user projection was last modified |
delete_time |
timestamp | OUTPUT_ONLY | When the user projection was soft-deleted |
last_synced_at |
timestamp | OUTPUT_ONLY | When Firetiger last refreshed this projection |
ExternalIdentity
ExternalIdentity is Firetiger’s queryable projection of a verified external
account linked through Clerk.
| Field | Type | Behavior | Description |
|---|---|---|---|
name |
string | OUTPUT_ONLY | Resource name (external-identities/{external_identity}) |
user |
string | User resource that owns this identity | |
clerk_user_id |
string | OUTPUT_ONLY | Authenticated Clerk user identifier |
github |
GitHubIdentity | GitHub account payload. Mutually exclusive with slack. |
|
slack |
SlackIdentity | Slack account payload. Mutually exclusive with github. |
|
create_time |
timestamp | OUTPUT_ONLY | When the identity was created |
update_time |
timestamp | OUTPUT_ONLY | When the identity was last modified |
delete_time |
timestamp | OUTPUT_ONLY | When the identity was soft-deleted after unlinking |
last_synced_at |
timestamp | OUTPUT_ONLY | When Firetiger last refreshed this projection |
GitHubIdentity
GitHubIdentity is the typed payload for a linked GitHub account.
| Field | Type | Behavior | Description |
|---|---|---|---|
github_user_id |
string | Globally stable GitHub user ID | |
username |
string | GitHub username, when available | |
email |
string | Email address reported by GitHub |
SlackIdentity
SlackIdentity is the typed payload for a linked Slack account.
| Field | Type | Behavior | Description |
|---|---|---|---|
slack_user_id |
string | Slack user ID from the linked identity | |
username |
string | Slack username, when available | |
email |
string | Email address reported by Slack | |
workspace_id |
string | Slack workspace ID for the linked identity | |
workspace_name |
string | Slack workspace name for the linked identity |
ChangeMonitorNotificationPreference
ChangeMonitorNotificationPreference captures whether the caller has opted in
to Change Monitor notifications and where those notifications should be
delivered.
| Field | Type | Behavior | Description |
|---|---|---|---|
name |
string | OUTPUT_ONLY | Resource name (change-monitor-notification-preferences/{preference}) |
enabled |
boolean | Whether Change Monitor notifications are enabled | |
slack_dm |
ChangeMonitorSlackDMDestination | Verified Slack DM destination | |
create_time |
timestamp | OUTPUT_ONLY | When the preference was created |
update_time |
timestamp | OUTPUT_ONLY | When the preference was last modified |
delete_time |
timestamp | OUTPUT_ONLY | When the preference was soft-deleted |
ChangeMonitorSlackDMDestination
ChangeMonitorSlackDMDestination captures the verified Slack delivery target
for Change Monitor notifications.
| Field | Type | Behavior | Description |
|---|---|---|---|
external_identity |
string | Linked Slack ExternalIdentity that proves account ownership | |
slack_connection |
string | Slack Connection used for delivery |
ChangeMonitorNotificationSetupStatus
ChangeMonitorNotificationSetupStatus summarizes whether the authenticated
user has the linked identities and verified Slack DM destination needed for
Change Monitor notifications.
| Field | Type | Behavior | Description |
|---|---|---|---|
github_identity_linked |
boolean | Whether the user has linked a GitHub identity | |
slack_identity_linked |
boolean | Whether the user has linked a Slack identity | |
slack_dm_verified |
boolean | Whether the user has verified a Slack DM destination |