Start a resumable upload

Before you call

Credential

Authorization: Bearer $KEY

Scope

files:write

Graphql

Mutation.filesUploadBegin

Sdk

files.upload.begin

Cli

files upload begin

Request bodyapplication/json, required

• namestring
  At most 300 characters.
• bytesintegerrequired
  At least 1.
• sha256string
  Pattern: ^[a-fA-F0-9]{64}$.
• assetIdstring (uuid)
• partBytesinteger
• notestring
  At most 300 characters.
• grantobject
  • minutesinteger
    At least 1. At most 60.
• kindstring
  One of: logo, mark, lockup, wordmark, favicon, palette, typography, guideline, voice, imagery, persona_sheet, avatar, template, font, document, video, audio, image, other.
• descriptionstring
  At most 2000 characters.
• altTextstring
  At most 1500 characters.
• tagslist of string
• licenceobject or null
• rightsExpiresAtstring (date-time) or null
• aiobject or null
• disclosureLinestring
  At most 400 characters.
• provenanceobject
  • originPathstring
    At most 500 characters.
  • sourceRefstring
    At most 500 characters.
  • sourceUrlstring (uri)
    At most 1000 characters.
  • importedFromstring
    At most 200 characters.
  • notestring
    At most 500 characters.

Responses

• 201application/json
  Success

  object

• 400application/json
  The request was malformed
  • errorstringrequired
  • messagestring
• 401application/json
  No valid credential
  • errorstringrequired
  • messagestring
• 403application/json
  The credential lacks the scope, origin or address
  • errorstringrequired
  • messagestring
• 429application/json
  Over the key's rate limit; see Retry-After
  • errorstringrequired
  • messagestring