6.Attachments

6.Attachments

Note

Attachment endpoints are only available in Akeeba Ticket System Professional. They require both the "Web Services - Akeeba Ticket System" plugin and an active Pro licence.

Attachment resources represent files uploaded to ticket posts. Attachments can be accessed through the nested route under a specific post (/v1/ats/posts/:post_id/attachments) or through the standalone collection (/v1/ats/attachments). A separate download endpoint streams the file bytes directly.

6.1.Attachment resource fields

id (integer)

Unique attachment ID.

post_id (integer)

ID of the post this attachment belongs to.

original_filename (string)

Original filename as supplied by the uploader. This is the name that will be sent in the Content-Disposition header when downloading the file.

mime_type (string)

MIME type of the uploaded file (e.g. image/png, application/pdf).

origin (string)

How the attachment was created. Always web for API uploads.

file_size (integer, item only)

Size of the uploaded file on disk, in bytes. Returned only by the single-resource endpoint (GET /v1/ats/attachments/:id), not by list endpoints. Returns 0 if the file cannot be found on disk.

created (string)

ISO 8601 date-time when the attachment was uploaded (UTC).

created_by (integer)

Joomla user ID of the user who uploaded the file.

created_by_info (object or null)

User information object for the uploader. See Section2.6, “User information objects”.

enabled (integer)

Publication state: 1 = published, 0 = unpublished.