---
title: "Update a data source view"
method: PATCH
path: "/api/w/{wId}/spaces/{spaceId}/data_source_views/{dsvId}"
tags: ["Private Spaces"]
---

# Update a data source view

`PATCH /api/w/{wId}/spaces/{spaceId}/data_source_views/{dsvId}`

Updates a specific data source view.

## Path parameters

- `wId` string, required
- `spaceId` string, required
- `dsvId` string, required

## Request body

- object
  - `parentsIn` string[], nullable

## Response `200`

Success

- object
  - `dataSourceView` PrivateDataSourceView — A view on a data source within a space.
    - `sId` string, required
    - `id` integer, required
    - `category` 'managed' | 'folder' | 'website' | 'apps', required
    - `kind` 'default' | 'custom', required
    - `spaceId` string, required
    - `createdAt` integer
    - `updatedAt` integer
    - `parentsIn` string[], nullable — List of parent IDs included in this view, null if the full data source is used
    - `dataSource` PrivateDataSource, required — A data source in the workspace.
      - `sId` string, required
      - `id` integer, required
      - `createdAt` integer
      - `name` string, required
      - `description` string, nullable
      - `assistantDefaultSelected` boolean
      - `dustAPIProjectId` string
      - `dustAPIDataSourceId` string
      - `connectorId` string, nullable
      - `connectorProvider` string, nullable
    - `editedByUser` object, nullable
      - `editedAt` integer, nullable
      - `fullName` string, nullable
      - `imageUrl` string, nullable
      - `email` string, nullable
      - `userId` string, nullable
    - `usage` object — Present when the view was fetched with usage details (withDetails query param). Counts agents and skills that use this data source view.
      - `count` integer
      - `agents` object[]
        - `sId` string
        - `name` string
        - `pictureUrl` string
      - `skills` object[]
        - `sId` string
        - `name` string
        - `icon` string, nullable
  - `connector` object, nullable

## Other responses

- `401` — Unauthorized

## Changes

- **2026-08-18** `af64794169ac` — 1 info
  - added the optional property `dataSourceView/usage` to the response with the `200` status

[Change history](https://skmtc.dev/dust-tt/apis/dust-api-documentation/changes/api/w/:wId/spaces/:spaceId/data_source_views/:dsvId/patch.md)

---

[API](https://skmtc.dev/dust-tt/apis/dust-api-documentation.md) · [All operations](https://skmtc.dev/dust-tt/apis/dust-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dust-tt/dust-api-documentation/revisions/957ecf7d86f2/schema)