TRtrydock
Workspaces

Create a workspace

Create a new workspace. Returns the created row. The caller becomes its owner. Visibility defaults to the org's default if omitted.

post/api/workspaces

Request

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

Request body

namestring required
slugstring

URL slug. Auto-derived from name if omitted. Must be unique within the org.

mode'table' | 'doc'

Default table. Auto-resolves to doc if initialMarkdown is set.

visibility'private' | 'org' | 'unlisted' | 'public'

Inherits the org's default visibility if omitted.

initialMarkdownstring

Seed the doc body in the same call. Mode auto-resolves to doc. Supports CommonMark + GFM + Dock's rich format set (mermaid, math, callouts, cross-refs, embeds).

Example request

{
  "name": "Launch plan",
  "slug": "launch-plan"
}

Response

Created.

Example response

{
  "workspace": {
    "id": "ws_01J5Z6Q7…",
    "slug": "launch-plan",
    "name": "Launch plan",
    "primarySurface": {
      "id": "srf_01J5Z…",
      "slug": "table"
    }
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.