POST /api/v1/resources/upload
Access: General administrator, Tenant administrator, Tier 2 analyst, Tier 1 analyst.
User rights are not checked at the time of upload, instead they are checked at the time of import, when a tenant is already selected. Therefore, if the user account is not trusted, in the KUMA web interface, go to the Settings → Users section, select the user account, and in the Using KUMA via API section, select API access rights. This opens the API access rights window; in that window, clear the POST /resources/toc and POST /resources/upload check boxes.
Request body
Encrypted contents of the resource file in binary format.
Response
HTTP code: 200
Format: JSON
File ID. It should be specified in the body of requests for viewing the contents of the file and for importing resources.
|
Possible errors
HTTP code |
Description |
message field value |
details field value |
400 |
The file size exceeds the maximum allowable (64 MB) |
maximum file size is 64 MB |
|
403 |
The user does not have the required roles in any of the tenants |
access denied |
|
500 |
Any other internal errors |
variable |
variable |