Attachments

Create an attachment

post

/attachments

Uploads a file as an attachment. The returned URL can be used when creating issues or messages. Files up to 100 MB (104,857,600 bytes) are supported. Larger files may be rejected and should be shared using an externally hosted link. This applies to direct uploads and files fetched through file_url. Downstream delivery channels may impose smaller limits.

Rate limit: 30 requests per minute

Authorizations

AuthorizationstringRequired

Authorization: Bearer

Body

descriptionstringOptional

The description of the file.

filestring · binaryOptional

The file to upload. Files up to 100 MB (104,857,600 bytes) are supported. Larger files may be rejected and should be shared using an externally hosted link.

file_urlstringOptional

The URL to fetch the file from, if the file is not provided. Fetched files up to 100 MB (104,857,600 bytes) are supported. Larger files may be rejected and should be shared using an externally hosted link.

Responses

200Success

application/json

request_idstringOptional

The request ID for tracking.

400

The request was invalid or could not be completed.

application/json

403

The authenticated caller or organization is not allowed to access this endpoint or operation.

application/json

413

The uploaded file is too large.

application/json

500

An unexpected internal error occurred.

application/json

post/attachments

POST /attachments HTTP/1.1
Host: api.usepylon.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 56

{
  "description": "text",
  "file": "binary",
  "file_url": "text"
}

{
  "data": {
    "description": "text",
    "id": "text",
    "name": "text",
    "url": "text"
  },
  "request_id": "text"
}