Skip to content
Sursa Developers

Objects

Upload

A multipart upload.

Fields

  • idstringrequired

    The upload ID (upl_ followed by 32 hex characters).

  • purposeUploadPurposerequired
  • filenamestringrequired

    The file name (without folders).

  • content_typestringrequired

    The declared content type; empty if not declared.

  • sizeinteger (int64)required

    The file size in bytes.

  • sha256string | nullrequired

    The SHA-256 of the file, declared at creation or at complete; null if not known yet.

  • statusUploadStatusrequired
  • part_sizeinteger (int64)required

    The size of each part except the last (from 5 to 100 MiB).

  • part_countintegerrequired

    The number of parts.

    ≥ 1, ≤ 1000

  • parts_receivedintegerrequired

    The number of received parts.

    ≥ 0

  • partsarray of UploadPartrequired

    The received parts by number (empty in the POST /v1/uploads response).

  • reject_reasonstring | nullrequired

    The rejection reason (rejected): checksum_mismatch, type_mismatch, unsupported_format, infected, scan_unavailable, unsafe_content. The enumeration may grow; null if not rejected.

  • reject_detailsobject | nullrequired

    Details of the rejection (the extension, the declared and detected format, checksums); null if not rejected.

  • created_atstring (date-time)required

    When the upload was created.

  • expires_atstring (date-time)required

    The deadline to complete the upload and, once it is ready, to use it.

  • completed_atstring (date-time) | nullrequired

    When the check finished (ready or rejected).

  • consumed_atstring (date-time) | nullrequired

    When the upload was used (by a card, an archive or an import).

Used by