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

# Update Folder Permissions

> Updates the client access level on a folder. Requires internal-user privileges. On the Internal API the change cascades to all descendant folders; on the Platform API only the target folder is updated.



## OpenAPI

````yaml /api-reference/openapi.json put /v1/files/{id}/permissions/
openapi: 3.0.0
info:
  contact: {}
  title: Assembly API
  version: 0.0.1
servers:
  - url: https://api.assembly.com
security: []
paths:
  /v1/files/{id}/permissions/:
    put:
      tags:
        - Files
      summary: Update Folder Permissions
      description: >-
        Updates the client access level on a folder. Requires internal-user
        privileges. On the Internal API the change cascades to all descendant
        folders; on the Platform API only the target folder is updated.
      operationId: put_v1files{id}permissions
      parameters:
        - description: ID of the folder to update
          in: path
          name: id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/handler.UpdateFolderPermissionsRequest'
        description: Folder permissions to apply
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.SuccessResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: >-
            Invalid request body, missing clientPermissions, or target is not a
            folder
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: >-
            Caller lacks internal-user privileges or access to the folder's
            company
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: Folder not found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/dispatcher.Error'
          description: Unexpected server error
      security:
        - APIKeyHeader: []
components:
  schemas:
    handler.UpdateFolderPermissionsRequest:
      properties:
        clientPermissions:
          description: Client access level applied to the folder. Required.
          enum:
            - read_only read_write
          example: read_only
          type: string
      required:
        - clientPermissions
      type: object
    handler.SuccessResponse:
      properties:
        success:
          description: Whether the operation succeeded.
          example: true
          type: boolean
      type: object
    dispatcher.Error:
      properties:
        code:
          type: string
        data: {}
        message:
          type: string
      type: object
  securitySchemes:
    APIKeyHeader:
      in: header
      name: X-API-KEY
      type: apiKey

````