Skip to content

Robots_DeleteRobot

DELETE
/v1/accounts/{account}/robots/{robot}
curl --request DELETE \
--url https://junction-api.qualiastudios.dev/v1/accounts/example/robots/example \
--header 'X-API-Key: <X-API-Key>'

Deletes a robot. FAILED_PRECONDITION while it has a model and force is not set. Datasets that named it keep the dangling reference (shown as a removed robot); the uploads played on a robot are listed with Datasets.ListDatasets filter target_robot = "...". Deleting a gripper design clears Rig.gripper on every rig that points at it; the rigs using it are those Rigs.ListRigs returns with that gripper. Deleting a robot deletes the gripper it owns, files included. Deleting a gripper a robot owns removes that copy and its mount from its robot, as detaching it with SetRobotGripper does; the robot and other copies stay. A gripper a live dataset plays back with is FAILED_PRECONDITION to delete. Deleting a robot template needs no force and touches no rig: the rigs made from it keep their copy and lose source_template. Deleting a UMI rig is deleting a gripper; nothing makes it again.

account
required
string

The account id.

robot
required
string

The robot id.

force
boolean

Also delete its model.

OK

Default error response

Media type application/json
One of:
API error

A refusal from the API itself.

object
code
required

The gRPC code name in upper case, e.g. NOT_FOUND.

string
message
required
string
retryable
required

Whether the same call may succeed if retried.

boolean
details
required

Empty, except when a dataset copy or move is refused: then one google.rpc.ErrorInfo with the refusal’s reason code, its domain and, in metadata, the datasets it names.

Array<object>
object
Example generated
{
"code": "example",
"message": "example",
"retryable": true,
"details": [
{}
]
}