People

Person records

📄️ List user-type notes for a person

Returns all notes of type 'note' for the person, filtered by visibility for the current user. Private notes are only visible to the user who entered them.

📄️ Get a single note by ID

Returns the note if it is visible to the current user. Private notes are only visible to the user who entered them. Returns 404 for notes not visible to the current user.

📄️ Update a note's text and/or privacy

Only the note's author or an admin may update a note.

📄️ Delete a note

Deletes the note. Requires Notes permission. Only the note's author or an admin may delete it.

📄️ Get a person's uploaded photo

Returns the binary photo image. Returns 404 if no photo has been uploaded (use avatar endpoint for fallback).

📄️ Upload a person's photo (base64 encoded)

Upload a base64-encoded image file for a person. Supported formats: PNG, JPEG, JPG, GIF, WEBP. Maximum size: 10MB.

📄️ Delete a person's uploaded photo

Remove the uploaded photo for a person. This operation is idempotent and will return success even if no photo exists.

📄️ Get a person's avatar info (initials, gravatar)

Returns JSON with avatar metadata for client-side rendering. Always returns a result even if no photo is uploaded.

📄️ Get a person's full record by ID

Returns the complete person object including family info, addresses, and other related details.

📄️ Delete a person record

Permanently delete a person and all their associated records. Current user cannot delete their own account.

📄️ Add a person to the cart

Add a person to the current user's cart for batch operations.

📄️ Get people with no personal or work email on record

Get people with no personal or work email on record

📄️ Search persons by name or email

Search persons by name or email

📄️ List recently self-registered persons

Returns up to 100 persons who registered via the public self-registration form, newest first.

📄️ List all family roles

Returns all family role options (e.g. Head of Household, Spouse, Child) used when registering persons.

📄️ Find duplicate email addresses across persons and families

Find duplicate email addresses across persons and families

📄️ List the 10 most recently added persons

List the 10 most recently added persons

📄️ List the 10 most recently edited persons

List the 10 most recently edited persons

📄️ List persons with birthdays in a ±7-day window around today

List persons with birthdays in a ±7-day window around today

📄️ Get full timeline for a person

Returns all timeline items (notes and events) for a person, filtered by the current user's visibility permissions. Private notes are only visible to the user who entered them; admins see a placeholder.

📄️ Get full timeline for a family

Returns all timeline items (notes) for a family, filtered by the current user's visibility permissions. Private notes are only visible to the user who entered them; admins see a placeholder.