# Needle

Needle provides retrieval-augmented generation (RAG) tools that enable semantic search across your data, facilitating the development of AI agents and applications.

- **Category:** artificial intelligence
- **Auth:** API_KEY
- **Tools:** 7
- **Triggers:** 0
- **Slug:** `NEEDLE`
- **Version:** 20260211_00

## Tools

### Create Collection

**Slug:** `NEEDLE_CREATE_COLLECTION`

Tool to create a new collection. Use after confirming the collection name.

### Delete files from a collection

**Slug:** `NEEDLE_DELETE_FILES_FROM_COLLECTION`

Tool to delete files from a specific collection by providing file IDs. Use after confirming valid file IDs to remove from the collection.

### Get collection stats

**Slug:** `NEEDLE_GET_COLLECTION_STATS`

Tool to retrieve statistics for a specific collection by its ID. Use when you need document count, index size, and timestamps after confirming the collection exists.

### Get File Download URL

**Slug:** `NEEDLE_GET_FILE_DOWNLOAD_URL`

Tool to get a short-lived signed private download URL for a Needle file. Use when you need to retrieve file content but the public storage URL requires authentication. The returned URL should be used immediately as it expires quickly.

### List Collection Files

**Slug:** `NEEDLE_LIST_COLLECTION_FILES`

Tool to list all files within a specific collection by its ID. Use when you have a collection ID and need to retrieve its files. Supports pagination.

### List Collections

**Slug:** `NEEDLE_LIST_COLLECTIONS`

Tool to list collections. Use after authenticating with your API key to page through collections.

### Search Collection

**Slug:** `NEEDLE_SEARCH_COLLECTION`

Tool to perform semantic search within a specific Needle collection and return ranked results with source references. Use when you need to retrieve relevant content from a known collection using natural language queries.
