upload_media
Upload local media files to receive dp:// references, enabling their use in survey descriptions for annotation tasks.
Instructions
Upload local media files (images, audio, video) and return dp:// references.
Use this BEFORE plan_survey / create_survey whenever the user wants a
survey over local files — annotators cannot reach file:// paths or local
disk, and the server rejects non-dp:// / non-https:// URLs.
After uploading, pass the returned dp:// refs verbatim in the plan_survey
description so the generated plan references the uploaded media. Example:
refs = upload_media(["/tmp/a.png", "/tmp/b.png"])
# → dp://media/abc123.png and dp://media/def456.png
plan_survey(
description="Compare design A (dp://media/abc123.png) against "
"design B (dp://media/def456.png). Target: UX designers.",
max_responses=10,
)Already-hosted public https:// URLs do NOT need uploading — you can reference them directly in the description.
Args: file_paths: List of absolute local paths to media files.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"file_paths": "<file_paths>"
},
"name": "upload_media"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_paths | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |