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

Generate a signed download URL for a specific file. The URL can be used to download the file's content directly.

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 signed upload URLs obtained via the **Get File Upload URL** tool. Files are automatically indexed for semantic search after being added.