Skip to main content
POST
/
{team_id}
/
pages
Create a new page
curl --request POST \
  --url https://api.superthread.com/v1/{team_id}/pages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "3",
  "title": "Team Page",
  "content": "<string>",
  "content_format": "html",
  "schema": 1,
  "font": "<string>",
  "parent_page_id": "44",
  "position": 3,
  "is_public": false
}
'
{
  "page": {
    "id": "43",
    "alias_id": "93738022-c193-494e-95a4-fc3e4346b5e1",
    "title": "Team Page",
    "font": "sans",
    "content": "<string>",
    "schema": 1,
    "collaboration": {
      "token": "<string>"
    },
    "project_id": "1",
    "user_id": "u-dsu0j19",
    "user_id_updated": "u-dsu0j19",
    "user": {
      "user_id": "uDsu0j19",
      "type": "user",
      "source": {
        "type": "oauth",
        "client_id": "oczapier",
        "import_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
        "agent_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
        "email_addr": "somebody@example.com",
        "email_verified": false
      }
    },
    "user_updated": {
      "user_id": "uDsu0j19",
      "type": "user",
      "source": {
        "type": "oauth",
        "client_id": "oczapier",
        "import_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
        "agent_id": "bf1b9f76-3f95-42fc-bd7f-050b2f5f4197",
        "email_addr": "somebody@example.com",
        "email_verified": false
      }
    },
    "team_id": "teu-dsu0j19",
    "time_created": 1608742037016,
    "time_updated": 1608742037016,
    "members": [
      {
        "user_id": "u-dsu0j19",
        "assigned_date": 1608742037016,
        "role": "admin"
      }
    ],
    "bookmarked": false,
    "archived": {
      "user_id": "uDsu0j19",
      "time_archived": 1608742037016,
      "parent_page_id": "<string>"
    },
    "is_public": false,
    "public_settings": {
      "url": "https://pages.superthread.com/t/team/p/1",
      "robots": [
        "all"
      ]
    },
    "total_comments": 3,
    "is_watching": true,
    "is_bookmarked": true,
    "hide_table_of_contents": true,
    "hide_subpages": true
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
team_id
string
required

Team ID is an alphanumerical string that identifies a Team. This is externally referred to as a "Workspace".

Body

application/json

Page object that needs to be created

​
project_id
string
required
Example:

"3"

​
title
string
Example:

"Team Page"

​
content
string
Maximum string length: 102400
​
content_format
enum<string>
default:html

Format of the content field. When set to 'markdown', the server converts the content from GitHub Flavored Markdown to HTML before storage. Defaults to 'html'.

Available options:
html,
markdown
​
schema
integer | null
Example:

1

​
font
string
​
cover_image
object
​
icon
object
​
parent_page_id
string | null

Parent page ID this page should be placed under. Send an empty string to place the page at the root of the project

Example:

"44"

​
position
integer | null

a position where the page should be placed in relation to its siblings

Example:

3

​
is_public
boolean | null
Example:

false

Response

page created

​
page
object