Adsk.Platform.Tandem 0.3.14

Autodesk Tandem Digital Twin SDK for .NET

Unofficial package — not affiliated with or endorsed by Autodesk.

Namespace: Autodesk.Tandem | Target: net8.0 | License: MIT Generated from OpenAPI specs via Microsoft Kiota.

A type-safe C# SDK for the Autodesk Tandem Digital Twin REST APIs. Covers groups, twins (facilities), model data, streams/time series, documents, templates, and views — 31 methods across 8 service managers through a single unified client.

The SDK provides two access patterns:

1. Manager API (recommended) — high-level methods with strongly-typed parameters and XML doc comments linking to official APS docs.
2. Fluent URL API — mirrors the REST endpoint structure directly for full control over requests.

Installation

dotnet add package Adsk.Platform.Tandem
dotnet add package Adsk.Platform.Authentication

Quick Start

using Autodesk.Tandem;

var client = new TandemClient(() => Task.FromResult("YOUR_ACCESS_TOKEN"));

// Manager approach (recommended)
var groups = await client.GroupsManager.GetGroupsAsync();
var twin = await client.TwinsManager.GetTwinAsync("urn:adsk.dtt:...");

// Fluent URL approach — mirrors the REST path directly
var response = await client.Api.Tandem.V1.Groups.GetAsync();

Authentication with 2-Legged OAuth

For server-to-server communication, use the Adsk.Platform.Authentication package:

using Autodesk.Tandem;
using Autodesk.Authentication;
using Autodesk.Authentication.Helpers.Models;

var authClient = new AuthenticationClient();
var tokenStore = new InMemoryTokenStore();

var getAccessToken = authClient.Helper.CreateTwoLeggedAutoRefreshToken(
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET",
    scopes: new[] { "data:read", "data:write" },
    tokenStore);

var client = new TandemClient(getAccessToken);

Dependency Injection

using Autodesk.Common.HttpClientLibrary;
using Microsoft.Extensions.DependencyInjection;

builder.Services.AddAdskToolkitHttpClient("ApsClient");

// In your service:
public class MyService(IHttpClientFactory httpClientFactory)
{
    public TandemClient CreateClient(Func<Task<string>> getAccessToken)
    {
        var httpClient = httpClientFactory.CreateClient("ApsClient");
        return new TandemClient(getAccessToken, httpClient);
    }
}

Available Managers

Every manager is a property on TandemClient. All endpoints return Task<T?> or Task (this API has no paginated endpoints).

Usage Examples

List Groups and Get Twins

using Autodesk.Tandem;

var client = new TandemClient(getAccessToken);

var groups = await client.GroupsManager.GetGroupsAsync();
var twins = await client.TwinsManager.GetTwinsByGroupAsync("urn:adsk.dtg:...");

Scan Model Elements

using Autodesk.Tandem.Tandem.V1.Modeldata.Item.Scan;

var elements = await client.ModeldataManager.ScanElementsAsync(
    "urn:adsk.dtm:...",
    new ScanPostRequestBody { Families = new List<string> { "std" } });

Mutate Element Properties

using Autodesk.Tandem.Tandem.V1.Modeldata.Item.Mutate;

var result = await client.ModeldataManager.MutateElementsAsync(
    "urn:adsk.dtm:...",
    new MutatePostRequestBody());

Work with Time Series Data

// Get latest stream data
using Autodesk.Tandem.Tandem.V1.Timeseries.ModelsRequests.Item.Streams;

var latest = await client.StreamsManager.GetLatestStreamsDataAsync(
    "urn:adsk.dtm:...",
    new StreamsPostRequestBody { Keys = new List<string> { "streamKey1" } });

// Get historical data for a specific stream element
var history = await client.StreamsManager.GetStreamDataAsync(
    "urn:adsk.dtm:...",
    "elementId");

Manage Documents

using Autodesk.Tandem.Tandem.V1.Twins.Item.Documents;

