set_space_activate() — Fast Ref API Reference

Toggles the Space Activate (namespace) ON/OFF for the specified slot. Controls whether namespace prefixes are applied to node, SelectionSet, and layer names.

Signature

api.set_space_activate(slot: int, on: bool) -> dict

Parameters

Parameter	Type	Description
`slot`	`int`	Slot number (0-9)
`on`	`bool`	`True` = namespace ON, `False` = OFF

Return Value

{"success": bool, "message": str}

Errors

Error	Cause
`TypeError`	slot is not int (including bool) [v2 added]
`ValueError`	Slot is invalid or empty

Example

from os_fast_ref.api import FastRefAPI

api = FastRefAPI()

# Namespace OFF (e.g. before FBX export)
api.set_space_activate(slot=0, on=False)

# Turn ON again
api.set_space_activate(slot=0, on=True)

Note: When toggling OFF on multiple references at once, node suffix (.r1, .r2, etc.) collisions may occur. Always toggle references one at a time if consistent naming is required.