Skip to main content
PUT
Write Canvas file

Authorizations

Authorization
string
header
required

Organization or personal API key from Settings → API Keys.

Headers

X-Replicas-Api-Version
enum<string>

API version. 2026-10-07 returns snake_case responses. See versioning.

Available options:
2026-10-07

Path Parameters

id
string<uuid>
required

Replica ID

filename
string
required

Path within the Canvas, URL-encoded

Body

application/json
content
string
required

Complete replacement text.

expected_revision
string
required

SHA-256 revision returned when the file was read.

Pattern: ^[a-f0-9]{64}$

Response

Success

saved
boolean
required
revision
string
required
Pattern: ^[a-f0-9]{64}$
size_bytes
integer
required
Required range: x >= 0