Surfaces

Add a surface (tab)

Changed on

Append a new surface to the workspace. Editor role required.

post/api/workspaces/{slug}/surfaces

Request

  • Base URL
    https://trydock.ai
  • Auth
    HTTP bearer

Path parameters

slugstring required

Request body

kind'table' | 'doc' required

Whether this tab is a typed-row table or a TipTap rich-text doc.

namestring

Display name. Auto-generated if omitted.

slugstring

URL slug. Auto-derived from name if omitted.

Response

Created.

Example response

{
  "surface": {
    "id": "srf_01J5Z…",
    "slug": "table-2",
    "name": "Backlog"
  }
}

Changes

    • info

      added the new optional request property //

    • info

      added the optional property /// to the response with the status