--- title: "POST /v1/conveyor/control" method: POST path: "/v1/conveyor/control" tags: ["Carti"] --- # POST /v1/conveyor/control `POST /v1/conveyor/control` ## Request - Base URL: `https://api.bearrobotics.ai` - URL: `https://api.bearrobotics.ai/v1/conveyor/control` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Control conveyor motor operations for the specified conveyor indexes. This call allows manual control of conveyor motors for clockwise/counter-clockwise rotation or stop commands. This call will fail if: - Any specified conveyor index is not installed on the robot. - The robot is in an error state that prevents conveyor control. Notes: - Carti 100: CW = right, CCW = left (X-axis rotation) - Carti 600: CW = front→rear, CCW = rear→front (Y-axis rotation) ## Request body - ControlConveyorRequest: Request object for controlling conveyor operations - `robotId` string, required - `commands` ConveyorMotorCommand[], required: List of conveyor motor commands to execute - `index` integer, required: Target conveyor index to control - `command` integer, required: Motor command (stop, clockwise, or counter-clockwise). COMMAND_CONVEYOR_MOTOR_UNKNOWN (0) is not allowed. ## Response `200` OK - ControlConveyorResponse ## 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)