---
title: "POST /v1/system-command/run"
method: POST
path: "/v1/system-command/run"
tags: ["Robot System"]
---

# POST /v1/system-command/run

`POST /v1/system-command/run`

## Request

- Base URL: `https://api.bearrobotics.ai`
- URL: `https://api.bearrobotics.ai/v1/system-command/run`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bearrobotics/apis/bear-cloud-api/docs/v1/system-command/run/post.ts> (a function with typed inputs; its response is checked against the schema)

Execute a OS-level command on a robot.

 When rebooting the robot, a response will return immediately to acknowledge
 the request but may take several minutes before the robot reconnects.

## Request body

- RunSystemCommandRequest: Request object for running system commands
  - `robotId` string, required
  - `systemCommand` union, required
    - object
      - `reboot` object, required
        - `type` integer, required: Reboot type (e.g. software-only or full power-cycle). TYPE_UNKNOWN (0) is not allowed.
    - object
      - `shutdown` object, required

## Response `200`

OK

- RunSystemCommandResponse

## Other responses

- `400`: Bad Request, usually caused by malfored request body.
- `401`: Unauthorized credentials, ensure the JWT is correct and up to date.
- `500`: Internal Server Error
- `503`: Service is temporarily unavailable, which can usually be resolved by backoff retries.
- `504`: Server-side timeout, usually caused by the failure to send/receive commands/responses to the designated robot.

---

[API](https://skmtc.dev/bearrobotics/apis/bear-cloud-api.md) - [All operations](https://skmtc.dev/bearrobotics/apis/bear-cloud-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bearrobotics/apis/bear-cloud-api/revisions/b90843b624b5?raw)