POST Remote Launch¶
-
POST
/remotes/launch
¶ Uses an existing remote session to submit a command. The session must have been created successfully using
POST /remotes
.Request JSON Object: - sid (string) – Unique remote session identifier.
- command (string) – command to be ran on the remote system.
Status Codes: - 200 OK – The response contains the command, its output and possible errors.
- 400 Bad Request – The request failed due to invalid parameters or a Slycat agent issue.
- 500 Internal Server Error – The request failed due to a SSH exception.
Response Headers: - Content-Type – application/json
- X-Slycat-Message – For errors, contains a human-readable description of the problem.
Response JSON Object: - command (string) – Command issued to the remote system.
- output (string) – Output of the command.
- errors (string) – Error information, if any.
Sample Request
POST /remotes/launch { sid: "505d0e463d5ed4a32bb6b0fe9a000d36", command: "echo test" }
Sample Response
{ "command": "echo test", "output": "test", "errors": "" }