---
title: "Create a workbench page from a template"
method: POST
path: "/v2/workspaces/{workspaceId}/workbench/pages"
tags: ["Workbench"]
---

# Create a workbench page from a template

`POST /v2/workspaces/{workspaceId}/workbench/pages`

## Request

- Base URL: `https://api.maevesocial.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maevesocial.com/v2/workspaces/{workspaceId}/workbench/pages`
- Auth: HTTP bearer

## Path parameters

- `workspaceId` string, required

## Request body

- CreateWorkbenchPageDto
  - `templateVersionId` string, uuid, required
  - `spaceId` string, uuid, nullable
  - `folderId` string, uuid, nullable
  - `title` string
  - `visibility` 'internal' | 'private', nullable

## Response `200`

- object
  - `data` union, required
    - object
      - `page` object, required
        - `id` string, uuid, required
        - `workspaceId` string, uuid, required
        - `pageType` 'document', required
        - `spaceId` string, uuid, nullable, required
        - `folderId` string, uuid, nullable, required
        - `title` string, required
        - `description` string, nullable, required
        - `visibility` 'internal' | 'private', required
        - `owner` object, nullable, required
          - `id` string, uuid, required
          - `displayName` string, required
          - `avatarUrl` string, nullable, required
        - `sortOrder` integer, required
        - `isFavourite` boolean, required
        - `lifecycle` object, required
          - `state` 'active' | 'archived' | 'deleted', required
          - `archivedAt` string, date-time, nullable, required
          - `deletedAt` string, date-time, nullable, required
        - `provenance` object, nullable, required
          - `templateId` string, uuid, required
          - `templateVersionId` string, uuid, required
          - `versionNumber` integer, required
        - `createdByUserId` string, uuid, nullable, required
        - `updatedByUserId` string, uuid, nullable, required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
        - `version` string, required
      - `surface` object, required
        - `type` 'document', required
        - `bodyHtml` string, required
        - `documentVersion` string, required
    - object
      - `page` object, required
        - `id` string, uuid, required
        - `workspaceId` string, uuid, required
        - `pageType` 'research', required
        - `spaceId` string, uuid, nullable, required
        - `folderId` string, uuid, nullable, required
        - `title` string, required
        - `description` string, nullable, required
        - `visibility` 'internal' | 'private', required
        - `owner` object, nullable, required
          - `id` string, uuid, required
          - `displayName` string, required
          - `avatarUrl` string, nullable, required
        - `sortOrder` integer, required
        - `isFavourite` boolean, required
        - `lifecycle` object, required
          - `state` 'active' | 'archived' | 'deleted', required
          - `archivedAt` string, date-time, nullable, required
          - `deletedAt` string, date-time, nullable, required
        - `provenance` object, nullable, required
          - `templateId` string, uuid, required
          - `templateVersionId` string, uuid, required
          - `versionNumber` integer, required
        - `createdByUserId` string, uuid, nullable, required
        - `updatedByUserId` string, uuid, nullable, required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
        - `version` string, required
      - `surface` object, required
        - `type` 'research', required
    - object
      - `page` object, required
        - `id` string, uuid, required
        - `workspaceId` string, uuid, required
        - `pageType` 'content_table', required
        - `spaceId` string, uuid, nullable, required
        - `folderId` string, uuid, nullable, required
        - `title` string, required
        - `description` string, nullable, required
        - `visibility` 'internal' | 'private', required
        - `owner` object, nullable, required
          - `id` string, uuid, required
          - `displayName` string, required
          - `avatarUrl` string, nullable, required
        - `sortOrder` integer, required
        - `isFavourite` boolean, required
        - `lifecycle` object, required
          - `state` 'active' | 'archived' | 'deleted', required
          - `archivedAt` string, date-time, nullable, required
          - `deletedAt` string, date-time, nullable, required
        - `provenance` object, nullable, required
          - `templateId` string, uuid, required
          - `templateVersionId` string, uuid, required
          - `versionNumber` integer, required
        - `createdByUserId` string, uuid, nullable, required
        - `updatedByUserId` string, uuid, nullable, required
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
        - `version` string, required
      - `surface` object, required
        - `type` 'content_table', required
        - `config` object, required
        - `version` string, required
  - `meta` object, nullable, required

---

[API](https://skmtc.dev/maevesocial/apis/maeve-social-api.md) · [All operations](https://skmtc.dev/maevesocial/apis/maeve-social-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maevesocial/apis/maeve-social-api/revisions/1b00fd7e4b15?raw)