UploadInitiateRequest
Ask for somewhere to put a file. `sizeBytes` is required and is not advisory: it decides the part size and the part count, both of which are fixed for the life of the session. R2 cannot be asked to assemble parts it was not told to expect, so a size that turns out to be wrong fails at complete time rather than corrupting a document.
Properties
| Name | Type | Description |
|---|---|---|
| matterId | string | `mat_` identifier of the matter to upload into. Must belong to your organization. |
| filename | string | Filename to store, including its extension. Trimmed; whitespace alone is refused. This exact string is used to build the stored object, so it cannot be changed afterwards. |
| contentType | string | IANA media type of the file, for example `application/pdf`. Must be on the supported list or the request is refused before any URL is signed. |
| sizeBytes | integer | Exact size of the file in bytes. Not advisory: it fixes the part size and part count for the life of the session, and a wrong value fails at complete time. Must be greater than zero. |
| folderId | object | `fld_` identifier to file the document under on the way in. Saves a second call. Must belong to your organization. |
| handwritten | boolean | Set true for scanned or handwritten pages to route the file through vision OCR instead of the text-layer reader. Leaving it false on a scanned exhibit ingests it badly. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/vaquill-ai/json-schema/vaquill-ai-upload-initiate-request-schema.json",
"title": "UploadInitiateRequest",
"description": "Ask for somewhere to put a file.\n\n`sizeBytes` is required and is not advisory: it decides the part size and\nthe part count, both of which are fixed for the life of the session. R2\ncannot be asked to assemble parts it was not told to expect, so a size that\nturns out to be wrong fails at complete time rather than corrupting a\ndocument.",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/vaquill-ai-uploads-api-openapi.yml#/components/schemas/UploadInitiateRequest",
"properties": {
"matterId": {
"type": "string",
"title": "Matterid",
"description": "`mat_` identifier of the matter to upload into. Must belong to your organization."
},
"filename": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"title": "Filename",
"description": "Filename to store, including its extension. Trimmed; whitespace alone is refused. This exact string is used to build the stored object, so it cannot be changed afterwards."
},
"contentType": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"title": "Contenttype",
"description": "IANA media type of the file, for example `application/pdf`. Must be on the supported list or the request is refused before any URL is signed."
},
"sizeBytes": {
"type": "integer",
"maximum": 2147483648.0,
"exclusiveMinimum": 0.0,
"title": "Sizebytes",
"description": "Exact size of the file in bytes. Not advisory: it fixes the part size and part count for the life of the session, and a wrong value fails at complete time. Must be greater than zero."
},
"folderId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Folderid",
"description": "`fld_` identifier to file the document under on the way in. Saves a second call. Must belong to your organization."
},
"handwritten": {
"type": "boolean",
"title": "Handwritten",
"description": "Set true for scanned or handwritten pages to route the file through vision OCR instead of the text-layer reader. Leaving it false on a scanned exhibit ingests it badly.",
"default": false
}
},
"additionalProperties": false,
"type": "object",
"required": [
"matterId",
"filename",
"contentType",
"sizeBytes"
]
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
curl "https://apis.io/api/v1/json-schemas/vaquill-ai-upload-initiate-request"
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.