Skip to main content
POST
/
internal
/
runtime
/
versions
Register Runtime Version
curl --request POST \
  --url https://api.example.com/internal/runtime/versions \
  --header 'Content-Type: application/json' \
  --data '
{
  "version": "<string>",
  "image_url": "<string>",
  "changelog": "<string>"
}
'
{
  "version": "<string>",
  "image_url": "<string>",
  "released_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "changelog": "<string>"
}

Body

application/json

Request body for registering a new runtime version.

Attributes: version: Semver version string (e.g., "0.40.0"). image_url: Full container image URL for this runtime version. changelog: Optional release notes in markdown.

​
version
string
required
​
image_url
string
required
​
changelog
string | null

Response

Successful Response

A tracked runtime image version.

Identity fields (frozen): version: Semver string (e.g., "0.39.0"), used as SurrealDB record ID.

Metadata: image_url: Full container image URL for this runtime version. released_at: Timestamp when this version was released. changelog: Optional release notes in markdown.

​
version
string
required
​
image_url
string
required
​
released_at
string<date-time>
required
​
created_at
string<date-time>
​
updated_at
string<date-time>
​
changelog
string | null