Tools

Get File Upload URL

Generate signed upload URLs for uploading local or private files to Needle. After uploading a file to the signed URL, use the returned reference URL when adding the file to a collection.

List Collection Files

List files in a collection with pagination support. Returns file metadata including name, size, content type, and indexing status.

Delete Collection

Permanently delete a collection and all its indexed files. This action cannot be undone.

List Collections

List all document collections accessible to the authenticated user. Returns each collection's name, ID, creation date, and search query count.

List Connectors

List all configured data source connectors. Connectors automatically sync and index content from external sources like Google Drive, SharePoint, Notion, Slack, and others into collections.

Get Collection

Retrieve details and statistics for a specific collection, including file counts, chunk counts, character counts, and indexing status breakdown.

Create Collection

Create a new document collection. The authenticated user will be the owner of the created collection. Collections are the primary organizational unit for indexing and searching documents.

Search Collection

Perform AI-powered semantic search across all documents in a collection. Needle automatically handles chunking, embedding, and reranking to return the most relevant text passages for the given query.

Get File Download URL

Prepare a downloadable file and return its signed download URL. The URL is short-lived; request a new one if you need to use it later.

Delete Files from Collection

Remove one or more files from a collection by their file IDs. Files managed by connectors (e.g. Google Drive sync) cannot be manually deleted.

Add Files to Collection

Add one or more files to a collection by providing a URL for each file. URLs can be public or private file reference URLs obtained via the **Get File Upload URL** tool. Files are automatically indexed for semantic search after being added.

List Connector Files

List files synchronized by a data source connector, including file IDs, source URLs, sizes, and timestamps. Use offset to retrieve another page.

Get Collection Statistics

Retrieve collection indexing statistics, including file counts, byte sizes, indexed chunks, characters, and users. Unknown byte sizes are returned as null.