Skip to main content
POST
Execute PowerShell command

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 returning. Cyberdriver 1.0.2+ continues one-shot commands 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.