veryfront__download_url_to_project_uploadAccess
No external-service connection is required. Use a Veryfront credential with access to the requested resources. Call type: Can change resources.Arguments
| Field | Type | Required | Description and constraints |
|---|---|---|---|
project_reference | string | No | Project ID or slug |
url | string | Yes | HTTP(S) URL to download. Use signed/provider URLs when authorization is needed. Format: uri. |
file_path | string | Yes | Destination upload path (e.g., attachments/invoice.pdf). Raw JSON path; spaces, Unicode and literal percent characters are accepted. Do not URL-encode. |
headers | object | No | Optional request headers, for example Authorization for signed/provider download endpoints. Hop-by-hop headers are rejected. |
content_type | string | No | Override MIME type. Defaults to the response Content-Type header or application/octet-stream. Minimum length: 1. |
expected_size | integer | No | Optional exact byte size guard. The tool fails if downloaded bytes do not match. |
max_bytes | integer | No | Optional download size limit in bytes. Defaults to 104857600 and is capped at 536870912. Maximum: 536870912. |
Example request
Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.request.json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "veryfront__download_url_to_project_upload",
"arguments": {
"url": "https://example.com",
"file_path": "example"
}
}
}
Result
The published output shape is summarized below. Inspect both the MCP response content andisError when handling a call.
| Field | Type | Required | Description and constraints |
|---|---|---|---|
upload_id | string | Yes | Persisted upload UUID. Format: uuid. |
file_path | string | Yes | Storage path including the project id prefix. Prefer path when chaining upload tools. create_upload_signed_url also accepts this legacy value within the same project. |
path | string | Yes | Path relative to the project root, without the project id. Pass this path value to create_upload_signed_url and to upload tools taking a file_path input. |
file_name | string | Yes | Filename from the stored project-relative path. |
content_type | string | Yes | Effective stored MIME type; application/octet-stream when unavailable. Minimum length: 1. |
size | integer | Yes | Actual stored byte size, including zero. Reused uploads retain their stored size; fresh downloads obey the tool byte limit. Minimum: 0. Maximum: 9007199254740991. |
status | string | Yes | Persisted upload status returned by the storage record, normally active. |
Full schemas
{
"type": "object",
"properties": {
"project_reference": {
"type": "string",
"description": "Project ID or slug"
},
"url": {
"type": "string",
"format": "uri",
"description": "HTTP(S) URL to download. Use signed/provider URLs when authorization is needed."
},
"file_path": {
"type": "string",
"description": "Destination upload path (e.g., attachments/invoice.pdf). Raw JSON path; spaces, Unicode and literal percent characters are accepted. Do not URL-encode."
},
"headers": {
"type": "object",
"additionalProperties": {
"type": "string",
"description": "Additional structured values supplied to the tool."
},
"description": "Optional request headers, for example Authorization for signed/provider download endpoints. Hop-by-hop headers are rejected."
},
"content_type": {
"type": "string",
"minLength": 1,
"description": "Override MIME type. Defaults to the response Content-Type header or application/octet-stream."
},
"expected_size": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "Optional exact byte size guard. The tool fails if downloaded bytes do not match."
},
"max_bytes": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 536870912,
"description": "Optional download size limit in bytes. Defaults to 104857600 and is capped at 536870912."
}
},
"required": [
"url",
"file_path"
],
"additionalProperties": false,
"description": "Arguments for the download_url_to_project_upload tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
{
"type": "object",
"properties": {
"upload_id": {
"type": "string",
"format": "uuid",
"description": "Persisted upload UUID."
},
"file_path": {
"type": "string",
"description": "Storage path including the project id prefix. Prefer `path` when chaining upload tools. `create_upload_signed_url` also accepts this legacy value within the same project."
},
"path": {
"type": "string",
"description": "Path relative to the project root, without the project id. Pass this `path` value to `create_upload_signed_url` and to upload tools taking a `file_path` input."
},
"file_name": {
"type": "string",
"description": "Filename from the stored project-relative path."
},
"content_type": {
"type": "string",
"minLength": 1,
"description": "Effective stored MIME type; application/octet-stream when unavailable."
},
"size": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Actual stored byte size, including zero. Reused uploads retain their stored size; fresh downloads obey the tool byte limit."
},
"status": {
"type": "string",
"description": "Persisted upload status returned by the storage record, normally active."
}
},
"required": [
"upload_id",
"file_path",
"path",
"file_name",
"content_type",
"size",
"status"
],
"additionalProperties": false,
"description": "Structured download url to project upload output schema for MCP tools.",
"$schema": "http://json-schema.org/draft-07/schema#"
}