get_skin_bones() — Fast Ref API

Queries skin bone nodes in the given slot. Matches the right-click menu Skin Bones.

Signature

api.get_skin_bones(slot, select=0) -> dict

Parameters

Name	Type	Required	Description
`slot`	`int`	Yes	Slot number (0–9). bool/str/float → `TypeError`
`select`	`int` (0/1) or `bool`	No (default `0`)	`0`=query only, `1`=query then select in scene

Return Value

{
    "success": bool,
    "slot": int,
    "category": "skin_bones",
    "count": int,
    "handles": list,               # list[int], valid nodes only
    "names": list,                 # list[str], 1:1 with handles
    "selected": int,               # normalized select (0 or 1)
    "selected_count": int,
    "message": str,
}

Example

from os_fast_ref.api import FastRefAPI

api = FastRefAPI()

# Query only
r = api.get_skin_bones(slot=0)
print(f"bones: {r['count']}")

# Query + scene selection
api.get_skin_bones(slot=0, select=1)

Notes

An empty result (count=0) is not an error.
Invalid slot/select raises immediately (TypeError / ValueError).
See the Get Nodes overview page for the shared contract and exception table.