---
title: "Upload a tool file"
method: POST
path: "/api/v1/w/{wId}/search/tools/upload"
tags: ["Search"]
---

# Upload a tool file

`POST /api/v1/w/{wId}/search/tools/upload`

Download and upload a file from a tool (MCP server) to Dust

## Path parameters

- `wId` string, required

## Request body

- object
  - `serverViewId` string, required — The MCP server view ID
  - `externalId` string, required — The external ID of the file in the tool
  - `conversationId` string — Optional conversation ID for context
  - `serverName` string — Optional name of the MCP server (e.g., "Notion", "GitHub")
  - `serverIcon` string — Optional icon identifier for the MCP server

## Response `200`

File uploaded successfully

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.net/dust-tt/apis/dust-api-documentation.md) · [All operations](https://skmtc.net/dust-tt/apis/dust-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dust-tt/dust-api-documentation/versions/5834d690c29d/schema)