Attachments

An attachment is a file carried by a ticket or a comment. For fields and response details, see the API reference. Most of the time you do not need this command: --attach on tickets create and tickets comments create uploads and attaches a file in one step.

Upload a file

This command uploads one file and prints the signed_id that attaches it. Use this when the file has to be attached by a later call than the one that uploads it, such as a script that uploads once and reuses the id, or a request you build yourself against the API. The file is sent straight to storage rather than through the API.

neetodesk attachments upload ~/Downloads/report.pdf

Required arguments:

<file> - Path to the file to upload

This command takes no flags beyond the global ones.

Sample output (--json)

{
  "data": {
    "signed_id": "eyJfcmFpbHMiOnsiZGF0YSI6IjEyMyJ9fQ==",
    "filename": "report.pdf",
    "content_type": "application/pdf",
    "byte_size": 20481,
    "checksum": "Y2hlY2tzdW1leGFtcGxl",
    "upload_url": "https://neeto-desk.s3.amazonaws.com/3ieihu6erxcialumauhj1pqs07hr?X-Amz-Signature=...",
    "upload_headers": { "Content-Type": "application/pdf" }
  }
}

With --quiet, the command prints the payload without the envelope. Read signed_id from it, then attach it through the API:

SIGNED_ID=$(neetodesk attachments upload ~/Downloads/report.pdf --quiet \
  | python3 -c 'import json,sys; print(json.load(sys.stdin)["signed_id"])')

A signed_id is only accepted in the workspace that uploaded it, and a file that is never attached to anything is cleaned up automatically.

Getting started

Commands

Upload a file

​Upload a file

Upload a file