Apply a commit

POST

/v0/namespaces/{namespace_id}/commits

Applies one commit: an ordered, non-empty list of path operations that commit together as one logical commit, under one commit id that makes retries idempotent. Request preconditions check the pre-state after receipt resolution and before operations; a failed precondition names its position in details.precondition_index. A single-operation call is the one-element case. The first operation that fails aborts the whole request, and a request carrying more than one operation names that operation’s position in details.operation_index.

Authorizations

• bearer_auth

Parameters

Path Parameters

namespace_id

required

string

Namespace id

Header Parameters

Loonfs-Actor

required

Stable opaque actor id containing 1 to 256 visible ASCII characters.

string

/^[\x21-\x7E]{1,256}$/

Example

usr_8f3c

Stable opaque actor ID supplied by the application. Keep this value unchanged when retrying a commit; it is attribution, not authentication.

Request Body ^required

A request to commit one or more filesystem operations atomically in order.

Unknown fields are rejected.

object

commit_id

required

Caller-supplied idempotency key for the whole request.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

c_f3a9c2d4b6e8417a90c5d2f8e1b7a6c0

content_tokens

The proofs for new external content references in this request.

Array<object>

Proof that a specific content_ref may be used in a later commit.

object

content_ref

required

Content authorized by this token.

object

checksum

required

Mandatory checksum over the complete object.

object

algorithm

required

Algorithm that produced value.

string

Allowed values: sha256 crc64nvme crc32c

value

required

The canonical lowercase hexadecimal checksum without a prefix.

string

content_id

required

Immutable identity of the content; with the owner, it determines the object key.

string

/^con_[0-9a-f]{32}$/

Example

con_9f2a6c0e4b7d4a90b13f0d8c5e6a2b41

kind

required

Content strategy used by the referenced content.

string

Allowed values: blob_v1

owner_namespace_id

required

Namespace that originally wrote the bytes.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

size_bytes

required

Complete byte length of the referenced content.

integer format: int64

token

required

The opaque server-signed token that clients must not parse.

string

message

The caller annotation that forms part of the commit identity.

string

operations

required

The non-empty ordered operations to commit atomically.

Array

One of: discriminator: kind

create_directory

create_directory

Create one directory.

object

kind

required

string

Allowed values: create_directory

parents

Whether to create missing ancestor directories while requiring the final component to be new.

boolean

path

required

Absolute destination path, rejected when invalid or already bound.

string

Example

/docs/report.txt

create_directory_by_inode

create_directory_by_inode

Create a directory under an existing parent inode.

object

display_name

required

New directory name.

string

Example

report.txt

kind

required

string

Allowed values: create_directory_by_inode

parent_inode_id

required

Parent directory.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

put_file

put_file

Create or replace one file from uploaded or inline content. Requires exactly one of content_ref and inline_content.

object

behavior

Whether an existing file may receive a new revision instead of causing a conflict.

string

Allowed values: no_replace replace

content_ref

Uploaded content covered by a token; mutually exclusive with inline_content.

object

checksum

required

Mandatory checksum over the complete object.

object

algorithm

required

Algorithm that produced value.

string

Allowed values: sha256 crc64nvme crc32c

value

required

The canonical lowercase hexadecimal checksum without a prefix.

string

content_id

required

Immutable identity of the content; with the owner, it determines the object key.

string

/^con_[0-9a-f]{32}$/

Example

con_9f2a6c0e4b7d4a90b13f0d8c5e6a2b41

kind

required

Content strategy used by the referenced content.

string

Allowed values: blob_v1

owner_namespace_id

required

Namespace that originally wrote the bytes.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

size_bytes

required

Complete byte length of the referenced content.

integer format: int64

expected_inode_id

With replace behavior, the request requires the path to contain this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

expected_revision_no

With replace behavior and an inode precondition, the request requires this content revision.

integer format: int64

<= 9007199254740991

inline_content

Complete file bytes as base64; mutually exclusive with content_ref.

string format: byte

kind

required

string

Allowed values: put_file

path

required

Absolute destination path; missing ancestors are created automatically.

string

Example

/docs/report.txt

create_file_by_inode

create_file_by_inode

Create a file with an unused name under an existing parent inode. Requires exactly one of content_ref and inline_content.

object

content_ref

Uploaded content covered by a token; mutually exclusive with inline_content.

object

checksum

required

Mandatory checksum over the complete object.

object

algorithm

required

Algorithm that produced value.

string

Allowed values: sha256 crc64nvme crc32c

value

required

The canonical lowercase hexadecimal checksum without a prefix.

string

content_id

required

Immutable identity of the content; with the owner, it determines the object key.

string

/^con_[0-9a-f]{32}$/

Example

con_9f2a6c0e4b7d4a90b13f0d8c5e6a2b41

kind

required

Content strategy used by the referenced content.

string

Allowed values: blob_v1

owner_namespace_id

required

Namespace that originally wrote the bytes.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

size_bytes

required

Complete byte length of the referenced content.

integer format: int64

display_name

required

New file name.

string

Example

report.txt

inline_content

Complete file bytes as base64; mutually exclusive with content_ref.

string format: byte

kind

required

string

Allowed values: create_file_by_inode

parent_inode_id

required

Parent directory.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

put_file_revision_by_inode

put_file_revision_by_inode

Append a revision to a file inode if its current revision matches. Requires exactly one of content_ref and inline_content.

object

content_ref

Uploaded content covered by a token; mutually exclusive with inline_content.

object

checksum

required

Mandatory checksum over the complete object.

object

algorithm

required

Algorithm that produced value.

string

Allowed values: sha256 crc64nvme crc32c

value

required

The canonical lowercase hexadecimal checksum without a prefix.

string

content_id

required

Immutable identity of the content; with the owner, it determines the object key.

string

/^con_[0-9a-f]{32}$/

Example

con_9f2a6c0e4b7d4a90b13f0d8c5e6a2b41

kind

required

Content strategy used by the referenced content.

string

Allowed values: blob_v1

owner_namespace_id

required

Namespace that originally wrote the bytes.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

size_bytes

required

Complete byte length of the referenced content.

integer format: int64

expected_revision_no

required

Current revision required for the write.

integer format: int64

<= 9007199254740991

inline_content

Complete file bytes as base64; mutually exclusive with content_ref.

string format: byte

inode_id

required

File to update.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: put_file_revision_by_inode

delete_path

delete_path

Delete one path.

object

behavior

Whether a non-empty directory may be tombstoned recursively.

string

Allowed values: non_recursive recursive

expected_inode_id

The inode that the path must still resolve to before deletion.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: delete_path

path

required

Absolute path that must resolve to a visible inode.

string

Example

/docs/report.txt

delete_by_inode

delete_by_inode

Delete an inode if its current binding matches.

object

behavior

Whether a non-empty directory may be tombstoned recursively.

string

Allowed values: non_recursive recursive

expected_binding_version

required

Binding version required for the delete.

string

/^[0-9a-f]+$/

inode_id

required

Inode to delete.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: delete_by_inode

move_path

move_path

Move one path to another path.

object

behavior

Whether an existing destination file may be replaced.

string

Allowed values: no_replace replace

destination_path

required

Absolute destination whose parent must be visible and writable.

string

Example

/docs/report.txt

expected_destination_inode_id

With replace behavior, the destination inode required by the request.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

expected_destination_revision_no

With replace behavior and an inode precondition, the required content revision.

integer format: int64

<= 9007199254740991

kind

required

string

Allowed values: move_path

source_path

required

Absolute source path that must resolve to a visible inode.

string

Example

/docs/report.txt

move_by_inode

move_by_inode

Move an inode if its current binding matches.

object

behavior

Whether an existing destination file may be replaced.

string

Allowed values: no_replace replace

destination_display_name

required

New name.

string

Example

report.txt

destination_parent_inode_id

required

Destination directory.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

expected_binding_version

required

Binding version required for the move.

string

/^[0-9a-f]+$/

expected_destination_inode_id

With replace behavior, the destination inode required by the request.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

expected_destination_revision_no

With replace behavior and an inode precondition, the required content revision.

integer format: int64

<= 9007199254740991

inode_id

required

Inode to move.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: move_by_inode

copy_path

copy_path

Copy one file path to another path.

object

behavior

Whether an existing destination file may be replaced.

string

Allowed values: no_replace replace

destination_path

required

Absolute destination whose parent must be visible and writable.

string

Example

/docs/report.txt

expected_destination_inode_id

With replace behavior, the destination inode required by the request.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

expected_destination_revision_no

With replace behavior and an inode precondition, the required content revision.

integer format: int64

<= 9007199254740991

kind

required

string

Allowed values: copy_path

source_path

required

Absolute source path that must resolve to a visible file.

string

Example

/docs/report.txt

undelete

undelete

Restore the deletion identified by inode_id and deletion_seq.

object

deletion_seq

required

Observed deletion sequence, which prevents cancelling a newer tombstone sequence.

integer format: int64

<= 9007199254740991

destination_path

The restore destination. Omit it to use the recorded binding.

string

Example

/docs/report.txt

inode_id

required

Deleted inode to make reachable again.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: undelete

restore_revision

restore_revision

Restore an older revision as the current revision for a path.

object

kind

required

string

Allowed values: restore_revision

path

required

Absolute path that must resolve to a visible file.

string

Example

/docs/report.txt

source_revision_no

required

Existing historical revision whose content will be copied into a new current revision.

integer format: int64

<= 9007199254740991

update_attributes

update_attributes

Write and remove attributes on the inode one path resolves to.

object

expected_attributes_revision_no

With an inode precondition, the attribute revision that must still be current.

integer format: int64

<= 9007199254740991

expected_inode_id

The inode that the path must still resolve to before the update.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: update_attributes

path

required

Absolute path that must resolve to a visible file or directory.

string

Example

/docs/report.txt

remove

The attribute keys to remove, including duplicates that validation must reject.

Array<string>

set

The attributes to write, replacing values for matching keys and leaving other keys unchanged.

object

key

additional properties

A validated inode attribute value of at most 4,096 UTF-8 bytes.

Empty strings and control characters are valid, and only an explicit remove operation deletes an attribute.

string

Example

platform

update_access

update_access

Replace the access row of the inode one path resolves to. The root path is a valid target.

object

boundary

required

Whether the directory stops inheritance from its ancestors.

boolean

expected_access_revision_no

With an inode precondition, the access revision that must still be current.

integer format: int64

<= 9007199254740991

expected_inode_id

The inode that the path must still resolve to before the update.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

grants

required

The inode’s complete direct grants after this update.

object

key

additional properties

A set of rights. Encoded as distinct names in read, history, write, create, remove, share, manage, admin order. Decoding accepts any order and rejects repeated names.

Array<string>

Allowed values: read history write create remove share manage admin

kind

required

string

Allowed values: update_access

path

required

Absolute path that must resolve to a visible file or directory.

string

Example

/docs/report.txt

preconditions

Ordered admission conditions evaluated before any operations.

Array

One of: discriminator: kind

namespace_head

namespace_head

Requires the pre-state head sequence to equal expected_head_seq.

object

expected_head_seq

required

Sequence observed when the caller read its inputs.

integer format: int64

<= 9007199254740991

kind

required

string

Allowed values: namespace_head

file_revision

file_revision

Requires a visible inode with the content revision the caller read.

object

expected_revision_no

required

Content revision observed by the caller.

integer format: int64

<= 9007199254740991

inode_id

required

Inode whose state the caller read.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: file_revision

path_binding

path_binding

Requires the path to retain the binding the caller read.

object

expected_binding_version

Detects moves away and back.

string

/^[0-9a-f]+$/

expected_inode_id

required

Inode required at the path.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: path_binding

path

required

Absolute path to check, including the root.

string

Example

/docs/report.txt

attributes_revision

attributes_revision

Requires a visible inode with the attribute revision the caller read.

object

expected_attributes_revision_no

required

Attribute revision observed by the caller.

integer format: int64

<= 9007199254740991

inode_id

required

Inode whose state the caller read.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: attributes_revision

access_revision

access_revision

Requires a visible inode with the access revision the caller read.

object

expected_access_revision_no

required

Access revision observed by the caller.

integer format: int64

<= 9007199254740991

inode_id

required

Inode whose state the caller read.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: access_revision

path_absence

path_absence

Requires no visible entry at the full path.

object

kind

required

string

Allowed values: path_absence

path

required

Absolute path to check, including the root.

string

Example

/docs/report.txt

Responses

200

Commit applied

One committed logical commit: its identity and the events it applied.

object

commit_id

required

The idempotency key for the commit.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

c_f3a9c2d4b6e8417a90c5d2f8e1b7a6c0

committed_at_ms

required

The commit time in Unix milliseconds; committed_seq defines commit order.

integer format: int64

committed_by

required

Actor responsible for the commit, as supplied by the application.

string

/^[\x21-\x7E]{1,256}$/

Example

usr_8f3c

committed_seq

required

Sequence number where the commit became visible.

integer format: int64

<= 9007199254740991

events

required

The semantic filesystem operations the commit applied, in request order.

Array

One of: discriminator: kind

directory_created

directory_created

A directory was created.

object

binding_version

required

Opaque identifier for the binding created by this event.

string

/^[0-9a-f]+$/

display_name

required

User-facing spelling of the new entry.

string

Example

report.txt

inode_id

required

Newly allocated namespace-scoped inode identity.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: directory_created

parent_inode_id

required

Directory the new entry was bound under.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

file_created

file_created

A file and its first revision were created.

object

binding_version

required

Opaque identifier for the binding created by this event.

string

/^[0-9a-f]+$/

content_ref

required

Content of the first revision.

object

checksum

required

Mandatory checksum over the complete object.

object

algorithm

required

Algorithm that produced value.

string

Allowed values: sha256 crc64nvme crc32c

value

required

The canonical lowercase hexadecimal checksum without a prefix.

string

content_id

required

Immutable identity of the content; with the owner, it determines the object key.

string

/^con_[0-9a-f]{32}$/

Example

con_9f2a6c0e4b7d4a90b13f0d8c5e6a2b41

kind

required

Content strategy used by the referenced content.

string

Allowed values: blob_v1

owner_namespace_id

required

Namespace that originally wrote the bytes.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

size_bytes

required

Complete byte length of the referenced content.

integer format: int64

display_name

required

User-facing spelling of the new entry.

string

Example

report.txt

inode_id

required

Newly allocated namespace-scoped inode identity.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: file_created

parent_inode_id

required

Directory the new entry was bound under.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

revision_no

required

First revision number.

integer format: int64

<= 9007199254740991

content_changed

content_changed

A file received a new current revision from a put or revision restore.

object

content_ref

required

Immutable content published by the revision.

object

checksum

required

Mandatory checksum over the complete object.

object

algorithm

required

Algorithm that produced value.

string

Allowed values: sha256 crc64nvme crc32c

value

required

The canonical lowercase hexadecimal checksum without a prefix.

string

content_id

required

Immutable identity of the content; with the owner, it determines the object key.

string

