> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usesynth.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# factory_handles
# `synth_ai.research.factory_handles`
Factory- and Effort-scoped handles for `client.research.factories`.
## Classes
### `ResearchEffortHandle`
Handle bound to one Effort id.
**Methods:**
#### `get`
```python theme={null}
get(self) -> Effort
```
Fetch the Effort. Backend route: `GET /smr/efforts/{effort_id}`.
#### `pause`
```python theme={null}
pause(self) -> Effort
```
Pause the Effort. Backend route: `PATCH /smr/efforts/{effort_id}`.
#### `resume`
```python theme={null}
resume(self) -> Effort
```
Resume the Effort. Backend route: `PATCH /smr/efforts/{effort_id}`.
### `ResearchFactoryEffortsAPI`
Efforts namespace scoped to one Factory.
**Methods:**
#### `list`
```python theme={null}
list(self) -> List[Effort]
```
List the Factory's Efforts.
Backend route: `GET /smr/factories/{factory_id}/efforts`.
#### `open`
```python theme={null}
open(self, effort_id: str) -> ResearchEffortHandle
```
Open a handle bound to one Effort id (no network call).
### `ResearchFactoryHandle`
Handle bound to one Factory id.
Lifecycle and wake methods delegate to the same session/facade bindings as
`client.research.factories`; the handle only fixes the `factory_id`.
**Methods:**
#### `efforts`
```python theme={null}
efforts(self) -> ResearchFactoryEffortsAPI
```
Efforts owned by this Factory.
#### `status`
```python theme={null}
status(self) -> FactoryStatus
```
Read the Factory workflow projection.
Backend route: `GET /smr/factories/{factory_id}/status`.
#### `pause`
```python theme={null}
pause(self) -> Factory
```
Pause the Factory. Backend route: `PATCH /smr/factories/{factory_id}`.
#### `resume`
```python theme={null}
resume(self) -> Factory
```
Resume the Factory. Backend route: `PATCH /smr/factories/{factory_id}`.
#### `archive`
```python theme={null}
archive(self) -> Factory
```
Archive the Factory. Backend route: `PATCH /smr/factories/{factory_id}`.
#### `usage`
```python theme={null}
usage(self) -> FactoryUsage
```
Read the factory usage aggregate.
Backend route: `GET /smr/factories/{factory_id}/usage`
(query `window`: `month_to_date` | `last_7_days`).
#### `events`
```python theme={null}
events(self) -> FactoryEventsPage
```
Read one newest-first page of durable factory events.
Backend route: `GET /smr/factories/{factory_id}/events`
(query `limit` 1-500, `cursor`).
#### `watch_status`
```python theme={null}
watch_status(self) -> Iterator[FactoryStatus]
```
Poll the status projection until idle or timeout.
Backend route: repeated `GET /smr/factories/{factory_id}/status`.
#### `preview_wake`
```python theme={null}
preview_wake(self) -> FactoryWakeDueResult
```
Preview due experiments without launching.
Backend route: `POST /smr/factories/{factory_id}/wake-due` (dry run).
#### `wake_due`
```python theme={null}
wake_due(self) -> FactoryWakeDueResult
```
Launch exactly the due experiments bound to a reviewed preview.
Backend route: `POST /smr/factories/{factory_id}/wake-due` (confirmed).