Homepage

ValueUploadInput

Last edit: Oct 13, 2026

File to store in an upload property, created on the server from given content or
downloaded from a URL. The file is uploaded when the record or user is saved; an
error is returned when it cannot be downloaded or uploaded

type ValueUploadInput {
  acl: PropertyUploadACL
  cache_control: String
  content: String
  content_disposition: String
  content_type: String
  encryption: PropertyUploadEncryptionInput
  file_path: String
  remote_url: String
  synchronous: Boolean
  type: ValueUploadInputTypeEnum!
}

Fields

acl (PropertyUploadACL)

Access to the stored file; private files can be read only through signed URLs. Defaults to private

cache_control (String)

Cache-Control header for the file

content (String)

Content of the file; for pdf, the HTML to convert. Required unless remote_url is provided

content_disposition (String)

Content-Disposition header for the file, for example "attachment; filename=foo.bar;"

content_type (String)

Content-Type header for the file, for example "text/csv; charset=UTF-8"

encryption (PropertyUploadEncryptionInput)

Encrypts content with the given GPG public key before it is stored; a file downloaded from remote_url is not encrypted

file_path (String)

Path of the file within the property: files are stored under <table
name>/<property name>/<file_path> (user/<property name>/<file_path> for
users). Defaults to <uuid>/<property name> (for image, <uuid>/<file name from
remote_url>). Use a unique path per record, otherwise existing files are overwritten

remote_url (String)

URL of an external file to download and store. Required unless content is provided; takes precedence over content

synchronous (Boolean)

When true, the mutation waits (up to about one second) until the stored file
is available before returning, so it can be read right away

type (ValueUploadInputTypeEnum)

Type of the upload. For image, versions are generated based on the property configuration

Questions?

We are always happy to help with any questions you may have.

contact us