Uploading a temporary file
Use this request to upload temporary files. Use this request to upload a file to Tracker first and then attach it when editing an issue, comment, or entity.
Request format
Before making a request, get permission to access the API.
To add a temporary file, use an HTTP POST
request:
POST /v2/attachments/
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth_token>
X-Org-ID: <organization ID>
Content-Type: multipart/form-data
<file>
Headers
-
Host
Address of the node that provides the API:https://api.tracker.yandex.net
-
Authorization
OAuth token in
OAuth <OAuth_token>
format, e.g.:OAuth 0c4181a7c2cf4521964a72ff********
-
X-Org-ID or X-Cloud-Org-ID
Organization ID. If you only have a Yandex Cloud Organization organization, use the
X-Cloud-Org-ID
header; if only Yandex 360 for Business or both organization types, useX-Org-ID
. -
Content-Type
Request body format. The required value is
multipart/form-data
.
Request parameters
Additional parameters
Parameter | Description | Data type |
---|---|---|
filename | New name that a file will be stored on the server under | String |
Request body parameters
Required parameters
Parameter | Description | Data type |
---|---|---|
<file> | Binary file up to 1024 Mb | File |
Response format
If the request is successful, the API returns a response with code 201 Created
.
The response body contains the parameters of the attached file in JSON format.
{
"self": "<file_address>",
"id": "<file_ID>",
"name": "<file_name>",
"content": "<file_download_address>",
"thumbnail": "<preview_download_address>",
"createdBy": {
"self": "<creator_address>",
"id": "<creator_username>",
"display": "<creator_name>"
},
"createdAt": "<file_upload_date_and_time>",
"mimetype": "<file_type>",
"size": <file_size>,
"metadata": {
"size": "<image_dimensions>"
}
}
Response parameters
Parameter | Description | Data type |
---|---|---|
self | Address of the API resource corresponding to the attached file | String |
id | File's unique ID. | String |
name | File name. | String |
content | Address of the resource to download the file from. | String |
thumbnail | Address of the resource to download the preview thumbnail from; available for image files only. | String |
createdBy | Object with information about the user who attached the file | Object |
createdAt | Date and time when the file is uploaded, in YYYY-MM-DDThh:mm:ss.sss±hhmm format |
String |
mimetype | File type, for example:
|
String |
size | File size in bytes. | Integer |
metadata | Object with file metadata | Object |
createdBy
object fields
Parameter | Description | Data type |
---|---|---|
self | Address of the resource corresponding to the user who uploaded the file | String |
id | Username of the user | String |
display | User's name (as in the interface) | String |
metadata
object fields
Parameter | Description | Data type |
---|---|---|
size | Image size in pixels | String |
If the request is processed incorrectly, the API returns a response with an error code:
- 400
- One or more request parameters have an invalid value.
- 404
- The requested object was not found. You may have specified an invalid object ID or key.