SPsparkvault
hd

Begin a file's upload into a draft

Changed on

Begin the upload of one file into one of the customer's own drafts, within its day. The file then goes to forge_url by the resumable transfer every SparkVault upload runs, and joins the request once the request is sent naming its attachment_id.

post/hd/desks/{desk_id}/drafts/{ticket_id}/attachments/initiate

Request

Path parameters

desk_idstring required

The desk, as its lookup answered it.

ticket_idstring required

The draft, as its opening answered it.

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