Skip to main content
POST
Install template

Authorizations

Authorization
string
header
required

Clerk session JWT (deployments with Clerk auth) — validated per request (issuer + signature + lifetime + authorized-party). The internal Boardy tenant/member are resolved from the token's ACTIVE Clerk organization (org_id) → the Boardy tenant it maps to → this user's member in that tenant (#356). A token with no active organization is rejected; production never trusts spoofable X-Tenant-Id/X-Member-Id headers. The same normalized context backs the SPA, this OpenAPI surface, and MCP.

Headers

Idempotency-Key
string

AD-5 idempotency: a repeated mutation with the same key replays the prior result (no double-apply).

Body

application/json
workspaceId
null | string<uuid>
includeSampleData
boolean
default:false
includeDashboard
boolean
default:true
includeAgent
boolean
default:true
templateId
null | string

Response

Created

templateId
string
required
workspaceId
string<uuid>
required
boards
object[]
required
dashboards
object[]
required
docs
object[]
required
forms
object[]
required
agents
object[]
required
skipped
string[]
required