SPsparkvault
hd

Begin a file's upload into a reply

Changed on

Begin the upload of one file into the customer's own request. The file then goes to forge_url by the resumable transfer every SparkVault upload runs, and joins the request with the reply that names its attachment_id. For a request merged into another, the file goes to the request its merges lead to, where a reply on the merged request lands.

post/hd/desks/{desk_id}/tickets/{number}/attachments/initiate

Request

Path parameters

desk_idstring required

The desk, as its lookup answered it.

numberstring required

The request's number at the desk.

Headers

X-SV-Client'help-desk-portal' required

Names the portal. A request without it answers 400 CLIENT_HEADER_REQUIRED.

Request body

namestring required

The file's name, which alone decides whether a request takes the file and what type it is stored under. A request takes images (.jpg, .jpeg, .png, .gif, .webp, .heic, .heif, .bmp, .tif, .tiff, .avif), documents (.pdf, .docx, .xlsx, .pptx, .txt, .csv, .tsv, .log, .json) and recordings (.mp4, .mov, .webm, .m4a, .mp3, .wav), and no other file: a name must end in one of those extensions, in any case, and be one a file can be stored under (no path separator, control or direction character, none of :*?"<>|, not only dots or spaces). The file is stored, served and downloaded as the type its extension registers, whatever type the browser reports for it.

size_bytesinteger required

The file's size in bytes: the most the upload stores.

Response

The upload, begun.

Changes

  • a9a10e328ba5Revision changes
    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

  • 56d7c265a77aRevision changes
    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status