Skip to main content
Use client.Version to list versions on a model and pick the version id you pass to Receive3. Version.Create is the pre-2026.9 way to publish after Send2; new scripts publish with Send3, which creates the version for you. Guide: Build your first model analysis tool loads the latest version · Publish and load a model from C# publishes with Send3
After Send3 or SendPipeline, the server creates the version asynchronously — do not call Version.Create on those paths.

Methods

Task<Version> Get(string versionId, string projectId, CancellationToken cancellationToken = default)
Retrieves a version by id.
Task<ResourceCollection<Version>> GetVersions(string modelId, string projectId, int limit = 25, string? cursor = null, ModelVersionsFilter? filter = null, CancellationToken cancellationToken = default)
Lists versions of a model.
Task<Version> Create(CreateVersionInput input, CancellationToken cancellationToken = default)
Marked [Obsolete]. Creates a version pointing at an object sent with Send or Send2. The returned Version is a reservation: the version becomes queryable when the server finishes processing — see Publish through model ingestions. CreateVersionInput(string objectId, string modelId, string projectId, string? message = null, string? sourceApplication = ".net", int? totalChildrenCount = null, IReadOnlyList<string>? parents = null).
Task<Version> Update(UpdateVersionInput input, CancellationToken cancellationToken = default)
Updates a version’s message.
Task<string> MoveToModel(MoveVersionsInput input, CancellationToken cancellationToken = default)
Moves one or more versions to a different model. Returns the target model id. MoveVersionsInput(string projectId, string targetModelName, IReadOnlyList<string> versionIds) — note targetModelName takes the destination model’s name, not its id.
Task Delete(DeleteVersionsInput input, CancellationToken cancellationToken = default)
Deletes one or more versions.
Task Received(MarkReceivedVersionInput input, CancellationToken cancellationToken = default)
Marks a version as received by the current application, for telemetry/analytics purposes.

Usage (before 2026.9 publish path)

Example
On this obsolete path, Send or Send2 does not create a version by itself; client.Version.Create reserves one. Speckle does not guarantee this path for new work: publish with Send3. The SendPipeline path also creates the version on the server after WaitForUpload, so do not call Version.Create there.

FAQ

For Send and Send2, pass the id returned by the send operation — not a value from Base.GetId(), which is obsolete and may not match every send path. For SendPipeline, do not call Version.Create — the server creates the version after upload. See Publish large models (connectors).
Pass the version id with the project and model ids to IOperations.Receive3. See Build your first model analysis tool. For a version published before 2026.9 that Receive3 cannot load, pass referencedObject to Receive2.

Next Steps

Core concepts

Orphaned objects and version lifecycle

Build your first model analysis tool

Load latest version with Receive3

Operations API

Receive3 and Send3 entry points
Last modified on October 19, 2026