create_file_upload
Get a one-time upload link for a file that is on YOUR machine (a PDF, image, spreadsheet, audio, archive, anything over ~3 MB), so you can put it into Dock without a public host. Returns a ready curl command: run it with your file path in place of <path to your file>; its JSON response has a url. Then call upload_file with that url (plus surface_slug and filename). The link accepts ONE upload of an allowed file type up to 100 MB (your plan's per-file cap still applies) and expires in 15 minutes. For a video surface use create_video_upload instead. Editor role required.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | The workspace slug (bare or org-prefixed). | |
| filename | Yes | The file's name, e.g. "q3-report.pdf". Its extension sets the type unless you pass `content_type`. | |
| content_type | No | Optional MIME type, e.g. application/pdf. Must be a type Dock accepts. |