# Fast Ref API — Overview

---


---


---


---







@@block9b-ko
### Namespace Rename (v2.1 신규)
`set_namespace()`를 사용하면 대화상자 없이 레퍼런스의 네임스페이스를 변경할 수 있습니다. 파이프라인 스크립트에서 자동화된 이름 변경이 필요할 때 사용합니다.
```python
api.set_namespace(slot=0, namespace="Enemy_A")
```
- 중복 네임스페이스 사용 시 즉시 `ValueError` 발생.
- 이미 같은 이름이면 씬을 수정하지 않고 성공 반환 (no-op).

@@block9b-en
### Namespace Rename (v2.1 new)
`set_namespace()` renames a reference namespace without any dialog — ideal for automated pipeline scripts.
```python
api.set_namespace(slot=0, namespace="Enemy_A")
```
- Duplicate namespace raises `ValueError` immediately.
- If the name is unchanged, returns success without modifying the scene (no-op).

@@block9b-ja

@@block9b-zh

---


---

## Error Handling Rules

| Situation | Behavior |
| --- | --- |
| File does not exist | Raises `FileNotFoundError` |
| Invalid slot number / empty slot | Raises `ValueError` |
| slot is not int (including bool) | Raises `TypeError` [v2 new] |
| Non-existent FBX preset name | Raises `ValueError` [v2 new] |
| Invalid argument type | Raises `TypeError` |
| License authentication failure | Raises `PermissionError` during initialization |
| Operation failure (recoverable) | Returns `{"success": False, ...}` |