Skip to main content
POST
/
v1
/
computer
/
{machine_id}
/
shell
/
powershell
/
session
Manage PowerShell session
curl --request POST \
  --url https://api.cyberdesk.io/v1/computer/{machine_id}/shell/powershell/session \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "action": "<string>",
  "session_id": "<string>"
}
'
{}

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
​
action
string
required

Action to perform - 'create' or 'destroy'

​
session_id
string | null

Session ID for destroy action

Response

Successful Response

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