Developers

Build on the workspace your team already uses.

APIs, SDKs, webhooks, and OAuth — everything you need to extend Workspace Canvas.

⌨️🔌🧩
canvas-sdk · POST /v1/pages
import { Canvas } from "@workspacecanvas/sdk";

const canvas = new Canvas({ token: process.env.CANVAS_TOKEN });

const page = await canvas.pages.create({
  parent: "teamspace/eng",
  title: "Launch checklist",
  blocks: [
    { type: "h1", text: "Ship v4.2" },
    { type: "todo", text: "Cut release branch" },
    { type: "todo", text: "Notify #announce" },
  ],
});

await canvas.webhooks.on("page.updated", async (e) => {
  await notifySlack(e.page.title);
});
→ POST /v1/pages 201 Created
{
"id": "pg_9F7c…",
"url": "canvas.app/p/launch",
"blocks": 3,
"created_by": "sam@acme.com"
}
→ webhook page.updated
delivered · 84ms · Slack #announce ✓
Building on Workspace Canvas
LinearLoomHeightRaycastCronPitch
REST + typed SDKs

One API for pages, blocks, databases, and comments.

First-class SDKs for TypeScript, Python, and Go. Full type coverage, cursor pagination, and clean error surfaces — so you can move from prototype to production without rewriting your client.

  • Typed clients for TS / Python / Go
  • Cursor pagination on every list
  • Idempotent writes
  • Structured errors with request IDs
Webhooks & events

React to changes the moment they happen.

Subscribe to page, block, task, and database events. Signed payloads, automatic retries, and a live event log make debugging fast.

  • Signed HMAC payloads
  • At-least-once delivery + retries
  • Live event log & replay
  • Per-teamspace filters
Auth built for apps

OAuth 2.0 that respects your users' workspace.

Ship public integrations that install per-workspace with granular scopes. Rotate tokens, revoke keys, and audit every request from the developer console.

  • OAuth 2.0 with PKCE
  • Granular scopes per resource
  • Per-workspace install & uninstall
  • Rotate & revoke without downtime
Integrations marketplace

Publish once, reach every Workspace Canvas team.

Distribute your integration in the marketplace, or keep it private to your workspace. Rich install flows, review analytics, and versioned rollouts included.

  • Public or private listings
  • Versioned rollouts
  • Install analytics
  • Reviewed for security & privacy
curl-first
Every endpoint documented with copyable examples.
Versioned
Non-breaking updates, migration guides for the rest.
Secure by default
Signed webhooks, scoped tokens, audit logs.
"We shipped our Workspace Canvas integration in a weekend. The SDK is the cleanest we've used."
Priya Shah · Founding engineer, Field Report