---
title: "Changes to Create an attachment"
method: POST
path: "/api/v2/attachments"
---

# Changes to Create an attachment

`POST /api/v2/attachments`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 49 revisions.

- **2026-11-02** `fa3060fd0144`: 3 warning, 9 info
- **2026-10-28** `2551aa7f640e`: 4 warning
- **2026-10-27** `f11a8740641a`: 6 breaking, 1 warning, 58 info

## Changes

- **2026-11-02** `fa3060fd0144`: 3 warning, 9 info
  - added the new `bad_decimal_format` enum value to the `errors/items/code` response property for the response status `422`
  - added the new `non_finite_number` enum value to the `errors/items/code` response property for the response status `422`
  - added the new `null_bytes_in_params` enum value to the `errors/items/code` response property for the response status `422`
  - 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 `403`
  - added the non-success response with the status `406`
  - added the non-success response with the status `408`
  - added the non-success response with the status `415`
  - added the non-success response with the status `423`
  - added the non-success response with the status `429`
  - added the non-success response with the status `500`
- **2026-10-28** `2551aa7f640e`: 4 warning
  - added the new `recording_attachment_invalid` enum value to the `errors/items/code` response property for the response status `422`
  - added the new `recording_not_uploaded` enum value to the `errors/items/code` response property for the response status `422`
  - added the new `recording_size_invalid` enum value to the `errors/items/code` response property for the response status `422`
  - added the new `recording_transcription_refused` enum value to the `errors/items/code` response property for the response status `422`
- **2026-10-27** `f11a8740641a`: 6 breaking, 1 warning, 58 info
  - response property `data/attributes/external_id` list-of-types was widened by adding types `null and string` to media type `application/vnd.api+json` of response `201`
  - response property `data/attributes/message_id` list-of-types was widened by adding types `null and string` to media type `application/vnd.api+json` of response `201`
  - the `data/attributes/attachable_type` response's property type changed from `string` to no type for status `201`
  - the `data/attributes/attachment_type` response's property type changed from `string` to no type for status `201`
  - the `data/attributes/created_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `201`
  - the `data/attributes/deleted_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `201`
  - deleted the `header` request parameter `X-Organization-Id`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/bill` response property `anyOf` list for the response status `201`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/comment` response property `anyOf` list for the response status `201`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/creator` response property `anyOf` list for the response status `201`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/deal` response property `anyOf` list for the response status `201`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/document_style` response property `anyOf` list for the response status `201`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/document_type` response property `anyOf` list for the response status `201`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/email` response property `anyOf` list for the response status `201`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/expense` response property `anyOf` list for the response status `201`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/invoice` response property `anyOf` list for the response status `201`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/organization` response property `anyOf` list for the response status `201`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/page` response property `anyOf` list for the response status `201`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/purchase_order` response property `anyOf` list for the response status `201`
  - added `#/components/schemas/_single_linkage_nullable` to the `data/relationships/task` response property `anyOf` list for the response status `201`
  - added `#/components/schemas/attachable_type, subschema #2` to the `data/attributes/attachable_type` response property `anyOf` list for the response status `201`
  - added `#/components/schemas/attachment_type, subschema #2` to the `data/attributes/attachment_type` response property `anyOf` list for the response status `201`
  - added `#/components/schemas/created_at, subschema #2` to the `data/attributes/created_at` response property `anyOf` list for the response status `201`
  - added `#/components/schemas/deleted_at, subschema #2` to the `data/attributes/deleted_at` response property `anyOf` list for the response status `201`
  - removed `subschema #1: Single data` from the `data/relationships/bill` response property `anyOf` list for the response status `201`
  - removed `subschema #1: Single data` from the `data/relationships/comment` response property `anyOf` list for the response status `201`
  - removed `subschema #1: Single data` from the `data/relationships/creator` response property `anyOf` list for the response status `201`
  - removed `subschema #1: Single data` from the `data/relationships/deal` response property `anyOf` list for the response status `201`
  - removed `subschema #1: Single data` from the `data/relationships/document_style` response property `anyOf` list for the response status `201`
  - removed `subschema #1: Single data` from the `data/relationships/document_type` response property `anyOf` list for the response status `201`
  - removed `subschema #1: Single data` from the `data/relationships/email` response property `anyOf` list for the response status `201`
  - removed `subschema #1: Single data` from the `data/relationships/expense` response property `anyOf` list for the response status `201`
  - removed `subschema #1: Single data` from the `data/relationships/invoice` response property `anyOf` list for the response status `201`
  - removed `subschema #1: Single data` from the `data/relationships/organization` response property `anyOf` list for the response status `201`
  - removed `subschema #1: Single data` from the `data/relationships/page` response property `anyOf` list for the response status `201`
  - removed `subschema #1: Single data` from the `data/relationships/purchase_order` response property `anyOf` list for the response status `201`
  - removed `subschema #1: Single data` from the `data/relationships/task` response property `anyOf` list for the response status `201`
  - the response property `data/relationships/bill/anyOf[subschema #2: Not included]/meta` became required for the status `201`
  - the response property `data/relationships/bill/anyOf[subschema #2: Not included]/meta/included` became required for the status `201`
  - the response property `data/relationships/comment/anyOf[subschema #2: Not included]/meta` became required for the status `201`
  - …25 more
  - …this revision’s changelog is incomplete

---

[Operation](https://skmtc.dev/productive/apis/api-documentation/docs/api/v2/attachments/post.md) - [API](https://skmtc.dev/productive/apis/api-documentation.md) - [Page](https://skmtc.dev/productive/apis/api-documentation/changes/api/v2/attachments/post)