Attach Files to an Issue

Get the list of issues in a target project.

The query request parameter lets us filter the list of issues by a search query. In this sample, we use the query to get only the issues that belong to the target project (NP).

For this particular example, to shorten the list of returned issues, we use $top=3 parameter to get only first three found issues.

In the fields request parameter, we instruct the server to return the following attributes for each issue found:

• id and idReadable - both database entity ID and an ID of the issue in the project, respectively.

• summary - issue's summary may help to identify the target issue.

In the response to this request, the server returns the following data:

Locate the ID of the target issue. In this case, let's take the issue NP-77 with the database ID 99-500.

To attach files to an issue, send a POST request with the file content to the following endpoint:

This endpoint expects file upload data in multipart/form-data format. Use this request pattern when you upload a file using multipart/form-data, for example with the cURL -F upload=@... option.

For this use case, we use the following cURL command:

Here are the key parts of this request:

• -F upload=@/Users/jetbrains/Downloads/youtrack.txt uploads a file as a multipart form field named upload.

• To attach multiple files in one request, repeat the -F upload=@... option for each file:

  -F upload=@/Users/jetbrains/Downloads/youtrack.txt \ -F upload=@/Users/jetbrains/Downloads/youtrack_new.jpeg

• The @ prefix tells cURL to read the file content from the local filesystem.

• Content-Type: multipart/form-data is the correct content type for this upload pattern.

In the response, the server returns the name and database entity ID of the attached files: