---
title: "Build information for the running server"
method: GET
path: "/version"
---

# Build information for the running server

`GET /version`

## Request

- Base URL: `https://craaft.io/api/v1`
- URL: `https://craaft.io/api/v1/version`
- Auth: none required

Unauthenticated so monitoring can poll it without managing
credentials, and cheap enough to use as a liveness probe: it touches
neither the database nor the session store. Use it to confirm which
artifact is live without shelling into a container.

## Response `200`

OK

- VersionInfo: Build-info triplet stamped in at link time via `-X` ldflags. A plain `go run` leaves the defaults in place, so `dev` / `unknown` means an unstamped build rather than a broken one.
  - `version` string, required: Release tag, or `dev` when unstamped
  - `commit` string, required: Short commit SHA, or `unknown` when unstamped
  - `buildTime` string, required: RFC3339 build timestamp, or `unknown` when unstamped

---

[API](https://skmtc.dev/craaft/apis/craaft-api.md) · [All operations](https://skmtc.dev/craaft/apis/craaft-api/llms.txt) · [OpenAPI document](https://skmtc.dev/craaft/apis/craaft-api/revisions/3a1e9d30d7dc?raw)