Obtaining the YARA file

Kaspersky Research Sandbox provides an API to obtain the YARA file of the specified task.

Request

Request method: GET

Endpoint: https://<server name>/api/v1/sandbox/tasks/<task ID>/yara

Parameters

Obtaining the YARA file parameters

Parameter	Data type	Occurrence	Description
`task_id`	string	Required	Object execution task ID (GUID).

cURL command sample:

$ curl --user <user name> --request GET 'https://<server name>/api/v1/sandbox/tasks/<task ID>/yara'

You will be asked to enter your password. The password is not displayed while you type it.

Responses

Endpoint returns the YARA file.

200 OK

YARA file obtained successfully.

400 Bad Request

Failed to obtain the YARA file due to incorrect query.

400 Bad Request response parameters

Parameter	Data type	Description
`code`	string	Error ID.
`message`	string	Error description.
`meta`	string	Additional information, if available.

Error examples:

Incorrect task_id parameter:

{"code":6,"message":"task not found"}

Incorrect task_id parameter format:

{"code":29,"message":"bad task id"}

401 Unauthorized

Failed to obtain the YARA file due to incorrect user credentials.

404 Not Found

The specified task was not found or does not have a YARA file.

500 Internal Server Error

Failed to obtain a YARA file due to an internal server error.