/^con_[0-9a-f]{32}$/

Example

con_9f2a6c0e4b7d4a90b13f0d8c5e6a2b41

kind

required

Content strategy used by the referenced content.

string

Allowed values: blob_v1

owner_namespace_id

required

Namespace that originally wrote the bytes.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

size_bytes

required

Complete byte length of the referenced content.

integer format: int64

inode_id

required

File inode whose history advanced.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: content_changed

revision_no

required

New monotonic position in that file’s revision history.

integer format: int64

<= 9007199254740991

moved

moved

An inode moved to a new parent directory or name.

object

binding_version

required

Opaque identifier for the binding created by this event.

string

/^[0-9a-f]+$/

destination_display_name

required

Spelling of the new binding.

string

Example

report.txt

destination_parent_inode_id

required

Directory holding the new binding.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

inode_id

required

Inode whose binding changed.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: moved

source_display_name

required

Spelling of the removed binding.

string

Example

report.txt

source_parent_inode_id

required

Directory that held the removed binding.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

deleted

deleted

A file or directory subtree was deleted.

object

deleted_binding

required

Directory binding removed by the deletion.

object

display_name

required

Name shown to users.

string

Example

report.txt

name_key

required

Name used to look up the entry.

string

Example

report.txt

parent_inode_id

required

Parent directory containing the entry.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

inode_id

required

Inode at the root of the deleted subtree.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: deleted

undeleted

undeleted

A deleted inode was recovered and re-bound.

object

binding_version

required

Opaque identifier for the binding created by this event.

string

/^[0-9a-f]+$/

display_name

required

Spelling of the recovered binding.

string

Example

report.txt

inode_id

required

Recovered inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: undeleted

parent_inode_id

required

Directory the recovered entry was bound under.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

attributes_changed

attributes_changed

An inode’s attributes changed.

object

attributes

required

The inode’s complete attribute map after the update, including an empty map when all attributes were cleared.

object

key

additional properties

A validated inode attribute value of at most 4,096 UTF-8 bytes.

Empty strings and control characters are valid, and only an explicit remove operation deletes an attribute.

string

Example

platform

attributes_revision_no

required

New attribute revision for that inode.

integer format: int64

<= 9007199254740991

inode_id

required

Inode whose attributes advanced.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: attributes_changed

access_changed

access_changed

An inode’s access row was replaced. grants is the complete direct grant map after the update.

object

access_revision_no

required

Revision published by the update.

integer format: int64

<= 9007199254740991

boundary

required

Whether the directory stops inheritance from its ancestors.

boolean

grants

required

The inode’s complete direct grants after this update.

object

key

additional properties

A set of rights. Encoded as distinct names in read, history, write, create, remove, share, manage, admin order. Decoding accepts any order and rejects repeated names.

Array<string>

Allowed values: read history write create remove share manage admin

inode_id

required

Inode whose access state advanced.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: access_changed

message

The optional caller annotation for the commit.

string

namespace_id

required

Namespace that changed.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

400

Invalid commit

HTTP error body used by LoonFS APIs.

object

code

required

The stable machine-readable error code as a string.

string

details

The optional machine-readable context for the error code.

object

active_acquired_at_ms

The Unix-millisecond time when the current writer acquired its epoch, when available.

integer format: int64

active_writer_epoch

Epoch that currently owns the namespace.

integer format: int64

<= 9007199254740991

active_writer_id

The writer ID recorded for the current epoch, when available.

string

actual_access_revision_no

Access revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_attributes_revision_no

Attribute revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_binding_version

Current binding token; absent for the root, which has no binding.

string

/^[0-9a-f]+$/

actual_deletion_seq

Deletion sequence actually active for the inode.

integer format: int64

<= 9007199254740991

actual_head_seq

The actual namespace head sequence.

integer format: int64

<= 9007199254740991

actual_inode_id

The path actually contained this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

actual_revision_no

Revision that is actually current; absent when the inode has none.

integer format: int64

<= 9007199254740991

after_seq

Change-feed cursor the request asked to resume after.

integer format: int64

<= 9007199254740991

commit_id

Idempotency key of the commit the error concerns.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

c_f3a9c2d4b6e8417a90c5d2f8e1b7a6c0

committed_fingerprint

The fingerprint of the mutation that landed under commit_id, present with committed_seq.

string

committed_seq

The sequence where this commit ID already landed, when recorded by a durable receipt.

integer format: int64

<= 9007199254740991

expected_access_revision_no

Access revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_attributes_revision_no

Attribute revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_binding_version

Opaque binding token supplied by the request.

string

/^[0-9a-f]+$/

expected_deletion_seq

Deletion sequence the undelete expected to be active.

integer format: int64

<= 9007199254740991

expected_head_seq

The head sequence required by the request.

integer format: int64

<= 9007199254740991

expected_inode_id

The request expected the path to contain this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

expected_revision_no

Revision the request expected to be current.

integer format: int64

<= 9007199254740991

fenced_writer_epoch

Epoch the failing writer session held when it was displaced.

integer format: int64

<= 9007199254740991

inode_id

Inode the failed precondition or operation targeted.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

max_writer_sessions

Maximum writer sessions admitted by the node.

integer

namespace_id

The deleted namespace that caused the operation to fail.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

operation_index

The index of the failed operation in the request.

integer format: int32

precondition_index

Zero-based position of the failed request precondition.

integer format: int32

retention_floor_seq

Oldest sequence still promised for incremental replay.

integer format: int64

<= 9007199254740991

feature

The capability feature key for a not_supported error.

string

message

required

Human-readable error message.

string

param

The invalid JSON Pointer, parameter name, CLI flag, or CLI argument.

string

request_id

The request correlation ID also sent in the x-request-id response header.

string

401

Unauthorized

HTTP error body used by LoonFS APIs.

object

code

required

The stable machine-readable error code as a string.

string

details

The optional machine-readable context for the error code.

object

active_acquired_at_ms

The Unix-millisecond time when the current writer acquired its epoch, when available.

integer format: int64

active_writer_epoch

Epoch that currently owns the namespace.

integer format: int64

<= 9007199254740991

active_writer_id

The writer ID recorded for the current epoch, when available.

string

actual_access_revision_no

Access revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_attributes_revision_no

Attribute revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_binding_version

Current binding token; absent for the root, which has no binding.

string

/^[0-9a-f]+$/

actual_deletion_seq

Deletion sequence actually active for the inode.

integer format: int64

<= 9007199254740991

actual_head_seq

The actual namespace head sequence.

integer format: int64

<= 9007199254740991

actual_inode_id

The path actually contained this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

actual_revision_no

Revision that is actually current; absent when the inode has none.

integer format: int64

<= 9007199254740991

after_seq

Change-feed cursor the request asked to resume after.

integer format: int64

<= 9007199254740991

commit_id

Idempotency key of the commit the error concerns.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

c_f3a9c2d4b6e8417a90c5d2f8e1b7a6c0

committed_fingerprint

The fingerprint of the mutation that landed under commit_id, present with committed_seq.

string

committed_seq

The sequence where this commit ID already landed, when recorded by a durable receipt.

integer format: int64

<= 9007199254740991

expected_access_revision_no

Access revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_attributes_revision_no

Attribute revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_binding_version

Opaque binding token supplied by the request.

string

/^[0-9a-f]+$/

expected_deletion_seq

Deletion sequence the undelete expected to be active.

integer format: int64

<= 9007199254740991

expected_head_seq

The head sequence required by the request.

integer format: int64

<= 9007199254740991

expected_inode_id

The request expected the path to contain this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

expected_revision_no

Revision the request expected to be current.

integer format: int64

<= 9007199254740991

fenced_writer_epoch

Epoch the failing writer session held when it was displaced.

integer format: int64

<= 9007199254740991

inode_id

Inode the failed precondition or operation targeted.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

max_writer_sessions

Maximum writer sessions admitted by the node.

integer

namespace_id

The deleted namespace that caused the operation to fail.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

operation_index

The index of the failed operation in the request.

integer format: int32

precondition_index

Zero-based position of the failed request precondition.

integer format: int32

retention_floor_seq

Oldest sequence still promised for incremental replay.

integer format: int64

<= 9007199254740991

feature

The capability feature key for a not_supported error.

string

message

required

Human-readable error message.

string

param

The invalid JSON Pointer, parameter name, CLI flag, or CLI argument.

string

request_id

The request correlation ID also sent in the x-request-id response header.

string

404

Namespace or path not found

HTTP error body used by LoonFS APIs.

object

code

required

The stable machine-readable error code as a string.

string

details

The optional machine-readable context for the error code.

object

active_acquired_at_ms

The Unix-millisecond time when the current writer acquired its epoch, when available.

integer format: int64

active_writer_epoch

Epoch that currently owns the namespace.

integer format: int64

<= 9007199254740991

active_writer_id

The writer ID recorded for the current epoch, when available.

string

actual_access_revision_no

Access revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_attributes_revision_no

Attribute revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_binding_version

Current binding token; absent for the root, which has no binding.

string

/^[0-9a-f]+$/

actual_deletion_seq

Deletion sequence actually active for the inode.

integer format: int64

<= 9007199254740991

actual_head_seq

The actual namespace head sequence.

integer format: int64

<= 9007199254740991

actual_inode_id

The path actually contained this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

actual_revision_no

Revision that is actually current; absent when the inode has none.

integer format: int64

<= 9007199254740991

after_seq

Change-feed cursor the request asked to resume after.

integer format: int64

<= 9007199254740991

commit_id

Idempotency key of the commit the error concerns.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

c_f3a9c2d4b6e8417a90c5d2f8e1b7a6c0

committed_fingerprint

The fingerprint of the mutation that landed under commit_id, present with committed_seq.

string

committed_seq

The sequence where this commit ID already landed, when recorded by a durable receipt.

integer format: int64

<= 9007199254740991

expected_access_revision_no

Access revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_attributes_revision_no

Attribute revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_binding_version

Opaque binding token supplied by the request.

string

/^[0-9a-f]+$/

expected_deletion_seq

