---
title: "Changes to PUT /v2/vals/{val_id}/files"
method: PUT
path: "/v2/vals/{val_id}/files"
---

# Changes to PUT /v2/vals/{val_id}/files

`PUT /v2/vals/{val_id}/files`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 46 revisions.

- **2026-04-20** `8f22304950dd` — 1 breaking
- **2026-03-18** `7ca4c991c6cc` — 3 breaking
- **2026-03-11** `dc1b3c9e3b2a` — 1 breaking, 4 warning, 1 info
- **2026-02-27** `fb890bfd4bf7` — 1 warning
- **2026-02-03** `05f618f5e1bc` — 2 info
- **2025-04-23** `1658025a5732` — 1 info

## Changes

- **2026-04-20** `8f22304950dd` — 1 breaking
  - request body became required
- **2026-03-18** `7ca4c991c6cc` — 3 breaking
  - the `anyOf[subschema #1]/type` request property type changed from `string` to no type
  - the `type` response's property type changed from `string` to no type for status `200`
  - the `type` response's property type changed from `string` to no type for status `201`
- **2026-03-11** `dc1b3c9e3b2a` — 1 breaking, 4 warning, 1 info
  - the request's body type changed from `object` to no type
  - removed the request property `content`
  - removed the request property `name`
  - removed the request property `parent_path`
  - removed the request property `type`
  - added `subschema #1` to the request body `anyOf` list
- **2026-02-27** `fb890bfd4bf7` — 1 warning
  - changed the pattern of the request property `name` from `^[a-zA-Z0-9\-_.]+$` to `^[a-zA-Z0-9\$\[\]\(\)\-_.]+$`
- **2026-02-03** `05f618f5e1bc` — 2 info
  - added the optional property `links/email` to the response with the `200` status
  - added the optional property `links/email` to the response with the `201` status
- **2025-04-23** `1658025a5732` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/val-town/apis/val-town-api/docs/v2/vals/:val_id/files/put.md) · [API](https://skmtc.dev/val-town/apis/val-town-api.md) · [Page](https://skmtc.dev/val-town/apis/val-town-api/changes/v2/vals/:val_id/files/put)