Vaquill AI · Schema

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.

LegalStatutesRegulationsLegal ResearchLawComplianceLegal TechGovernment DataMCPIndiaContracts

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.
View JSON Schema on GitHub

JSON Schema

vaquill-ai-upload-initiate-request-schema.json Raw ↑
{
  "$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.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/vaquill-ai-upload-initiate-request"
All schemas
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.