Deletion sequence the undelete expected to be active.

integer format: int64

<= 9007199254740991

expected_head_seq

The head sequence required by the request.

integer format: int64

<= 9007199254740991

expected_inode_id

The request expected the path to contain this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

expected_revision_no

Revision the request expected to be current.

integer format: int64

<= 9007199254740991

fenced_writer_epoch

Epoch the failing writer session held when it was displaced.

integer format: int64

<= 9007199254740991

inode_id

Inode the failed precondition or operation targeted.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

max_writer_sessions

Maximum writer sessions admitted by the node.

integer

namespace_id

The deleted namespace that caused the operation to fail.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

operation_index

The index of the failed operation in the request.

integer format: int32

precondition_index

Zero-based position of the failed request precondition.

integer format: int32

retention_floor_seq

Oldest sequence still promised for incremental replay.

integer format: int64

<= 9007199254740991

feature

The capability feature key for a not_supported error.

string

message

required

Human-readable error message.

string

param

The invalid JSON Pointer, parameter name, CLI flag, or CLI argument.

string

request_id

The request correlation ID also sent in the x-request-id response header.

string

409

Operation conflict

HTTP error body used by LoonFS APIs.

object

code

required

The stable machine-readable error code as a string.

string

details

The optional machine-readable context for the error code.

object

active_acquired_at_ms

The Unix-millisecond time when the current writer acquired its epoch, when available.

integer format: int64

active_writer_epoch

Epoch that currently owns the namespace.

integer format: int64

<= 9007199254740991

active_writer_id

The writer ID recorded for the current epoch, when available.

string

actual_access_revision_no

Access revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_attributes_revision_no

Attribute revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_binding_version

Current binding token; absent for the root, which has no binding.

string

/^[0-9a-f]+$/

actual_deletion_seq

Deletion sequence actually active for the inode.

integer format: int64

<= 9007199254740991

actual_head_seq

The actual namespace head sequence.

integer format: int64

<= 9007199254740991

actual_inode_id

The path actually contained this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

actual_revision_no

Revision that is actually current; absent when the inode has none.

integer format: int64

<= 9007199254740991

after_seq

Change-feed cursor the request asked to resume after.

integer format: int64

<= 9007199254740991

commit_id

Idempotency key of the commit the error concerns.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

c_f3a9c2d4b6e8417a90c5d2f8e1b7a6c0

committed_fingerprint

The fingerprint of the mutation that landed under commit_id, present with committed_seq.

string

committed_seq

The sequence where this commit ID already landed, when recorded by a durable receipt.

integer format: int64

<= 9007199254740991

expected_access_revision_no

Access revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_attributes_revision_no

Attribute revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_binding_version

Opaque binding token supplied by the request.

string

/^[0-9a-f]+$/

expected_deletion_seq

Deletion sequence the undelete expected to be active.

integer format: int64

<= 9007199254740991

expected_head_seq

The head sequence required by the request.

integer format: int64

<= 9007199254740991

expected_inode_id

The request expected the path to contain this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

expected_revision_no

Revision the request expected to be current.

integer format: int64

<= 9007199254740991

fenced_writer_epoch

Epoch the failing writer session held when it was displaced.

integer format: int64

<= 9007199254740991

inode_id

Inode the failed precondition or operation targeted.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

max_writer_sessions

Maximum writer sessions admitted by the node.

integer

namespace_id

The deleted namespace that caused the operation to fail.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

operation_index

The index of the failed operation in the request.

integer format: int32

precondition_index

Zero-based position of the failed request precondition.

integer format: int32

retention_floor_seq

Oldest sequence still promised for incremental replay.

integer format: int64

<= 9007199254740991

feature

The capability feature key for a not_supported error.

string

message

required

Human-readable error message.

string

param

The invalid JSON Pointer, parameter name, CLI flag, or CLI argument.

string

request_id

The request correlation ID also sent in the x-request-id response header.

string

410

Namespace deleted

HTTP error body used by LoonFS APIs.

object

code

required

The stable machine-readable error code as a string.

string

details

The optional machine-readable context for the error code.

object

active_acquired_at_ms

The Unix-millisecond time when the current writer acquired its epoch, when available.

integer format: int64

active_writer_epoch

Epoch that currently owns the namespace.

integer format: int64

<= 9007199254740991

active_writer_id

The writer ID recorded for the current epoch, when available.

string

actual_access_revision_no

Access revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_attributes_revision_no

Attribute revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_binding_version

Current binding token; absent for the root, which has no binding.

string

/^[0-9a-f]+$/

actual_deletion_seq

Deletion sequence actually active for the inode.

integer format: int64

<= 9007199254740991

actual_head_seq

The actual namespace head sequence.

integer format: int64

<= 9007199254740991

actual_inode_id

The path actually contained this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

actual_revision_no

Revision that is actually current; absent when the inode has none.

integer format: int64

<= 9007199254740991

after_seq

Change-feed cursor the request asked to resume after.

integer format: int64

<= 9007199254740991

commit_id

Idempotency key of the commit the error concerns.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

