REreplicas
Canvas

Write Canvas file

Replaces a text file. Pass expected_revision from Read Canvas file to avoid overwriting newer changes. The replica must be active.

put/v1/replica/{id}/canvas/{filename}

Request

  • Base URL
    https://api.replicas.dev
  • URL
    https://api.replicas.dev/v1/replica/{id}/canvas/{filename}
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

Replica ID

filenamestring required

Path within the Canvas, URL-encoded

Headers

X-Replicas-Api-Version'2026-10-07'

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

Request body

contentstring required

Complete replacement text.

expected_revisionstring required

SHA-256 revision returned when the file was read.

Response

Success

OR

Changes

No recorded changes to this operation across all 1 revision of this API.