robots

Repo owner handle (username or org slug).

Repo slug.

The robot card.

Resource not found (or hidden from the caller).

State conflict (duplicate handle/slug, wrong repo kind, terminal job, ...).

Repo owner handle (username or org slug).

Repo slug.

Omit or null to store a card without one. When limits is given, every joint_order name must be one of its keys (422 otherwise).

UI2: the report lucen robot validate produced for exactly these files, stored verbatim beside the card. Omit or null to store none. The hub does not verify a mujoco record; it is shown as the publisher's report, dated.

UIV2-thumbs: both paths must already be files of this repo, with a .png, .jpg, .jpeg or .webp suffix (card.thumbnails, 422 otherwise); the hub never opens them. PUT is a full replace, so a card sent without it clears it. lucen robot publish renders thumbnail.png / thumbnail-dark.png and sends them.

Stored robot card.

Missing or invalid credentials.

Authenticated but not allowed (visibility, membership or scope).

Resource not found (or hidden from the caller).

State conflict (duplicate handle/slug, wrong repo kind, terminal job, ...).

Request failed validation.

Repo owner handle (username or org slug).

Repo slug.

The validation report (for a good card and a bad one alike).

Missing or invalid credentials.

Authenticated but not allowed (visibility, membership or scope).

Resource not found (or hidden from the caller).

State conflict (duplicate handle/slug, wrong repo kind, terminal job, ...).

Request failed validation.

A service this endpoint needs is not configured in this deployment (M0's boot guarantee: the API boots with zero secrets, and an endpoint that needs one says so instead of returning a stack trace).

owner/slug of the robot repo.

Page size.

Opaque cursor from the previous page's next_cursor.

A page of checks.

Missing or invalid credentials.

Request failed validation.

owner/slug of a robot repo the caller can write (required for a robot check) — or, for a model check, can read: the robot the policy is checked against; omitted, a model check only reads.

Required for kind: model, refused otherwise.

A robot check: the model file (required). A model check: the ONNX or checkpoint directory in model.repo (required unless model.hf_repo).

Required when entry is a URDF (.urdf): a URDF cannot say whether the base is bolted down. For an MJCF it is read from the model and this only asserts it.

The rate policies run at on the REAL robot (--control-hz). No model file says it. Required for a robot check.

Required for a robot check.

Null or absent — modal when this deployment has it and the hub may host the owner (HOSTED_OWNERS, or the hosted allowance), else worker.

Check queued.

Missing or invalid credentials.

Authenticated but not allowed (visibility, membership or scope).

Resource not found (or hidden from the caller).

State conflict (duplicate handle/slug, wrong repo kind, terminal job, ...).

Request failed validation.

This account's daily check quota is spent.

A service this endpoint needs is not configured in this deployment (M0's boot guarantee: the API boots with zero secrets, and an endpoint that needs one says so instead of returning a stack trace).

Hosted robot check id (rchk_...).

The check.

Missing or invalid credentials.

Resource not found (or hidden from the caller).

Hosted robot check id (rchk_...).

A name for the worker, recorded as claimed_by.

Claimed; the check with its sources.

Missing or invalid credentials.

Authenticated but not allowed (visibility, membership or scope).

Resource not found (or hidden from the caller).

State conflict (duplicate handle/slug, wrong repo kind, terminal job, ...).

Request failed validation.

Hosted robot check id (rchk_...).

One presigned PUT per requested artifact.

Missing or invalid credentials.

Authenticated but not allowed (visibility, membership or scope).

Resource not found (or hidden from the caller).

State conflict (duplicate handle/slug, wrong repo kind, terminal job, ...).

Request failed validation.

Hosted robot check id (rchk_...).

Output since the last report, ≤ 256 KiB of UTF-8.

Why the job broke; expected with status: failed.

The verdict, engine: mujoco — required with status: succeeded.

The artifacts uploaded through presignRobotCheckArtifacts, by name.

mujoco version, the worker's name.

A model check's findings (K2) — required with status: succeeded for kind: model.

Recorded; the check as it now stands.

Missing or invalid credentials.

Authenticated but not allowed (visibility, membership or scope).

Resource not found (or hidden from the caller).

State conflict (duplicate handle/slug, wrong repo kind, terminal job, ...).

A log chunk is over its size limit.

Request failed validation.

Hosted robot check id (rchk_...).

A model check only (K2): publish into this model repo instead of the draft — created for the caller when it does not exist (the caller must be able to create under that owner), 409 when it exists and holds files. The draft is left as it was.

A model check only (K2): after publishing, queue the smoke sim gate of the model on the checked robot, as the caller — CPU, under every rollout rule and the hosted allowance.

Published; the check with published filled in.

Missing or invalid credentials.

Authenticated but not allowed (visibility, membership or scope).

Resource not found (or hidden from the caller).

State conflict (duplicate handle/slug, wrong repo kind, terminal job, ...).

Request failed validation.

A service this endpoint needs is not configured in this deployment (M0's boot guarantee: the API boots with zero secrets, and an endpoint that needs one says so instead of returning a stack trace).

Hosted robot check id (rchk_...).

Canceled; the check as it now stands.

Missing or invalid credentials.

Authenticated but not allowed (visibility, membership or scope).

Resource not found (or hidden from the caller).

State conflict (duplicate handle/slug, wrong repo kind, terminal job, ...).

Modal refused to terminate the call; nothing changed.

Omit or null to store a card without one. When limits is given, every joint_order name must be one of its keys (422 otherwise).

UI2: the report lucen robot validate produced for exactly these files, stored verbatim beside the card. Omit or null to store none. The hub does not verify a mujoco record; it is shown as the publisher's report, dated.

UIV2-thumbs: both paths must already be files of this repo, with a .png, .jpg, .jpeg or .webp suffix (card.thumbnails, 422 otherwise); the hub never opens them. PUT is a full replace, so a card sent without it clears it. lucen robot publish renders thumbnail.png / thumbnail-dark.png and sends them.

True when no check failed.

The worst status among the checks that ran.

static from the hub (XML only); mujoco from lucen robot validate, which compiles the model and adds the dynamic checks.

What the card's interface hashes to (null without one, or if it is invalid).

owner/slug of a robot repo the caller can write (required for a robot check) — or, for a model check, can read: the robot the policy is checked against; omitted, a model check only reads.

Required for kind: model, refused otherwise.

A robot check: the model file (required). A model check: the ONNX or checkpoint directory in model.repo (required unless model.hf_repo).

Required when entry is a URDF (.urdf): a URDF cannot say whether the base is bolted down. For an MJCF it is read from the model and this only asserts it.

The rate policies run at on the REAL robot (--control-hz). No model file says it. Required for a robot check.

Required for a robot check.

Null or absent — modal when this deployment has it and the hub may host the owner (HOSTED_OWNERS, or the hosted allowance), else worker.

The robot — null for a model check that only reads (K2).

A model check's draft repo (K2); publishing writes there unless repo names another.

A model check's request, as given.

Null for a model check.

Null for a model check.

Files in the snapshot.

Their total size.

The snapshot, with presigned GETs — on the claim response only.

The last ≤ 64 KiB of the job's log.

Why Publish would be refused right now, one sentence each; empty means it would go through (the hub's static checks still run).

True for a modal check (billed at the robot_check function's CPU host, claim to finish); false for a worker check.

What a finished modal check cost; null until it finishes, and for worker.

A name for the worker, recorded as claimed_by.

Output since the last report, ≤ 256 KiB of UTF-8.

Why the job broke; expected with status: failed.

The verdict, engine: mujoco — required with status: succeeded.

The artifacts uploaded through presignRobotCheckArtifacts, by name.

mujoco version, the worker's name.

A model check's findings (K2) — required with status: succeeded for kind: model.

A model check only (K2): publish into this model repo instead of the draft — created for the caller when it does not exist (the caller must be able to create under that owner), 409 when it exists and holds files. The draft is left as it was.

A model check only (K2): after publishing, queue the smoke sim gate of the model on the checked robot, as the caller — CPU, under every rollout rule and the hosted allowance.

Named 1-DoF (hinge / slide) joints, in document order.

Repo paths the model needs — the MJCF, its includes and its assets.

owner/slug of the model repo (the draft) the caller can write.

Import instead of upload: a public Hugging Face LeRobot policy (config.json + model.safetensors), org/name[@revision].

For a policy whose manifest does not say: the layer to stamp (default reflex for an ONNX, skill for a LeRobot checkpoint).

--action-scale: action → joint units.

--action-clip.

--kp: PD stiffness for every joint.

--kd: PD damping for every joint.

--armature: reflected rotor inertia (kg·m²) for every joint.

--friction-loss: Coulomb friction (N·m) for every joint.

--proprioception: what the REAL robot can observe, snake_case terms.

--command: the command space.

--default-pose (P1): joint name → position (rad or m) of the pose policies start from — what the drop's "Default pose" field sends for a model with no keyframe, whose pose would otherwise be qpos0. A joint left out keeps the model's value; init refuses a name the model does not have, or a value outside the joint's range.

--discard-visual (URDF only): convert with collision geometry alone.

Entries kept (after the refused ones).

Files the hub already held (parts: []) — 0 bytes sent.

The ONNX path or checkpoint directory publishing writes.

onnx, lerobot or lerobot-peft.

onnx, or the LeRobot config's type (act, diffusion, …).

unchecked — no robot was named: the check only read the policy.

The policy was unstamped and this check derived its contract from the interface.

The fingerprint the (stamped) manifest records.

The robot's interface_fingerprint when checked.

The contract in one line (joints, observation, action, rate, chunk).

The policy's manifest as read (or as the check derived it).

An ONNX's graph widths, {input, output}.

Parameter count, from the weights' safetensors header.

Presigned 1-hour GET of exactly these bytes — on the claim response only.

robot_card.json without needs_you — exactly what Publish sends to putRobotCard.

How many needs_you entries are blocking; Publish is refused while > 0.

A file of the snapshot sits at this path; publishing replaces it.

Presigned 1-hour GET.

The smoke gate a model check's publish queued (smoke: true).

Why that gate could not be queued (the publish still stands).

Bytes (≤ 256 MiB; a single PUT).

image/png is the stills' (UIV2-thumbs).

Presigned PUT; send exactly size bytes with Content-Type as declared.

name, base, joints, actuators, mass_kg, physics_dt_s, default_pose_from.

For a URDF — the MJCF written, what the conversion dropped, meshes copied.

What the policy's contract says.

What the robot's interface derives.

The commit the import read (resolved from a branch or tag).

Files of the source repo left out, with why.

blocking refuses Publish; recommended and confirm never do.

deduped onto bytes the hub had already verified; copied and hashed by the hub.