Skip to main content
PUT
Update Canvas Item

Authorizations

Authorization
string
header
required

API key authentication. Obtain your API key from the Replicas dashboard under Organization → Settings → API Keys.

Path Parameters

workspaceId
string<uuid>
required
filename
string
required

Canvas-relative file path. Encode / as %2F in the request URL.

Example:

"reports/q3/summary.md"

Body

application/json
content
string
required

Complete replacement text.

expectedRevision
string
required

SHA-256 revision returned when the file was read.

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

Response

File saved, or current file returned after a concurrent change

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