var doc = await client.DocumentsManager.CreateDocumentAsync(
    "urn:adsk.dtt:...",
    new DocumentsPostRequestBody { Name = "floorplan.pdf" });

await client.DocumentsManager.DeleteDocumentAsync("urn:adsk.dtt:...", "docId");

Using the Fluent URL API

For full control or endpoints not covered by a Manager, use the Api property which mirrors the REST path structure:

// GET /tandem/v1/groups
var groups = await client.Api.Tandem.V1.Groups.GetAsync();

// GET /tandem/v1/twins/{twinID}
var twin = await client.Api.Tandem.V1.Twins["urn:adsk.dtt:..."].GetAsync();

// GET /tandem/v1/modeldata/{modelID}/schema
var schema = await client.Api.Tandem.V1.Modeldata["urn:adsk.dtm:..."].Schema.GetAsync();

Fluent URL Shortcut Properties

These shortcut properties skip the version prefix for common endpoints:

Rate Limiting

The SDK handles API rate limits automatically. When the API returns a 429 Too Many Requests response, the SDK will:

• Automatically retry the request with exponential backoff
• Respect the Retry-After header returned by the API
• Retry up to a configurable number of times before failing

No custom retry logic needed — transient failures and rate limiting are handled transparently by the built-in Kiota HTTP middleware.

Error Handling

By default, the SDK throws HttpRequestException for any non-success HTTP response (4xx/5xx). This is enabled by default — unlike Kiota's default behavior which requires manual status checking.

The exception includes the status code and the full HttpResponseMessage in ex.Data["context"]:

try
{
    var twin = await client.TwinsManager.GetTwinAsync("urn:adsk.dtt:...");
}
catch (HttpRequestException ex)
{
    Console.WriteLine($"Status: {ex.StatusCode} — {ex.Message}");

    if (ex.Data["context"] is HttpResponseMessage response)
    {
        Console.WriteLine($"URI: {response.RequestMessage?.RequestUri}");
        var body = await response.Content.ReadAsStringAsync();
        Console.WriteLine($"Body: {body}");
    }
}

To disable the error handler for a specific Manager method request:

using Autodesk.Common.HttpClientLibrary.Middleware.Options;

var twin = await client.TwinsManager.GetTwinAsync("urn:adsk.dtt:...",
    new() { Options = { new ErrorHandlerOption { Enabled = false } } });

To disable for a Fluent URL API request:

using Autodesk.Common.HttpClientLibrary.Middleware.Options;

var twin = await client.Twins["urn:adsk.dtt:..."].GetAsync(config =>
{
    config.Options.Add(new ErrorHandlerOption { Enabled = false });
});

Custom HTTP Client

You can provide your own HttpClient for advanced scenarios (proxies, custom handlers, etc.):

var httpClient = new HttpClient();
var client = new TandemClient(getAccessToken, httpClient);

Constructor

public TandemClient(Func<Task<string>> getAccessToken, HttpClient? httpClient = null)

Conventions

These patterns are consistent across all 31 methods and are useful for AI code generation:

• All async methods use the *Async suffix
• All endpoints return Task<T?> or Task (no paginated endpoints in this API)
• Every method accepts optional RequestConfiguration<T>? requestConfiguration (object, not Action<>) and CancellationToken cancellationToken parameters
• groupId, twinId, modelId, elementId, userId, documentId are all string
• Request body types are Kiota-generated classes in sub-namespaces (e.g. Autodesk.Tandem.Tandem.V1.Modeldata.Item.Scan.ScanPostRequestBody)

Related Packages

For AI Assistants

A machine-readable API reference with all 31 method signatures, return types, and REST endpoint mappings is available at llm.txt.

Requirements

• .NET 8.0 or later
• Valid Autodesk Platform Services (APS) access token with appropriate scopes

Documentation

• Tandem API Documentation
• Autodesk Platform Services
• Microsoft Kiota Documentation

License

This project is licensed under the MIT License.