---
title: "Create Board"
method: POST
path: "/boards/create"
tags: ["Board"]
---

# Create Board

`POST /boards/create`

Create a new Board for the current user.

## Headers

- `Topview-Uid` string, required
- `Authorization` string, required

## Request body

- object
  - `name` string, required — Board name (required, max 200 characters)

## Response `200`

Board created successfully

- object
  - `code` string
  - `message` string
  - `result` object
    - `boardId` string — Board business ID
    - `name` string — Board name
    - `uid` string — Owner user ID
    - `ownerName` string — Owner name
    - `taskCount` integer — Number of tasks in this Board
    - `recentThumbnails` string[], nullable — Recent task thumbnails
    - `members` unknown[], nullable — List of Board members
      - unknown
    - `shareTokens` unknown[], nullable — List of share tokens
      - unknown
    - `isSystemDefault` boolean, nullable — Whether this is a system default Board
    - `syncFlag` boolean, nullable — Sync status
    - `gmtCreate` string, date-time, nullable — Creation timestamp
    - `gmtModify` string, date-time, nullable — Last modification timestamp
    - `isOwner` boolean, nullable — Whether current user is the Board owner

---

[API](https://skmtc.net/topview/apis/image-character-swap-apis-editable-in-readme.md) · [All operations](https://skmtc.net/topview/apis/image-character-swap-apis-editable-in-readme/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/topview/image-character-swap-apis-editable-in-readme/versions/83cd46ca7859/schema)