Create a support attachment before the ticket exists

POST https://api.suger.cloud/org/{orgId}/support/attachment

Stores a file against the organization, with no ticket, for an image pasted while a ticket is still being written. Requires inline=true — there is no ticket to post a timeline comment on — and returns the URL to reference the file by, which belongs in the description the caller is about to submit. GitHub backend only. Only images can be attached: PNG, JPEG, GIF or WebP, judged by the file's bytes, up to 10 MiB each.

Parameters

NameInTypeRequiredDescription
orgId path string yes Organization ID
inline query string yes Must be `true`

Request Body

Required. Content-Type: application/x-www-form-urlencoded, multipart/form-data · Schema: string

Responses

200 — OK

Content-Type: application/json

SupportTicketAttachment fields:

FieldTypeRequiredDescription
date string no
id string no
mimetype string no
size integer no
thumbnail_large string no
thumbnail_medium string no
thumbnail_small string no
title string no
url string no

400 — Bad request error

Content-Type: application/json

413 — A file is over 10 MiB

Content-Type: application/json

415 — A file is not a PNG, JPEG, GIF or WebP image

Content-Type: application/json

500 — Internal server error

Content-Type: application/json

503 — Attachment upload is not configured for this environment

Content-Type: application/json

Example

Generated from this operation's schema. Values are placeholders — substitute your own ids, and set SUGER_TOKEN to a bearer token from the OAuth client-credentials exchange.

Request

curl -X POST 'https://api.suger.cloud/org/{orgId}/support/attachment?inline={inline}' \
  -H "Authorization: Bearer $SUGER_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '"string"'

Response — 200

[
  {
    "date": "2026-01-31T12:00:00Z",
    "id": "01H0000000000000000000",
    "mimetype": "string",
    "size": 1,
    "thumbnail_large": "string",
    "thumbnail_medium": "string",
    "thumbnail_small": "string",
    "title": "string",
    "url": "https://example.com"
  }
]

Error — 400

"string"

View as Markdown · API reference overview

Spotted something wrong or out of date on this page? Tell us and we'll correct it.