> ## Documentation Index
> Fetch the complete documentation index at: https://docs.speckle.systems/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> These docs describe Speckle as it works today, including everything released in 2026.9. Treat page content as current unless the page or section says it applies only to versions published before 2026.9.
> Content scoped to versions published before 2026.9 (the object graph and root object, Proxies, Receive2, operations.receive, object.children) applies only to model versions in that earlier data format. For versions published in 2026.9, answer from the Object model pages and the SDK migration guides.
> The What's new pages summarise what changed in 2026.9 and link to the page that documents each change. Answer from the linked page rather than from the summary. Legacy (v2) connectors are retired; send questions about them to the community help forum.
> Match guidance to the customer's deployment, model data format, connector, plan and permissions. Self-hosted servers on a release before 2026.9 and compatibility-mode workflows follow the Compatibility mode page. If an unknown version or data format changes the answer, ask one focused question; do not infer the deployment version from the date alone.

# Transports

> ITransport for Send and Receive — use Receive3/Send3 instead for most scripts

> [!NOTE]
>
> Transports move `Base` object graphs and work only with versions published before 2026.9.
> Transport `Receive` throws when you pass a 2026.9 bundle reference. To load any version, use
> `Receive3` — see [Load and publish model
> data](https://docs.speckle.systems/developers/sdks/dotnet/concepts/send-and-receive-paths.md).

**Most AEC automation scripts should use `Receive3`/`Send3`** and skip transports entirely. Read this page only when you use **`IOperations.Send`** or **`Receive`** (Path B) — for example local-only `MemoryTransport`/`SQLiteTransport` workflows or existing transport-based code.

**Read next:** [Load and publish model data](https://docs.speckle.systems/developers/sdks/dotnet/concepts/send-and-receive-paths.md).

## ServerTransport

Sends and receives objects (and blobs) over HTTP to a Speckle Server project.

**IServerTransportFactory.Create** `ServerTransport Create(Account account, string streamId, int timeoutSeconds = 60, string? blobStorageFolder = null)`

Constructs a `ServerTransport`. Always use this factory — `ServerTransport`'s constructor has
DI-resolved dependencies (`ISpeckleHttp`, `ISdkActivityFactory`) that aren't convenient to supply
manually.

```csharp Example lines icon="https://mintcdn.com/speckle/VtRPWzmN-ULoLfIv/images/developers/sdks/csharp.svg?fit=max&auto=format&n=VtRPWzmN-ULoLfIv&q=85&s=f2970e3b8bd4a2c7899b46211a42f251" theme={null}
using var transport = provider.GetRequiredService<IServerTransportFactory>().Create(client.Account, project.id);
```

> [!NOTE]
>
> `streamId` here is the project id — a naming holdover from Speckle's v2 terminology.

## SQLiteTransport

A general-purpose local disk cache, used automatically as the default local cache when `useDefaultCache: true` is passed to `Send`/`Receive`.

**SQLiteTransport** `SQLiteTransport(string? basePath = null, string? applicationName = null, string? scope = null)`

Creates or opens a local SQLite database for caching objects. Defaults to a per-user application
data path.

```csharp Example lines icon="https://mintcdn.com/speckle/VtRPWzmN-ULoLfIv/images/developers/sdks/csharp.svg?fit=max&auto=format&n=VtRPWzmN-ULoLfIv&q=85&s=f2970e3b8bd4a2c7899b46211a42f251" theme={null}
using var localCache = new SQLiteTransport();
```

> [!NOTE]
>
> `SQLiteTransport2` is a related, per-project variant used internally as the default local cache
> alongside `ServerTransport` — you generally won't construct it directly.

## MemoryTransport

An in-memory, non-persistent transport. Fastest option; data is lost when the process ends.

**MemoryTransport** `MemoryTransport(ConcurrentDictionary\<string, string\>? objects = null, bool blobStorageEnabled = false, string? basePath = null, string? applicationName = null)`

Creates an in-memory object store. Useful for tests and short-lived scripts that don't need
persistence.

```csharp Example lines icon="https://mintcdn.com/speckle/VtRPWzmN-ULoLfIv/images/developers/sdks/csharp.svg?fit=max&auto=format&n=VtRPWzmN-ULoLfIv&q=85&s=f2970e3b8bd4a2c7899b46211a42f251" theme={null}
var transport = new MemoryTransport();
var (objectId, _) = await operations.Send(myData, transport, useDefaultCache: false);
```

## ITransport

All transports implement `ITransport`, which supports:

| Member | Purpose |
| - | - |
| `SaveObject` | Persist a serialized object string by id |
| `GetObject` | Retrieve a serialized object string by id |
| `CopyObjectAndChildren` | Copy an object and its closures into another transport |
| `OnProgressAction` | Progress reporting callback |
| `TransportName` | Human-readable name, used in diagnostics |

> [!NOTE]
>
> `IBlobCapableTransport` (implemented by `ServerTransport`, `SQLiteTransport`, and
> `MemoryTransport`) adds blob sidecar storage for binary attachments alongside object graphs.

## FAQ

> [accordion] Do I need a transport if I use Send3?
>
> No. `Receive3`/`Send3` (and `Receive2`/`Send2`) talk to the server directly. You still use
> transports for Path B (`Send`/`Receive`) and local-only workflows.

> [accordion] Why must ServerTransport come from IServerTransportFactory?
>
> Its constructor depends on `ISpeckleHttp` and other services registered by `AddSpeckleSdk`. The
> factory supplies those dependencies.

> [accordion] When should I use MemoryTransport vs SQLiteTransport?
>
> **MemoryTransport** for tests and ephemeral scripts. **SQLiteTransport** when you want a
> persistent local cache across runs or offline receive of previously fetched data.

## Next Steps

> [card] [Load and publish model data](https://docs.speckle.systems/developers/sdks/dotnet/concepts/send-and-receive-paths.md)
>
> When Path B needs a transport

> [card] [Migrate to 2026.9](https://docs.speckle.systems/developers/sdks/dotnet/migrate-to-2026-9.md)
>
> Move transport code to Receive3

> [card] [Operations](https://docs.speckle.systems/developers/sdks/dotnet/api-reference/operations.md)
>
> Send and Receive signatures


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.