Sign in

v28

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-07-082940159.9 KB
Feedback Records

Get similar feedback records

Returns feedback record IDs and similarity scores for records similar to the given one (by embedding). Only available when embeddings are configured (EMBEDDING_PROVIDER and EMBEDDING_MODEL set). Supported providers: openai, google (Gemini Developer API / Google AI Studio), google-gemini (Gemini Enterprise Agent Platform API). When embeddings are disabled, this endpoint returns 503 Service Unavailable. Hub derives the tenant from the source feedback record and scopes the nearest-neighbor search to that tenant.

get/v1/feedback-records/{id}/similar

Path parameters

idstring uuid required
Example:018e1234-5678-9abc-def0-123456789abc

Feedback record ID (UUID)

Query parameters

limitinteger

Number of results to return (default 10, max 100). Consistent with list endpoints.

cursorstring
Example:eyJkIjowLjEsImkiOiIwMThlMTIzNC01Njc4LTlhYmMtZGVmMC0xMTExMTExMTExMTEifQ==

Omit for the first page. For the next page, use the exact value from the previous response's next_cursor. Opaque (base64-encoded); keyset pagination.

min_scorenumber float

Minimum similarity score (0..1); only results with score >= min_score are returned. Default 0.7 to reduce noise.

Response

OK

limitinteger required

Limit used in query (echoed for consistency with list endpoints)

next_cursorstring

Opaque cursor for the next page (keyset paging). Present only when there may be more results (full page returned). Omit when no next page. Use this exact value as the cursor query param for the next page.

Example response

{
  "next_cursor": "eyJkIjowLjEsImkiOiIwMThlMTIzNC01Njc4LTlhYmMtZGVmMC0xMTExMTExMTExMTEifQ=="
}