xvfs
Operations of the Xema Shell API. Paths are relative to your deployment's API host.
GET /api/xema-shell-api/xvfs/resolve
Resolve an XVFS path to a XemaObject
Parses an XVFS path and delegates to object-registry-api for the underlying XemaObject snapshot.
Authentication: bearer token (Authorization: Bearer <token>)
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
path | query | string | yes | XVFS path to resolve. |
| Status | Description | Body |
|---|---|---|
| 200 | application/json XvfsResolvedDtoDataEnvelope |
POST /api/xema-shell-api/xvfs/write
Write/upsert an object at an XVFS path (capability-gated)
Parses an XVFS path, checks xema:object.write@1 via xema-capability-router, then upserts the object in object-registry-api. Returns whether the object was created or updated.
Authentication: bearer token (Authorization: Bearer <token>)
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
path | query | string | yes | XVFS path to write to (e.g. /orgs/acme/projects/support/agent/code-reviewer). |
Request body: application/json XvfsWriteBodyDto
| Status | Description | Body |
|---|---|---|
| 201 | application/json XvfsWriteResultDtoDataEnvelope |