FruxonDocs
IntegrationsAssets

Runs a semantic or full-text search against a single asset's indexed documents

Executes a vector, full-text, or hybrid (RRF) query restricted to one asset and returns ranked chunks with scores. The asset must have completed at least one successful ingestion (`/operations` reports `Completed`) before results are meaningful. Primarily a debugging and tuning surface: agents at runtime issue cross-asset searches through the agent pipeline, not this endpoint. `VectorWeight`, `FtsWeight`, and `RrfK` are only consulted in hybrid mode; `ScoreThreshold` filters results post-ranking. Subject to per-tenant concurrency limits.

POST
/v1/tenants/{tenant}/assets/{asset}:search

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

asset*string

The RAG asset ID.

Formatuuid
tenant*string

The tenant identifier

Request Body

Search query and optional parameters.

query*string

The search query text.

Length1 <= length
topK?integer|null

Maximum number of results to return. Defaults to the service setting.

Formatint32
scoreThreshold?number|null

Minimum relevance score (0–1). Results below this threshold are excluded.

Formatdouble
searchMode?string
Value in"UNSPECIFIED" | "VECTOR" | "FULL_TEXT" | "HYBRID"
vectorWeight?number|null

Weight for vector (semantic) results in hybrid search (0–1). Only used when SearchMode is hybrid.

Formatdouble
ftsWeight?number|null

Weight for full-text search results in hybrid search (0–1). Only used when SearchMode is hybrid.

Formatdouble
rrfK?integer|null

Reciprocal Rank Fusion constant for hybrid search. Higher values dampen rank position effect.

Formatint32
[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08:search" \  -H "Content-Type: application/json" \  -d '{    "query": "string"  }'
{
  "results": [
    {
      "content": "string",
      "assetId": "00000000-0000-0000-0000-000000000000",
      "sourceType": "string",
      "chunkId": "00000000-0000-0000-0000-000000000000",
      "chunkIndex": 0,
      "source": "string",
      "sourceUrl": "string",
      "score": 0,
      "startCharIdx": 0,
      "endCharIdx": 0,
      "pageNumber": "string",
      "startLine": 0,
      "endLine": 0,
      "documentId": "00000000-0000-0000-0000-000000000000",
      "headingPath": "string",
      "contextText": "string",
      "totalChunks": 0,
      "windowChunks": [],
      "sourceLabel": "string",
      "codeIntel": {}
    }
  ],
  "totalResults": 0,
  "searchMode": "VECTOR"
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Regenerates the webhook URL for an asset with auto-update enabled

Rotates the webhook secret backing the asset's auto-update subscription: the previous URL stops accepting deliveries immediately. The new URL is returned only on this response, so capture it before navigating away. Only valid for assets created with auto-update enabled against a manual-registration provider; returns 400 otherwise. After rotation the user must reconfigure the source system to point at the new URL.

Lists available asset source types with their required and optional properties.

Returns the descriptors that drive asset creation: each entry lists the source type key (for example `google_drive`, `url`, `file`), its required and optional config parameters, and whether it supports OAuth. Use this to build the asset-creation form and to validate the `config` payload sent to `POST /assets`. Source types that report OAuth support must be authorized via `POST /assets:authorize` before creation.