---
title: "Update file metadata (skills zone only)"
method: PATCH
path: "/agents/files/{fileId}"
tags: ["Files"]
---

# Update file metadata (skills zone only)

`PATCH /agents/files/{fileId}`

## Request

- Base URL: `https://api.mobilerun.ai`
- URL: `https://api.mobilerun.ai/agents/files/{fileId}`
- Auth: HTTP bearer

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

## Path parameters

- `fileId` string, uuid, required

## Request body

- object
  - `displayName` string, nullable
  - `enabled` boolean

## Response `200`

Updated file

- object
  - `fileId` string, uuid, required
  - `filename` string, required
  - `displayName` string, nullable, required
  - `mimeType` string, required
  - `sizeBytes` number, required
  - `zone` 'user' | 'agent' | 'workflow' | 'skills', required
  - `enabled` boolean, required
  - `createdAt` string, date-time, required
  - `createdBy` 'user' | 'agent' | 'workflow', required
  - `collectionStatus` union
    - object
      - `version` 1, required
      - `completeness` 'complete' | 'partial' | 'none' | 'unknown', required
      - `coverage` 'exhaustive' | 'bounded' | 'unknown', required
      - `endReached` boolean, required
      - `resumable` boolean, required
      - `records` object, required
        - `reported` integer, required
        - `unit` string, required
    - object
      - `version` 1, required
      - `completeness` 'unknown', required
      - `coverage` 'unknown', required
      - `endReached` false, required
      - `resumable` false, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `422`: Zone is not mutable
- `500`: Internal Server Error

## Changes

- **2026-10-16** `4ad548c528a8`: 1 info
  - endpoint added
- **2026-06-18** `e61cfb7119bc`: 1 breaking
  - api path removed without deprecation
- **2026-06-09** `00b02e335076`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/droidrun/apis/droidrun-cloud/changes/agents/files/:fileId/patch.md)

---

[API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) - [All operations](https://skmtc.dev/droidrun/apis/droidrun-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/droidrun/apis/droidrun-cloud/revisions/1cc95586c933?raw)