---
title: "Update the metadata of an attached file"
method: POST
path: "/events/submissions/{submission-id}/files/{file-id}"
tags: ["events"]
---

# Update the metadata of an attached file

`POST /events/submissions/{submission-id}/files/{file-id}`

## Request

- Base URL: `/efs-submissions-api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/efs-submissions-api/events/submissions/{submission-id}/files/{file-id}`
- Auth: none declared

## Path parameters

- `submission-id` string, required
- `file-id` string, UUID, required

## Request body

- UpdateAttachmentRequest: Updated attachment metadata
  - `converted_file_id` string: Converted file identifier
  - `conversion_status` 'CONVERTED' | 'FAILED'
  - `number_of_pages` number: Number of pages in the converted file

## Response `200`

The request completed successfully

## Other responses

- `401`: Invalid or missing credentials
- `404`: Requested resource was not found
- `409`: Request valid but not consistent with state of resource

---

[API](https://skmtc.dev/companies-house/apis/emergency-filing-service-api.md) - [All operations](https://skmtc.dev/companies-house/apis/emergency-filing-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/companies-house/apis/emergency-filing-service-api/revisions/7dbd2ded46b4?raw)