Skip to content

Store new config version

PUT
/v1/ns/{nsid}/config
curl --request PUT \
--url https://example.com/v1/ns/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/config \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/yaml' \
--data example

Requires a base precondition via If-Match header or ?base= query param (ULID, latest, or a tag). Body is YAML or JSON.

nsid
required
string format: uuid

Namespace UUID

base
string

Base version to build on (ULID, ‘latest’, or a tag)

string

Version stored

Media typeapplication/json
object
success
required
boolean
new_version
required

ULID of the stored version

string
Examplegenerated
{
"success": true,
"new_version": "example"
}

Error response

Media typeapplication/problem+json

RFC 7807 Problem Details

object
type

Problem type slug URI

string
title
string
status
integer
detail
string
key
additional properties
any
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example"
}