---
title: "Edit asset folder sharing and applicability"
method: PATCH
path: "/knowledge/asset-folders/{folderId}"
---

# Edit asset folder sharing and applicability

`PATCH /knowledge/asset-folders/{folderId}`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/knowledge/asset-folders/{folderId}`
- Auth: HTTP bearer

Patch only supplied folder fields. null propertyId makes the folder global; empty description clears it. Scope changes propagate to members. active=false disables sharing and revokes folder links under existing rules. Read folder and member assets after saving. Required permission: knowledge:write. Connected business only; no tenant override.

## Path parameters

- `folderId` string, required

## Request body

- KnowledgeAssetFolderUpdateInput
  - `title` string
  - `description` string
  - `propertyId` string, nullable
  - `active` boolean

## Response `200`

Success

- KnowledgeAssetFolderResult
  - `folder` KnowledgeAssetFolder, required
    - `folderId` string, required
    - `title` string, required
    - `description` string
    - `propertyId` string
    - `propertyName` string
    - `active` boolean, required
    - `shareTokenVersion` integer, required
    - `assetOrder` string[], required
    - `assetCount` integer, required
    - `createdAt` string
    - `updatedAt` string

## Other responses

- `400`: Invalid request
- `403`: Missing permission
- `404`: Resource not found
- `409`: Conflict; read state and reconcile

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)