Ask
Type to search
Endpoints

Workspace Settings

Each workspace has a set of settings associated with it. They configure workspace-wide options for all members. This includes metadata and content formatting options, your Prettier config, and the configuration of your dashboard views. The API enables you to retrieve and configure these settings.

Retrieve Workspace Settings

Retrieves workspace settings.

GET
/workspace-settings
Response object
idstring

ID of the workspace settings

prettierConfigstring

JSON-stringified Prettier configuration

idstring

ID of the column in the table view

widthnumber

Width of the column in the table view

canonicalLinkPatternstring

Pattern for auto-generating canonical link for content pieces

enabledFieldsstring[]

Enabled content piece metadata fields

marksstring[]

Enabled inline formatting options

blocksstring[]

Enabled block content types

embedsstring[]

Enabled embeds

Request
Response
{
  "id": "93b51ca88b6f80085ddb7b4c",
  "prettierConfig": "string",
  "dashboardViews": {
    "table": [
      {
        "id": "string",
        "width": 0
      }
    ]
  },
  "metadata": {
    "canonicalLinkPattern": "string",
    "enabledFields": [
      "slug"
    ]
  },
  "marks": [
    "bold"
  ],
  "blocks": [
    "heading1"
  ],
  "embeds": [
    "codepen"
  ]
}

Update Workspace Settings

Updates workspace settings using the provided data.

PUT
/workspace-settings
Body Parameters
prettierConfigstring

JSON-stringified Prettier configuration

idstring

ID of the column in the table view

widthnumber

Width of the column in the table view

canonicalLinkPatternstring

Pattern for auto-generating canonical link for content pieces

enabledFieldsstring[]

Enabled content piece metadata fields

marksstring[]

Enabled inline formatting options

blocksstring[]

Enabled block content types

embedsstring[]

Enabled embeds

Response 200
Request