Activate a version (rollback / pin)

Activate a version — point the model at the resolved version so it serves scores. Use it to roll back or pin. Non-destructive: new samples keep accumulating and automatic retraining keeps minting new versions regardless of which one is active.

PUT /models/{handle}/versions/active

cURL

cURL

curl -X PUT https://u22a8.ai/v1/models/acme.support-tone/versions/active \
  -H "Authorization: Bearer $U22A8_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"version": "v3"}'

200

{
  "handle": "<string>",
  "version_no": 123
}

Points the model at the chosen version so it serves scores — use it to roll back or pin. Send exactly one of version (a vN number) or tag. Non-destructive: new samples keep accumulating and automatic retraining keeps minting versions regardless of which one is active.

Authorizations

Authorization · string · header · required

API key issued in the platform console, sent as Authorization: Bearer <key>.

Path Parameters

handle · string · required

Model handle, e.g. 'u22a8.technical-writing'.

Example:

"u22a8.technical-writing"

Body

application/json

PUT /v1/models/{handle}/versions/active body.

Exactly one of version / tag must be set. version is the monotonic vN form; tag is a user-named pointer.

version · string | null

Version number in the form "vN" (e.g. "v37").

Example:

"v37"

tag · string | null

Tag name.

Example:

"prod-2026-05-01"

Response

200

application/json

Successful Response

handle · string · required

version_no · integer · required