---
title: "Changes to Create an asset upload"
method: POST
path: "/assets"
---

# Changes to Create an asset upload

`POST /assets`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 15 revisions.

- **2026-10-28** `a8351619f225`: 9 warning
- **2026-10-20** `d7653e24b083`: 6 breaking, 2 info
- **2026-10-16** `e54130373b10`: 25 warning, 19 info
- **2026-05-19** `2f4a714f8ce9`: 3 breaking, 3 info
- **2026-05-13** `3b683901714c`: 2 breaking, 3 info
- **2026-05-13** `5546855ea637`: 5 warning, 8 info
- **2026-05-12** `4a457dc80f1e`: 2 breaking, 3 info
- **2026-05-12** `cb3cd5e5da7c`: 5 warning

## Changes

- **2026-10-28** `a8351619f225`: 9 warning
  - added the new `not_configured` enum value to the `error/code` response property for the response status `400`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `401`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `402`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `403`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `404`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `409`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `429`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `500`
  - added the new `not_configured` enum value to the `error/code` response property for the response status `503`
- **2026-10-20** `d7653e24b083`: 6 breaking, 2 info
  - the `upload` response's property type changed from `object` to no type for status `201`
  - removed the required property `upload/content_type` from the response with the `201` status
  - removed the required property `upload/file_field` from the response with the `201` status
  - removed the required property `upload/form_fields` from the response with the `201` status
  - removed the required property `upload/method` from the response with the `201` status
  - removed the required property `upload/url` from the response with the `201` status
  - added the new optional request property `size_bytes`
  - added `subschema #1, subschema #2` to the `upload` response property `anyOf` list for the response status `201`
- **2026-10-16** `e54130373b10`: 25 warning, 19 info
  - added the new `direct` enum value to the `uploaded_via` response property for the response status `201`
  - added the new `paid_plan_required` enum value to the `error/code` response property for the response status `400`
  - added the new `paid_plan_required` enum value to the `error/code` response property for the response status `401`
  - added the new `paid_plan_required` enum value to the `error/code` response property for the response status `402`
  - added the new `paid_plan_required` enum value to the `error/code` response property for the response status `403`
  - added the new `paid_plan_required` enum value to the `error/code` response property for the response status `404`
  - added the new `paid_plan_required` enum value to the `error/code` response property for the response status `409`
  - added the new `paid_plan_required` enum value to the `error/code` response property for the response status `429`
  - added the new `paid_plan_required` enum value to the `error/code` response property for the response status `500`
  - added the new `revision_conflict` enum value to the `error/code` response property for the response status `400`
  - added the new `revision_conflict` enum value to the `error/code` response property for the response status `401`
  - added the new `revision_conflict` enum value to the `error/code` response property for the response status `402`
  - added the new `revision_conflict` enum value to the `error/code` response property for the response status `403`
  - added the new `revision_conflict` enum value to the `error/code` response property for the response status `404`
  - added the new `revision_conflict` enum value to the `error/code` response property for the response status `409`
  - added the new `revision_conflict` enum value to the `error/code` response property for the response status `429`
  - added the new `revision_conflict` enum value to the `error/code` response property for the response status `500`
  - added the new `temporarily_unavailable` enum value to the `error/code` response property for the response status `400`
  - added the new `temporarily_unavailable` enum value to the `error/code` response property for the response status `401`
  - added the new `temporarily_unavailable` enum value to the `error/code` response property for the response status `402`
  - added the new `temporarily_unavailable` enum value to the `error/code` response property for the response status `403`
  - added the new `temporarily_unavailable` enum value to the `error/code` response property for the response status `404`
  - added the new `temporarily_unavailable` enum value to the `error/code` response property for the response status `409`
  - added the new `temporarily_unavailable` enum value to the `error/code` response property for the response status `429`
  - added the new `temporarily_unavailable` enum value to the `error/code` response property for the response status `500`
  - added the new optional request property `project_id`
  - added the media type `multipart/form-data` to the request body
  - added the non-success response with the status `503`
  - added the optional property `error/fields/items/code` to the response with the `400` status
  - added the optional property `error/fields/items/code` to the response with the `401` status
  - added the optional property `error/fields/items/code` to the response with the `402` status
  - added the optional property `error/fields/items/code` to the response with the `403` status
  - added the optional property `error/fields/items/code` to the response with the `404` status
  - added the optional property `error/fields/items/code` to the response with the `409` status
  - added the optional property `error/fields/items/code` to the response with the `429` status
  - added the optional property `error/fields/items/code` to the response with the `500` status
  - added the optional property `error/fields/items/valid_values` to the response with the `400` status
  - added the optional property `error/fields/items/valid_values` to the response with the `401` status
  - added the optional property `error/fields/items/valid_values` to the response with the `402` status
  - added the optional property `error/fields/items/valid_values` to the response with the `403` status
  - …4 more
- **2026-05-19** `2f4a714f8ce9`: 3 breaking, 3 info
  - removed the required property `upload/contentType` from the response with the `201` status
  - removed the required property `upload/fileField` from the response with the `201` status
  - removed the required property `upload/formFields` from the response with the `201` status
  - added the required property `upload/content_type` to the response with the `201` status
  - added the required property `upload/file_field` to the response with the `201` status
  - added the required property `upload/form_fields` to the response with the `201` status
- **2026-05-13** `3b683901714c`: 2 breaking, 3 info
  - added the new required request property `source`
  - added the new required request property `workspace_id`
  - added the new optional request property `content_type`
  - added the new optional request property `file_name`
  - added the new optional request property `folder`
- **2026-05-13** `5546855ea637`: 5 warning, 8 info
  - removed the request property `content_type`
  - removed the request property `file_name`
  - removed the request property `folder`
  - removed the request property `source`
  - removed the request property `workspace_id`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `402`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `409`
  - added the non-success response with the status `429`
  - added the non-success response with the status `500`
- **2026-05-12** `4a457dc80f1e`: 2 breaking, 3 info
  - added the new required request property `source`
  - added the new required request property `workspace_id`
  - added the new optional request property `content_type`
  - added the new optional request property `file_name`
  - added the new optional request property `folder`
- **2026-05-12** `cb3cd5e5da7c`: 5 warning
  - removed the request property `content_type`
  - removed the request property `file_name`
  - removed the request property `folder`
  - removed the request property `source`
  - removed the request property `workspace_id`

---

[Operation](https://skmtc.dev/florafauna-ai/apis/flora-ai-api/docs/assets/post.md) - [API](https://skmtc.dev/florafauna-ai/apis/flora-ai-api.md) - [Page](https://skmtc.dev/florafauna-ai/apis/flora-ai-api/changes/assets/post)
