Skip to content
Sluice

saveChanges

POST
/api/v1/namespaces/{namespace}/changes
curl --request POST \
  --url https://example.com/api/v1/namespaces/example/changes \
  --header 'Content-Type: application/json' \
  --data '{ "base_version": 1, "changes": [ { "content": "example", "content_base64": "example", "executable": true, "new_path": "example", "op": "put", "path": "example" } ], "message": "example" }'

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
namespace
required
string
<= 128 characters /^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$/

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
base_version

Fails with 409 version_conflict when the head version differs.

integer format: int64
changes
required
Array<object>
>= 1 items <= 1000 items
object
content

Put only. UTF-8 text content.

string
content_base64

Put only. Binary content as base64. Used instead of content.

string
executable
boolean
new_path

Rename only.

string
<= 512 characters
op
required
string
Allowed values: put delete rename
path
required
string
<= 512 characters
key
additional properties
any
message
required
string
>= 1 characters <= 500 characters
key
additional properties
any

Responses

Section titled “ Responses ”

201

Section titled “201”

Created

Media typeapplication/json
object
author
required
string
created_at
required
string format: date-time
file_count
required
integer format: int64
git_sha
string
id
required
string
manifest_hash
required
string
message
required
string
version
integer | null format: int64
key
additional properties
any
Examplegenerated
{
  "author": "example",
  "created_at": "2026-04-15T12:00:00Z",
  "file_count": 1,
  "git_sha": "example",
  "id": "example",
  "manifest_hash": "example",
  "message": "example",
  "version": 1
}

default

Section titled “default”

Error

Media typeapplication/json
object
error
required
object
code
required
string
details
message
required
string
key
additional properties
any
key
additional properties
any
Examplegenerated
{
  "error": {
    "code": "example",
    "details": "example",
    "message": "example"
  }
}