v4

OpenAPI 3.0.1Apache 2.02026-08-016169702.3 MB
Issue attachments

Get all metadata for an expanded attachment

Returns the metadata for the contents of an attachment, if it is an archive, and metadata for the attachment itself. For example, if the attachment is a ZIP archive, then information about the files in the archive is returned and metadata for the ZIP archive. Currently, only the ZIP archive format is supported.

Use this operation to retrieve data that is presented to the user, as this operation returns the metadata for the attachment itself, such as the attachment's ID and name. Otherwise, use Get contents metadata for an expanded attachment, which only returns the metadata for the attachment's contents.

This operation can be accessed anonymously.

Permissions required: For the issue containing the attachment:

  • Browse projects project permission for the project that the issue is in.
  • If issue-level security is configured, issue-level security permission to view the issue.
  • If attachments are added in private comments, the comment-level restriction will be applied.
get/rest/api/3/attachment/{id}/expand/human

Path parameters

idstring required

The ID of the attachment.

Response

Returned if the request is successful. If an empty list is returned in the response, the attachment is empty, corrupt, or not an archive.

idinteger

The ID of the attachment.

mediaTypestring

The MIME type of the attachment.

namestring

The name of the archive file.

totalEntryCountinteger

The number of items included in the archive.