Built by Metorial, the integration platform for agentic AI.
Retrieve details and statistics for a specific collection, including file counts, chunk counts, character counts, and indexing status breakdown.
List all document collections accessible to the authenticated user. Returns each collection's name, ID, creation date, and search query count.
List files in a collection with pagination support. Returns file metadata including name, size, content type, and indexing status.
Permanently delete a collection and all its indexed files. This action cannot be undone.
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.
Retrieve collection indexing statistics, including file counts, byte sizes, indexed chunks, characters, and users. Unknown byte sizes are returned as null.
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.
List files synchronized by a data source connector, including file IDs, source URLs, sizes, and timestamps. Use offset to retrieve another page.
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.
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.
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.
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.
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.