> ## 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.

# ResearchClient

# `synth_ai.research.client`

`SynthClient().research` namespace (alpha).

## Classes

### `ResearchClient` <sup><a href="https://github.com/synth-laboratories/synth-ai/blob/main/synth_ai/research/client.py#L18" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

Managed Research entrypoint on `SynthClient`.

Obtain via `SynthClient().research`. Namespaces cover projects, runs,
limits, secrets, and Factory Tag (`factories.tag`).

**Methods:**

#### `session` <sup><a href="https://github.com/synth-laboratories/synth-ai/blob/main/synth_ai/research/client.py#L60" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

```python theme={null}
session(self) -> ManagedResearchClient
```

Low-level session client (advanced integrations and eval harnesses only).

Prefer hero namespaces (`projects`, `runs`, `limits`) for new code.

#### `backing_client` <sup><a href="https://github.com/synth-laboratories/synth-ai/blob/main/synth_ai/research/client.py#L68" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

```python theme={null}
backing_client(self) -> ManagedResearchClient
```

Deprecated alias for :attr:`session`.

#### `factories` <sup><a href="https://github.com/synth-laboratories/synth-ai/blob/main/synth_ai/research/client.py#L78" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

```python theme={null}
factories(self) -> ResearchFactoriesAPI
```

Factory domain APIs (Tag at `factories.tag`).

#### `projects` <sup><a href="https://github.com/synth-laboratories/synth-ai/blob/main/synth_ai/research/client.py#L85" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

```python theme={null}
projects(self) -> ResearchProjectsAPI
```

Create and configure Managed Research projects.

#### `runs` <sup><a href="https://github.com/synth-laboratories/synth-ai/blob/main/synth_ai/research/client.py#L92" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

```python theme={null}
runs(self) -> ResearchRunsAPI
```

Launch runs and open run-scoped readout handles.

#### `limits` <sup><a href="https://github.com/synth-laboratories/synth-ai/blob/main/synth_ai/research/client.py#L99" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

```python theme={null}
limits(self) -> ResearchLimitsAPI
```

Read org limits and allowance before launching work.

#### `secrets` <sup><a href="https://github.com/synth-laboratories/synth-ai/blob/main/synth_ai/research/client.py#L106" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

```python theme={null}
secrets(self) -> ResearchSecretsAPI
```

Manage project secret refs for providers and repos.

#### `hosted_artifacts` <sup><a href="https://github.com/synth-laboratories/synth-ai/blob/main/synth_ai/research/client.py#L113" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

```python theme={null}
hosted_artifacts(self) -> ResearchHostedArtifactsAPI
```

Open Research hosted artifact operator API (read, promote, review).

#### `tag` <sup><a href="https://github.com/synth-laboratories/synth-ai/blob/main/synth_ai/research/client.py#L120" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

```python theme={null}
tag(self) -> TagAPI
```

Deprecated — use `factories.tag` instead.

#### `get_limits` <sup><a href="https://github.com/synth-laboratories/synth-ai/blob/main/synth_ai/research/client.py#L131" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

```python theme={null}
get_limits(self) -> dict[str, Any]
```

Deprecated — use `limits.get()` instead.

#### `close` <sup><a href="https://github.com/synth-laboratories/synth-ai/blob/main/synth_ai/research/client.py#L140" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>

```python theme={null}
close(self) -> None
```

Close the underlying HTTP session and cached namespace clients.
