Work

Save Work Channel Canvas

Replace one channel's Canvas from its content. Signed server-side.

The counterpart of the published GET on this path. It is the app's POST (bare content, revision authored server-side with the caller's derived key), not the PUT that accepts a client-SIGNED event, which a machine principal has no signing story for.

baseRevisionId is a compare-and-swap: send the revisionId the GET gave you, omit it to skip the check, or send "" to assert no canvas existed. 403 when the caller may not edit the channel; 409 for an archived channel, a replayed key with a different body, or a stale baseRevisionId.

post/work/channels/{channel_id}/canvas

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/work/channels/{channel_id}/canvas
  • Auth: HTTP bearer

Path parameters

channel_idstring required

Channel id or slug

Headers

Idempotency-Keystring nullable

Retry-safety key. Replaying one returns the ORIGINAL result with duplicate: true instead of writing twice. Omit it and the server mints a single-use key, which means a retried request writes again — send your own for anything you may retry.

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

contentstring required
baseRevisionIdstring nullable

Response

Successful Response

Changes

No recorded changes to this operation across all 2 revisions of this API.