Search
Base path: /api/v1/search. Server-side ILIKE search over members, notes (entries), and directories. Result rows include type (member | note | directory), id, label, optional subtitle, and dashboard href paths for deep links.
Authentication: search: read.
Search catalog (all items)
GET/api/v1/search/catalog
Returns every active member (non-archived), directory, and note for fuzzy matching on the client. Response can be large for big accounts: prefer scoped search endpoints when possible.
No query parameters allowed.
cURL
curl -sS \
-H "Authorization: Bearer YOUR_TOKEN" \
"https://api.floralitys.com/api/v1/search/catalog"Status codes
- 200: JSON array of search result objects
- 400: unknown query parameters
- 401 / 403: auth / scope
- 503: PRECONDITION_FAILED when Postgres is not configured
Unified search
GET/api/v1/search
Query q (optional; default empty string returns empty array). Optional limitPerType integer 1–50 per category (members, directories, notes). Unknown query keys return 400.
{
"type": "member",
"id": "uuid",
"label": "Display or legal name",
"subtitle": "Optional legal name when label is display",
"href": "/dashboard/members/{id}"
}cURL
curl -sS \
-H "Authorization: Bearer YOUR_TOKEN" \
"https://api.floralitys.com/api/v1/search?q=alex&limitPerType=10"Status codes
- 200: JSON array (members + directories + notes)
- 400: invalid parameters
- 401 / 403: auth / scope
- 503: database not configured
Search members
GET/api/v1/search/members: q, optional limit (1–50).
cURL
curl -sS \
-H "Authorization: Bearer YOUR_TOKEN" \
"https://api.floralitys.com/api/v1/search/members?q=tea&limit=20"Search notes
GET/api/v1/search/notes: same query shape as members.
Search groups (folders)
GET/api/v1/search/groups: same query shape as members. Result rows use type: "directory" for folder nodes (stable JSON after the groups merge).