The workspace object

• object string: "workspace"

• id uuid

• teamId uuid

• name string

• defaultView string: The view the workspace opens in by default. One of "list", "board", "table", or "graph".

• createdAt date

• createdUserId uuid

• fields Array[Field]

• childIds Array[uuid]: An array of all the top level item and collection IDs in the workspace.

Get workspaces

Endpoint: GET /v0/workspaces

Query parameters:

• teamId uuid (optional): Filter workspaces that belong to the given team.

• limit integer (optional, default: 100): Number between 1 and 100 to limit the results.

• after uuid (optional): Only return workspaces that come after the given workspace ID (used for pagination usually in combination with the limit parameter).

Example request

curl https://api.nuclino.com/v0/workspaces?limit=2 \
  -H "Authorization: YOUR_API_KEY"

Example response

{
  "status": "success",
  "data": {
    "object": "list",
    "results": [
      {
        "object": "workspace",
        "id": "127a8c4a-b3c6-4a42-8fef-b6c521e6c8cf",
        "teamId": "020f9737-7b21-442b-85eb-bd420e5593b2",
        "name": "General",
        "defaultView": "list",
        "createdAt": "2021-12-15T15:54:23.598Z",
        "createdUserId": "2e96f3bb-c742-4164-af2c-151ab2fd346b",
        "fields": [
          {
            "object": "field",
            "id": "1504df6f-5704-43e9-9af9-79ed801828d8",
            "type": "date",
            "name": "My date field"
          }
        ],
        "childIds": ["aaf6d580-565d-497b-9ff3-b32075de3f4c"]
      },
      {
        "object": "workspace",
        "id": "66be346f-44e2-49da-888b-a2e381d4d92a",
        "teamId": "020f9737-7b21-442b-85eb-bd420e5593b2",
        "name": "Sprint planning",
        "defaultView": "board",
        "createdAt": "2021-12-15T15:54:05.085Z",
        "createdUserId": "2e96f3bb-c742-4164-af2c-151ab2fd346b",
        "fields": [],
        "childIds": []
      }
    ]
  }
}

Get workspace

Endpoint: GET /v0/workspaces/:id

Example request

curl https://api.nuclino.com/v0/workspaces/127a8c4a-b3c6-4a42-8fef-b6c521e6c8cf \
  -H "Authorization: YOUR_API_KEY"

Example response

{
  "status": "success",
  "data": {
    "object": "workspace",
    "id": "127a8c4a-b3c6-4a42-8fef-b6c521e6c8cf",
    "teamId": "020f9737-7b21-442b-85eb-bd420e5593b2",
    "name": "General",
    "defaultView": "list",
    "createdAt": "2021-12-15T15:54:23.598Z",
    "createdUserId": "2e96f3bb-c742-4164-af2c-151ab2fd346b",
    "fields": [
      {
        "object": "field",
        "id": "1504df6f-5704-43e9-9af9-79ed801828d8",
        "type": "date",
        "name": "My date field"
      }
    ],
    "childIds": ["aaf6d580-565d-497b-9ff3-b32075de3f4c"]
  }
}

Create a workspace

Endpoint: POST /v0/workspaces

Creates a new, empty workspace. You are added as its first member.

Body:

• teamId uuid: The ID of the team where the workspace should be created.

• name string: The name of the workspace. It may only contain letters, numbers, and spaces (max. 30 characters).

• kind string (optional, default: "public"): Either "public" or "private". Public workspaces are visible to all team members. Private workspaces are only visible to their members.

• defaultView string (optional, default: "list"): The view the workspace opens in by default. One of "list", "board", "table", or "graph".

Creating a workspace requires team membership. If your team restricts workspace creation to owners and admins, the request is rejected with a 403. Names with unsupported characters are rejected with a 422. Use the Fields endpoints to add fields to the new workspace.

Example request

curl https://api.nuclino.com/v0/workspaces \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"teamId":"020f9737-7b21-442b-85eb-bd420e5593b2", "name":"Roadmap", "defaultView":"board"}'

Example response

{
  "status": "success",
  "data": {
    "object": "workspace",
    "id": "5f2c0a7e-9d1b-4c3e-8a6f-2b7d4e1c9a35",
    "teamId": "020f9737-7b21-442b-85eb-bd420e5593b2",
    "name": "Roadmap",
    "defaultView": "board",
    "createdAt": "2026-10-20T14:05:12.481Z",
    "createdUserId": "2e96f3bb-c742-4164-af2c-151ab2fd346b",
    "fields": [],
    "childIds": []
  }
}

Update a workspace

Endpoint: PUT /v0/workspaces/:id

Renames a workspace and/or changes its default view.

Body:

• name string (optional): The new name of the workspace. It may only contain letters, numbers, and spaces (max. 30 characters).

• defaultView string (optional): The view the workspace opens in by default. One of "list", "board", "table", or "graph".

At least one of name or defaultView must be provided. Updating a workspace requires edit access to it (403). Names with unsupported characters are rejected with a 422.

Example request

curl https://api.nuclino.com/v0/workspaces/66be346f-44e2-49da-888b-a2e381d4d92a \
  -X PUT \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Sprint board", "defaultView":"table"}'

Example response

{
  "status": "success",
  "data": {
    "object": "workspace",
    "id": "66be346f-44e2-49da-888b-a2e381d4d92a",
    "teamId": "020f9737-7b21-442b-85eb-bd420e5593b2",
    "name": "Sprint board",
    "defaultView": "table",
    "createdAt": "2021-12-15T15:54:05.085Z",
    "createdUserId": "2e96f3bb-c742-4164-af2c-151ab2fd346b",
    "fields": [],
    "childIds": []
  }
}