---
title: "axiom client build"
description: "Build an SDK for a client in one or more languages"
category: reference
surfaces: [cli]
related: [reference/cli/axiom-client]
last_reviewed: 2026-06-06
---

<!-- GENERATED by docs/scripts/gen-cli-reference — DO NOT EDIT.
     Source of truth: the cobra command definitions in cmd/axiom/cmd/.
     Regenerate from the repo root with: go run ./docs/scripts/gen-cli-reference -->

# axiom client build

Build an SDK for a client in one or more languages

Start a build for a client: snapshot its current draft members (or reuse an
existing version's frozen snapshot) and compile each selected language.

```text
axiom client build c1 --lang python,go        # cut a new version, build both
axiom client build c1 --lang rust --version 3 # add a language to version 3
axiom client build c1 --lang python,go --json # machine-readable output
```

A build starts every selected language in "pending"; it transitions to
"building" then "succeeded" or "failed" asynchronously. Poll progress with:

```text
axiom client status c1 --version N --watch
```

Requires a prior "axiom login".

## Usage

```sh
axiom client build <client-id> [flags]
```

## Flags

| Flag | Shorthand | Type | Default | Description |
|---|---|---|---|---|
| `--help` | `-h` | bool |  | help for build |
| `--json` |  | bool |  | Emit a JSON array of the started build rows |
| `--lang` |  | string |  | Comma-separated languages to build (python, go, typescript, java, csharp, rust) |
| `--version` |  | int | `0` | Existing version to add languages to (omit to cut a new version from the current draft) |

## See also

- [axiom client](./axiom-client.md) — Create and manage Client Builder clients (typed SDKs)