---
title: "Confirm a file upload by server-side HEAD validation"
method: POST
path: "/agents/files/{fileId}/confirm"
tags: ["Files"]
---

# Confirm a file upload by server-side HEAD validation

`POST /agents/files/{fileId}/confirm`

## Request

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

## Path parameters

- `fileId` string, uuid, required

## Response `200`

Upload confirmed and validated

- 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
  - `state` 'ready', required
  - `actualSizeBytes` number, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `410`: Upload reservation expired; request a new upload URL.
- `422`: The uploaded file is missing or does not match the size or type declared when the upload URL was requested.
- `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/confirm/post.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)