Create a teamspace

POST/v1/workspaces/{workspaceId}/teamspaces

You become its owner. Guests cannot create teamspaces.

Request

curl -X POST "https://api.lydie.co/v1/workspaces/01JCQ3TZ0WJ8K4M2X7T9R6N1PA/teamspaces" \
  -H "Authorization: Bearer $LYDIE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Notes"
  }'

Path parameters

workspaceIdstringrequired· 1–64 chars

Body

idstring· 1–64 chars
Client-minted id. Generated when omitted.
namestringrequired· 1–100 chars
descriptionstring· ≤ 2000 chars
Default ""
iconstringor null· ≤ 100 chars
Default null
visibilitystring
One ofopenclosedprivate
Default "open"
isDefaultboolean
Default false

Response

idstring· 1–64 chars
workspaceIdstring· 1–64 chars
namestring
descriptionstring
iconstringor null
visibilitystring
One ofopenclosedprivate
isDefaultboolean
myRolestringor null
One ofownermember
createdAttimestamp
updatedAttimestamp
deletedAttimestampor nulloptional

200

{
  "id": "string",
  "workspaceId": "01JCQ3TZ0WJ8K4M2X7T9R6N1PA",
  "name": "Notes",
  "description": "string",
  "icon": null,
  "visibility": "open",
  "isDefault": false,
  "myRole": null,
  "createdAt": "2026-11-12T09:30:00.000Z",
  "updatedAt": "2026-11-12T09:30:00.000Z",
  "deletedAt": null
}

Errors use one envelope for every endpoint. See Errors and versions.