Upload multipart file
Creates file metadata and returns multipart upload URLs. Requires filesAcl:WRITE. See Upload limits.
Authorizations
Access token issued by the CDF project's configured identity provider. Access token must be an OpenID Connect token, and the project must be configured to accept OpenID Connect tokens. Use a header key of 'Authorization' with a value of 'Bearer $accesstoken'. The token can be obtained through any flow supported by the identity provider.
Scopes
Query Parameters
If 'overwrite' is set to true, and the POST body content specifies a 'externalId' field, fields for the file found for externalId can be overwritten. The default setting is false.
If metadata is included in the request body, all of the original metadata will be overwritten. The actual file will be overwritten after a successful upload. If there is no successful upload, the current file contents will be kept.
File-Asset mappings only change if explicitly stated in the assetIds field of the POST json body. Do not set assetIds in request body if you want to keep the current file-asset mappings.
Body
Fields to be set for the file.
The content encoding used to compress the file contents. When set, the file contents must be compressed with the specified encoding before being uploaded through the returned upload URL(s). When the file is later downloaded through a download link, the response will include a 'Content-Encoding' header set to this value, and the client is responsible for decompressing the content accordingly.
gzip, br, deflate, identity, zstd, compress, x-gzip, x-compress