---
title: "Publish Version"
method: POST
path: "/api/v1/admin/terms/versions"
---

# Publish Version

`POST /api/v1/admin/terms/versions`

## Request

- Base URL: `https://trovastorage.it` (the document declares no server; this is the origin it was published from)
- URL: `https://trovastorage.it/api/v1/admin/terms/versions`
- Auth: one of:
  - API key in header `X-Access-Token`
  - HTTP bearer

Publish a version and tell every operator. 409 `NOTICE_TOO_SHORT` when
it would take effect in under fifteen days.

## Request body

- TermsVersionCreate: A new version of the operator terms. It cannot take effect in under `TERMS_NOTICE_DAYS`, and every operator is told when it is published.
  - `version` string, required
  - `effective_from` string, date, required
  - `text_it` string, required
  - `text_en` string, required
  - `summary_it` string, required
  - `summary_en` string, required

## Response `201`

Successful Response

- TermsPublished
  - `version` string, required
  - `effective_from` string, date, required
  - `operators_told` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/trovastorage/apis/stock-your-inventory.md) · [All operations](https://skmtc.dev/trovastorage/apis/stock-your-inventory/llms.txt) · [OpenAPI document](https://skmtc.dev/trovastorage/apis/stock-your-inventory/revisions/c75f591a585c?raw)