Skip to content
Raindrop Developer Hub

Chunk Search

POST
/v1/chunk_search

Chunk Search provides search capabilities that serve as a complete drop-in replacement for traditional RAG pipelines. This system enables AI agents to leverage private data stored in Smart Buckets with zero additional configuration.

Each input query is processed by our AI agent to determine the best way to search the data. The system will then return the most relevant results from the data ranked by relevance on the input query.

Authorizations

Request Body required

object
input
required

Natural language query or question. Can include complex criteria and relationships

string
request_id
required

Client-provided search session identifier. We recommend using a UUID or ULID for this value.

string
bucket_ids

Optional list of specific bucket IDs to search in. If not provided, searches the latest version of all accessible buckets

Array<string>

Responses

200

Semantically relevant results with metadata and relevance scoring

object
results
required

Semantically relevant results with metadata and relevance scoring

Array<object>
object
chunk_signature
required

Unique identifier for this text segment

string
/^chunk_[a-zA-Z0-9]+$/ 
chunk_123abc
text

The actual content of the result

string
This is a sample text chunk
source

Source document information in JSON format

string
{"bucket": "my-bucket", "path": "doc.pdf", "type": "application/pdf"}
payload_signature

Parent document identifier

string
/^doc_[a-zA-Z0-9]+$/ 
doc_456def
score

Relevance score (0.0 to 1.0)

number format: double
<= 1 
0.95
type

Content MIME type

string
Allowed values: text/plain application/pdf image/jpeg image/png 
text/plain
[
  {
    "chunk_signature": "chunk_123abc",
    "text": "This is a sample text chunk",
    "source": "{\"bucket\": \"my-bucket\", \"path\": \"doc.pdf\"}",
    "payload_signature": "doc_456def",
    "score": 0.95,
    "type": "text/plain"
  }
]

400

Invalid request parameters

object
code
required

Error code

string
Allowed values: INVALID_ARGUMENT UNAUTHENTICATED PERMISSION_DENIED NOT_FOUND INTERNAL 
INVALID_ARGUMENT
message
required

Error message

string
Missing required parameter: input