Skip to main content
POST
/
v1
/
computer
/
{machine_id}
/
shell
/
powershell
/
exec
Execute PowerShell command
curl --request POST \
  --url https://api.cyberdesk.io/v1/computer/{machine_id}/shell/powershell/exec \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "command": "<string>",
  "same_session": true,
  "working_directory": "<string>",
  "session_id": "<string>",
  "timeout": 30
}
'
{}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Idempotency-Key
string

Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.

Example:

"550e8400-e29b-41d4-a716-446655440000"

Path Parameters

​
machine_id
string
required

Body

application/json
​
command
string
required

PowerShell command to execute

​
same_session
boolean
default:true

Use persistent session

​
working_directory
string | null

Working directory for new session

​
session_id
string | null

Session ID to use

​
timeout
number | null
default:30

Maximum time in seconds to wait for command completion before continuing. The command will continue running in the background after timeout (default: 30.0)

Response

Successful Response

The response is of type Response Powershell Exec V1 Computer Machine Id Shell Powershell Exec Post · object.