c_f3a9c2d4b6e8417a90c5d2f8e1b7a6c0

committed_fingerprint

The fingerprint of the mutation that landed under commit_id, present with committed_seq.

string

committed_seq

The sequence where this commit ID already landed, when recorded by a durable receipt.

integer format: int64

<= 9007199254740991

expected_access_revision_no

Access revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_attributes_revision_no

Attribute revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_binding_version

Opaque binding token supplied by the request.

string

/^[0-9a-f]+$/

expected_deletion_seq

Deletion sequence the undelete expected to be active.

integer format: int64

<= 9007199254740991

expected_head_seq

The head sequence required by the request.

integer format: int64

<= 9007199254740991

expected_inode_id

The request expected the path to contain this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

expected_revision_no

Revision the request expected to be current.

integer format: int64

<= 9007199254740991

fenced_writer_epoch

Epoch the failing writer session held when it was displaced.

integer format: int64

<= 9007199254740991

inode_id

Inode the failed precondition or operation targeted.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

max_writer_sessions

Maximum writer sessions admitted by the node.

integer

namespace_id

The deleted namespace that caused the operation to fail.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

operation_index

The index of the failed operation in the request.

integer format: int32

precondition_index

Zero-based position of the failed request precondition.

integer format: int32

retention_floor_seq

Oldest sequence still promised for incremental replay.

integer format: int64

<= 9007199254740991

feature

The capability feature key for a not_supported error.

string

message

required

Human-readable error message.

string

param

The invalid JSON Pointer, parameter name, CLI flag, or CLI argument.

string

request_id

The request correlation ID also sent in the x-request-id response header.

string

413

JSON body exceeds the 2 MiB limit

HTTP error body used by LoonFS APIs.

object

code

required

The stable machine-readable error code as a string.

string

details

The optional machine-readable context for the error code.

object

active_acquired_at_ms

The Unix-millisecond time when the current writer acquired its epoch, when available.

integer format: int64

active_writer_epoch

Epoch that currently owns the namespace.

integer format: int64

<= 9007199254740991

active_writer_id

The writer ID recorded for the current epoch, when available.

string

actual_access_revision_no

Access revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_attributes_revision_no

Attribute revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_binding_version

Current binding token; absent for the root, which has no binding.

string

/^[0-9a-f]+$/

actual_deletion_seq

Deletion sequence actually active for the inode.

integer format: int64

<= 9007199254740991

actual_head_seq

The actual namespace head sequence.

integer format: int64

<= 9007199254740991

actual_inode_id

The path actually contained this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

actual_revision_no

Revision that is actually current; absent when the inode has none.

integer format: int64

<= 9007199254740991

after_seq

Change-feed cursor the request asked to resume after.

integer format: int64

<= 9007199254740991

commit_id

Idempotency key of the commit the error concerns.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

c_f3a9c2d4b6e8417a90c5d2f8e1b7a6c0

committed_fingerprint

The fingerprint of the mutation that landed under commit_id, present with committed_seq.

string

committed_seq

The sequence where this commit ID already landed, when recorded by a durable receipt.

integer format: int64

<= 9007199254740991

expected_access_revision_no

Access revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_attributes_revision_no

Attribute revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_binding_version

Opaque binding token supplied by the request.

string

/^[0-9a-f]+$/

expected_deletion_seq

Deletion sequence the undelete expected to be active.

integer format: int64

<= 9007199254740991

expected_head_seq

The head sequence required by the request.

integer format: int64

<= 9007199254740991

expected_inode_id

The request expected the path to contain this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

expected_revision_no

Revision the request expected to be current.

integer format: int64

<= 9007199254740991

fenced_writer_epoch

Epoch the failing writer session held when it was displaced.

integer format: int64

<= 9007199254740991

inode_id

Inode the failed precondition or operation targeted.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

max_writer_sessions

Maximum writer sessions admitted by the node.

integer

namespace_id

The deleted namespace that caused the operation to fail.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

operation_index

The index of the failed operation in the request.

integer format: int32

precondition_index

Zero-based position of the failed request precondition.

integer format: int32

retention_floor_seq

Oldest sequence still promised for incremental replay.

integer format: int64

<= 9007199254740991

feature

The capability feature key for a not_supported error.

string

message

required

Human-readable error message.

string

param

The invalid JSON Pointer, parameter name, CLI flag, or CLI argument.

string

request_id

The request correlation ID also sent in the x-request-id response header.

string

501

Inline content is disabled

HTTP error body used by LoonFS APIs.

object

code

required

The stable machine-readable error code as a string.

string

details

The optional machine-readable context for the error code.

object

active_acquired_at_ms

The Unix-millisecond time when the current writer acquired its epoch, when available.

integer format: int64

active_writer_epoch

Epoch that currently owns the namespace.

integer format: int64

<= 9007199254740991

active_writer_id

The writer ID recorded for the current epoch, when available.

string

actual_access_revision_no

Access revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_attributes_revision_no

Attribute revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_binding_version

Current binding token; absent for the root, which has no binding.

string

/^[0-9a-f]+$/

actual_deletion_seq

Deletion sequence actually active for the inode.

