Upload files in one step

post

https://verify-automation-api.globalvision.co/files/upload

Endpoint to upload files without the need to use signed urls (max 1gb).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

fileName

string

required

The file name should contain the extension, valid extensions are .doc, .docx, .xls, .xlsx, .ppt, .pptx, .html, .ai, .xml, .png, .jpg, .jpeg, .pdf. Required for all upload types (raw binary, s3Url, and multipart/form-data); for multipart/form-data uploads the uploaded part's own filename is ignored.

usage

string

enum

What will the file be used for, valid options are inspection or checkai. If not provided, the file will be used for inspection. If checkai is selected, the file can only be used for checkai endpoints.

Allowed:

sha256

string

Optional lowercase hex SHA-256 of the file contents. When provided, the server verifies the uploaded bytes against it and rejects the request with a 400 on mismatch.

s3Url

uri

A pre-signed S3 URL pointing to the file to upload. When provided, the request body should be empty and the file will be fetched directly from S3. Must be an HTTPS URL.

Body Params

Headers

X-Org-Id

string

required

Provided by GlobalVision

Content-Length

integer

Size of the file in bytes. If omitted, send the body using chunked transfer encoding; an explicit Content-Length of 0 is rejected. When uploading as multipart/form-data this reflects the whole envelope and is not validated as the file size.

content-type

string

enum

Defaults to application/pdf

Generated from available request content types

Responses

200Successful operation

400Bad request. Returned when the request is invalid, for example when fileName is missing, the file extension is unsupported, sha256 does not match the uploaded bytes, or a multipart/form-data request contains no file part.