> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nuwacom.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update an asset

> Update mutable asset metadata (name, connector assignment, metadata JSON, file path info, etc.) without re-uploading the file itself.



## OpenAPI

````yaml /openapi.yaml patch /api/kb/assets/{spaceId}/{assetId}
openapi: 3.1.0
info:
  title: Nuwacom API
  description: API for Nuwacom application
  version: 1.0.0
servers:
  - url: https://{customer-tenant}.nuwacom.ai/
    description: Nuwacom API
security:
  - bearerAuth: []
paths:
  /api/kb/assets/{spaceId}/{assetId}:
    patch:
      tags:
        - Assets
      summary: Update an asset
      description: >-
        Update mutable asset metadata (name, connector assignment, metadata
        JSON, file path info, etc.) without re-uploading the file itself.
      operationId: patchApiKbAssetsBySpaceIdByAssetId
      parameters:
        - in: path
          name: spaceId
          schema:
            anyOf:
              - type: string
                minLength: 2
                maxLength: 6
              - type: string
                minLength: 21
                maxLength: 21
            description: >-
              Space identifier for the asset you are trying to read, update, or
              delete.
          required: true
        - in: path
          name: assetId
          schema:
            type: string
            format: uuid
            description: >-
              The asset UUID that uniquely identifies the record within the
              database.
          required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                connectorId:
                  type: number
                  description: >-
                    Identifier of the connector (e.g., SharePoint, Google Drive)
                    the asset belongs to.
                metadata:
                  type: object
                  additionalProperties:
                    path: /api/subscription/paid-seats-left/{organizationId}
                  description: >-
                    JSON metadata string that will be stored alongside the asset
                    (e.g., author, custom tags).
                path:
                  type: array
                  items:
                    type: string
                  description: >-
                    Hierarchical path (array of folder names) describing where
                    the asset lives in the connector.
                fetchAuth:
                  anyOf:
                    - type: object
                      properties:
                        type:
                          enum:
                            - basic
                        username:
                          type: string
                        password:
                          type: string
                      required:
                        - type
                        - username
                        - password
                    - type: object
                      properties:
                        type:
                          enum:
                            - bearer
                        token:
                          type: string
                      required:
                        - type
                        - token
                mimeType:
                  type: string
                  description: >-
                    MIME type of the remote asset (e.g., "application/pdf",
                    "text/plain").
                name:
                  type: string
                  description: >-
                    Optional display name for the asset. Defaults to the
                    filename if omitted.
              required: []
              description: >-
                Payload for updating existing assets. Only include the fields
                that need to change—leave everything else out.
      responses:
        '204':
          description: Asset metadata updated successfully.
        '403':
          description: Returned when the caller cannot update assets in this space.
        '404':
          description: Asset not found or belongs to another space.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````