integer format: int64

<= 9007199254740991

actual_head_seq

The actual namespace head sequence.

integer format: int64

<= 9007199254740991

actual_inode_id

The path actually contained this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

actual_revision_no

Revision that is actually current; absent when the inode has none.

integer format: int64

<= 9007199254740991

after_seq

Change-feed cursor the request asked to resume after.

integer format: int64

<= 9007199254740991

commit_id

Idempotency key of the commit the error concerns.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

c_f3a9c2d4b6e8417a90c5d2f8e1b7a6c0

committed_fingerprint

The fingerprint of the mutation that landed under commit_id, present with committed_seq.

string

committed_seq

The sequence where this commit ID already landed, when recorded by a durable receipt.

integer format: int64

<= 9007199254740991

expected_access_revision_no

Access revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_attributes_revision_no

Attribute revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_binding_version

Opaque binding token supplied by the request.

string

/^[0-9a-f]+$/

expected_deletion_seq

Deletion sequence the undelete expected to be active.

integer format: int64

<= 9007199254740991

expected_head_seq

The head sequence required by the request.

integer format: int64

<= 9007199254740991

expected_inode_id

The request expected the path to contain this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

expected_revision_no

Revision the request expected to be current.

integer format: int64

<= 9007199254740991

fenced_writer_epoch

Epoch the failing writer session held when it was displaced.

integer format: int64

<= 9007199254740991

inode_id

Inode the failed precondition or operation targeted.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

max_writer_sessions

Maximum writer sessions admitted by the node.

integer

namespace_id

The deleted namespace that caused the operation to fail.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

operation_index

The index of the failed operation in the request.

integer format: int32

precondition_index

Zero-based position of the failed request precondition.

integer format: int32

retention_floor_seq

Oldest sequence still promised for incremental replay.

integer format: int64

<= 9007199254740991

feature

The capability feature key for a not_supported error.

string

message

required

Human-readable error message.

string

param

The invalid JSON Pointer, parameter name, CLI flag, or CLI argument.

string

request_id

The request correlation ID also sent in the x-request-id response header.

string

503

The server cannot complete the request now. Inspect code to determine whether the cause is a deadline, shutdown, load, writer-session admission, required maintenance, or invalid storage credentials. A mutation may still complete after a deadline or lost acknowledgment, so determine its outcome before retrying.

HTTP error body used by LoonFS APIs.

object

code

required

The stable machine-readable error code as a string.

string

details

The optional machine-readable context for the error code.

object

active_acquired_at_ms

The Unix-millisecond time when the current writer acquired its epoch, when available.

integer format: int64

active_writer_epoch

Epoch that currently owns the namespace.

integer format: int64

<= 9007199254740991

active_writer_id

The writer ID recorded for the current epoch, when available.

string

actual_access_revision_no

Access revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_attributes_revision_no

Attribute revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_binding_version

Current binding token; absent for the root, which has no binding.

string

/^[0-9a-f]+$/

actual_deletion_seq

Deletion sequence actually active for the inode.

integer format: int64

<= 9007199254740991

actual_head_seq

The actual namespace head sequence.

integer format: int64

<= 9007199254740991

actual_inode_id

The path actually contained this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

actual_revision_no

Revision that is actually current; absent when the inode has none.

integer format: int64

<= 9007199254740991

after_seq

Change-feed cursor the request asked to resume after.

integer format: int64

<= 9007199254740991

commit_id

Idempotency key of the commit the error concerns.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

c_f3a9c2d4b6e8417a90c5d2f8e1b7a6c0

committed_fingerprint

The fingerprint of the mutation that landed under commit_id, present with committed_seq.

string

committed_seq

The sequence where this commit ID already landed, when recorded by a durable receipt.

integer format: int64

<= 9007199254740991

expected_access_revision_no

Access revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_attributes_revision_no

Attribute revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_binding_version

Opaque binding token supplied by the request.

string

/^[0-9a-f]+$/

expected_deletion_seq

Deletion sequence the undelete expected to be active.

integer format: int64

<= 9007199254740991

expected_head_seq

The head sequence required by the request.

integer format: int64

<= 9007199254740991

expected_inode_id

The request expected the path to contain this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

expected_revision_no

Revision the request expected to be current.

integer format: int64

<= 9007199254740991

fenced_writer_epoch

Epoch the failing writer session held when it was displaced.

integer format: int64

<= 9007199254740991

inode_id

Inode the failed precondition or operation targeted.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

max_writer_sessions

Maximum writer sessions admitted by the node.

integer

namespace_id

The deleted namespace that caused the operation to fail.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

operation_index

The index of the failed operation in the request.

integer format: int32

precondition_index

Zero-based position of the failed request precondition.

integer format: int32

retention_floor_seq

Oldest sequence still promised for incremental replay.

integer format: int64

<= 9007199254740991

feature

The capability feature key for a not_supported error.

string

message

required

Human-readable error message.

string

param

The invalid JSON Pointer, parameter name, CLI flag, or CLI argument.

string

request_id

The request correlation ID also sent in the x-request-id response header.

string