# API Versioning

The SpaceGass API uses URL segment versioning. The version number
is part of the URL path.

## URL Format

```
http://your-host/api/v{version}/{resource}
```

All current endpoints use **v1**:

```
http://localhost:34560/api/v1/job
http://localhost:34560/api/v1/job/structure/nodes
http://localhost:34560/api/v1/job/structure/members
```

## SDK Clients

The generated SDK clients have the version baked into the base URL,
so you don't need to manage it:

<CodeTabs>
```csharp title="C#"
// The base URL includes /api/v1 — just navigate from the client
var nodes = await client.Job.Structure.Nodes.GetAsync();
```

```python title="Python"
# Same in Python — the base URL handles versioning
nodes = await client.job.structure.nodes.get()
```
</CodeTabs>

## Package Versioning

SDK and package versions mirror the SPACE GASS Desktop version to
eliminate ambiguity:

| SPACE GASS Desktop | NuGet Package | PyPI Package |
|---|---|---|
| v15.0.2 | `SpaceGassApi 15.0.2` | `space-gass-api==15.0.2` |
| v15.1.0 | `SpaceGassApi 15.1.0` | `space-gass-api==15.1.0` |