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

# Update file metadata (skills zone only)

> Partial update of `displayName` and/or `enabled`. Only files with `zone=skills` are mutable; other zones return 422 `unsupported_zone`.



## OpenAPI

````yaml /api-reference/mobilerun-va-chat.yaml patch /agents/files/{fileId}
openapi: 3.1.0
info:
  title: Mobilerun VA Chat
  version: v1
servers:
  - description: Droidrun Cloud API
    url: https://api.mobilerun.ai/v1
security:
  - bearerAuth: []
paths:
  /agents/files/{fileId}:
    patch:
      tags:
        - Files
      summary: Update file metadata (skills zone only)
      description: >-
        Partial update of `displayName` and/or `enabled`. Only files with
        `zone=skills` are mutable; other zones return 422 `unsupported_zone`.
      operationId: filesUpdate
      parameters:
        - in: path
          name: fileId
          required: true
          schema:
            format: uuid
            type: string
      requestBody:
        content:
          application/json:
            schema:
              properties:
                displayName:
                  maxLength: 255
                  minLength: 1
                  type:
                    - string
                    - 'null'
                enabled:
                  type: boolean
              type: object
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  createdAt:
                    format: date-time
                    type: string
                  createdBy:
                    enum:
                      - user
                      - agent
                      - workflow
                    type: string
                  displayName:
                    type:
                      - string
                      - 'null'
                  enabled:
                    type: boolean
                  fileId:
                    format: uuid
                    type: string
                  filename:
                    type: string
                  mimeType:
                    type: string
                  sizeBytes:
                    type: number
                  zone:
                    enum:
                      - user
                      - agent
                      - workflow
                      - skills
                    type: string
                required:
                  - fileId
                  - filename
                  - displayName
                  - mimeType
                  - sizeBytes
                  - zone
                  - enabled
                  - createdAt
                  - createdBy
                type: object
          description: Updated file row
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '404':
          content:
            application/json:
              schema:
                properties:
                  message:
                    type: string
                required:
                  - message
                type: object
          description: >-
            Not found (also used when caller is not owner to avoid ID-existence
            leak)
        '422':
          content:
            application/json:
              schema:
                properties:
                  error:
                    enum:
                      - unsupported_zone
                    type: string
                  message:
                    type: string
                required:
                  - error
                  - message
                type: object
          description: Zone is not mutable
        '500':
          description: Internal Server Error
      x-codeSamples:
        - lang: JavaScript
          source: >-
            import Mobilerun from '@mobilerun/sdk';


            const client = new Mobilerun({
              apiKey: process.env['MOBILERUN_CLOUD_API_KEY'], // This is the default and can be omitted
            });


            const file = await
            client.files.update('182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e');


            console.log(file.createdAt);
        - lang: Python
          source: |-
            import os
            from mobilerun_sdk import Mobilerun

            client = Mobilerun(
                api_key=os.environ.get("MOBILERUN_CLOUD_API_KEY"),  # This is the default and can be omitted
            )
            file = client.files.update(
                file_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
            )
            print(file.created_at)
components:
  securitySchemes:
    bearerAuth:
      bearerFormat: Opaque
      description: Bearer token via Authorization header
      scheme: bearer
      type: http

````