Protocol Documentation

id is the unique identifier of the API key record.

name is a client-defined label for the API key.

key_prefix is the non-secret prefix used for lookup and display.

created_at is when the API key was created.

last_used is when the API key was most recently used.

data is the raw binary payload of the audio file.

mime_type is the audio media type, for example "audio/mpeg".

email is the account email used for authentication.

password is the plaintext password supplied for verification.

success indicates whether authentication succeeded.

user is set when authentication succeeds and user data is returned.

raw_key is only returned at creation time and should be stored securely.

user_id is the target user identifier.

content is the note body text to store.

tags are initial tag names to associate with the note.

images are image files to attach during note creation.

audios are audio files to attach during note creation.

user_id is the account to delete.

password is the account's current password; required unless called with M2M auth.

success is true when the account no longer exists.

user_id is the target user identifier.

id is the unique identifier of the note to delete.

user_id is the account to export.

user is the account profile and settings.

tag is one of the user's tags.

note is one note with its tags and media.

profile_image_url is a signed URL for the uploaded profile image.

user_id is the target user identifier.

id is the unique identifier of the note to fetch.

key is the storage object key returned in User.image.

user_id selects whose avatar to resolve. M2M callers that omit it must pass a "profiles/{userId}/..." key, whose owner segment is used. API key callers may only resolve their own.

user_id is the target user identifier.

count is the number of random notes requested.

user_id scopes stats to a single user. Empty returns global stats for M2M callers and the authenticated user's stats otherwise.

total_blips is the total number of notes.

unique_tags is the number of distinct tags.

words_written is the total word count across matching notes.

data is the raw binary payload of the image file.

mime_type is the image media type, for example "image/jpeg".

user_id is the target user identifier.

search is free-text search input and may include tag: filters.

tags are additional tag names to filter by.

start_date is an inclusive lower bound timestamp in ISO 8601 format.

end_date is an inclusive upper bound timestamp in ISO 8601 format.

limit is the maximum number of results to return.

offset is the number of results to skip before returning rows.

notes is the requested page of notes.

total is the total result count across all pages.

limit echoes the effective page size.

offset echoes the page offset.

user_id is the target user identifier.

id is the unique identifier of the note.

content is the note body text.

tags lists normalized tag names associated with the note.

created_at is when the note was created.

updated_at is when the note was last modified.

images lists image attachments associated with the note.

audios lists audio attachments associated with the note.

id is the unique identifier of the note audio attachment.

url is the publicly accessible URL for the stored audio object.

transcribed_text contains transcription output when available.

mime_type is the media type of the stored audio.

created_at is when the audio attachment was created.

id is the unique identifier of the note image.

url is the publicly accessible URL for the stored image object.

extracted_text contains OCR output for the image when available.

mime_type is the media type of the stored image.

created_at is when the image attachment was created.

email is the unique email for the new account.

password is the plaintext password supplied at registration.

id is the unique identifier of the tag.

name is the normalized tag name.

count is the number of notes currently using the tag.

created_at is when the tag was created.

user_id is the target user identifier.

id is the unique identifier of the note to update.

content updates the note body when provided.

tags is the tag list used when update_tags is true.

update_tags controls whether existing tags are replaced from tags.

add_images appends new image attachments to the note.

add_audios appends new audio attachments to the note.

Required when password is set; must match the stored password.

ai_enabled opts the user in or out of AI processing when set.

name is the customer's display name on the Stripe customer record.

billing_line1 is the first line of the billing address.

billing_line2 is the second line of the billing address.

billing_city is the city of the billing address.

billing_state is the state or region of the billing address.

billing_postal_code is the postal code of the billing address.

billing_country is the ISO-3166-1 alpha-2 country code.

Non-empty IDs are deduplicated globally across both Stripe update RPCs.

stripe_subscription_id sets the Stripe subscription resource id.

stripe_price_id sets the Stripe price id the user is subscribed to.

cancel_at_period_end sets whether the subscription will cancel at the end of the current billing period.

current_period_start sets the start of the current billing period.

Non-empty IDs are deduplicated globally across both Stripe update RPCs.

When non-empty, the update applies only if the user's stored Stripe customer id still equals this value, checked atomically with the write. On mismatch nothing is written, stripe_event_id is not recorded, and the RPC returns FAILED_PRECONDITION.

id is the unique identifier of the user.

email is the user's primary login email.

name is the user's display name when set.

image is the storage object key for the user's avatar. Resolve it to a URL via UserSettingsService.GetProfileImageURL — never use directly as an <img src>.

subscription_status is the billing tier, such as "free" or "pro".

subscription_end is when the current subscription period ends.

created_at is when the user account was created.

stripe_customer_id links the user to a Stripe customer record.

notion_key is write-only and is never populated in responses; see has_notion_key.

updated_at is when the user record was last updated.

disabled reports whether account access is currently disabled.

disabled_reason explains why the account is disabled when disabled is true.

notion_database_name is the Notion database used for sync.

stripe_subscription_id is the Stripe subscription resource id.

stripe_price_id is the Stripe price the user is currently subscribed to.

cancel_at_period_end reports whether the subscription will cancel at the end of the current billing period.

current_period_start is the start of the current billing period.

billing_line1 is the first line of the user's billing address.

billing_line2 is the second line of the user's billing address.

billing_city is the city of the user's billing address.

billing_state is the state or region of the user's billing address.

billing_postal_code is the postal code of the user's billing address.

billing_country is the ISO-3166-1 alpha-2 country code of the user's billing address.

has_notion_key reports whether a Notion API token is stored. The token itself is never returned.

ai_enabled reports whether the user opted in to AI processing such as tag generation, OCR, and audio transcription. Defaults to false.

billing_provider names the billing system that owns the user's subscription, such as "stripe" or "play". It is unset for users that have never subscribed.

purchase_token is the token returned by Google Play Billing for the purchase.

product_id is the Google Play subscription product id that was purchased.

user is the caller's account with its updated subscription state.