---
title: "Append Workspace File"
method: POST
path: "/api/files/append"
tags: ["workspace-files"]
---

# Append Workspace File

`POST /api/files/append`

## Request body

- WorkspaceFileAppendRequest
  - `path` string, required
  - `content` string, required
  - `expected_sha256` string, nullable

## Response `200`

Successful Response

- WorkspaceFileEntryResponse
  - `path` string, required
  - `kind` 'file' | 'directory', required
  - `byte_size` integer, nullable
  - `modified_at` string, nullable
  - `checksum_sha256` string, nullable

## Other responses

- `400` — Workspace file request is invalid
- `404` — Workspace file not found
- `409` — Workspace file precondition did not match
- `422` — Validation Error
- `503` — Workspace files are unavailable

## Changes

- **2026-09-14** `571850c93e2c` — 4 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `404`
  - added the non-success response with the status `409`
  - added the non-success response with the status `503`
- **2026-07-25** `7a85443866b7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/qredence/apis/fleet-rlm/changes/api/files/append/post.md)

---

[API](https://skmtc.dev/qredence/apis/fleet-rlm.md) · [All operations](https://skmtc.dev/qredence/apis/fleet-rlm/llms.txt) · [OpenAPI document](https://skmtc.dev/qredence/apis/fleet-rlm/revisions/6109fdb187b9?raw)