---
title: "Changes to Create Note Endpoint"
method: POST
path: "/notes"
---

# Changes to Create Note Endpoint

`POST /notes`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 43 revisions.

- **2026-08-08** `3a702c095d22`: 1 warning, 1 info
- **2026-07-13** `228cc05ba97d`: 1 warning, 2 info
- **2026-06-07** `13f3bc084194`: 12 breaking, 3 warning, 9 info
- **2026-01-17** `8590daeecaea`: 4 breaking, 4 warning, 5 info
- **2025-10-15** `b366d059d1ae`: 1 breaking, 7 warning, 9 info
- **2025-07-11** `b3fb230c0938`: 1 info

## Changes

- **2026-08-08** `3a702c095d22`: 1 warning, 1 info
  - changed the pattern of the request property `model_id` from `^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|(?:bsky_ss_doc|bsky_ss_pub|permission|unsub_req|auth_tok|rec_code|webauthn|api_req|aut_att|ext_evt|str_cus|str_sub|sub_imp|sub_tag|adslot|em_dom|em_evt|em_imp|le_evt|str_pd|adsku|socmn|webmn|book|bulk|cnvs|form|hook|inbx|news|note|resp|rssi|snip|snpr|acc|att|aut|com|emr|exp|img|inv|mes|rss|smp|srv|sub|dr|em)_(?:[0-7][0-9abcdefghjkmnpqrstvwxyz]{25}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}))$` to `^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|(?:bsky_ss_doc|bsky_ss_pub|permission|unsub_req|auth_tok|rec_code|webauthn|api_req|aut_att|ext_evt|segment|str_cus|str_sub|sub_imp|sub_tag|adslot|em_dom|em_imp|le_evt|str_pd|adsku|socmn|webmn|book|bulk|cnvs|form|hook|inbx|news|note|resp|rssi|snip|snpr|acc|att|aut|com|emr|exp|img|inv|mes|rss|smp|srv|sub|dr|em)_(?:[0-7][0-9abcdefghjkmnpqrstvwxyz]{25}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}))$`
  - the `model_id` response's property pattern was changed from `^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|(?:bsky_ss_doc|bsky_ss_pub|permission|unsub_req|auth_tok|rec_code|webauthn|api_req|aut_att|ext_evt|str_cus|str_sub|sub_imp|sub_tag|adslot|em_dom|em_evt|em_imp|le_evt|str_pd|adsku|socmn|webmn|book|bulk|cnvs|form|hook|inbx|news|note|resp|rssi|snip|snpr|acc|att|aut|com|emr|exp|img|inv|mes|rss|smp|srv|sub|dr|em)_(?:[0-7][0-9abcdefghjkmnpqrstvwxyz]{25}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}))$` to `^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|(?:bsky_ss_doc|bsky_ss_pub|permission|unsub_req|auth_tok|rec_code|webauthn|api_req|aut_att|ext_evt|segment|str_cus|str_sub|sub_imp|sub_tag|adslot|em_dom|em_imp|le_evt|str_pd|adsku|socmn|webmn|book|bulk|cnvs|form|hook|inbx|news|note|resp|rssi|snip|snpr|acc|att|aut|com|emr|exp|img|inv|mes|rss|smp|srv|sub|dr|em)_(?:[0-7][0-9abcdefghjkmnpqrstvwxyz]{25}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}))$` for the status `201`
- **2026-07-13** `228cc05ba97d`: 1 warning, 2 info
  - changed the pattern of the request property `model_id` from `^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|(?:permission|unsub_req|auth_tok|rec_code|webauthn|api_req|aut_att|ext_evt|str_cus|str_sub|sub_imp|sub_tag|adslot|em_dom|em_evt|em_imp|le_evt|str_pd|adsku|socmn|webmn|book|bulk|cnvs|form|hook|inbx|news|note|resp|rssi|snip|snpr|acc|att|aut|com|exp|img|inv|mes|rss|smp|srv|sub|dr|em)_(?:[0-7][0-9abcdefghjkmnpqrstvwxyz]{25}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}))$` to `^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|(?:bsky_ss_doc|bsky_ss_pub|permission|unsub_req|auth_tok|rec_code|webauthn|api_req|aut_att|ext_evt|str_cus|str_sub|sub_imp|sub_tag|adslot|em_dom|em_evt|em_imp|le_evt|str_pd|adsku|socmn|webmn|book|bulk|cnvs|form|hook|inbx|news|note|resp|rssi|snip|snpr|acc|att|aut|com|emr|exp|img|inv|mes|rss|smp|srv|sub|dr|em)_(?:[0-7][0-9abcdefghjkmnpqrstvwxyz]{25}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}))$`
  - added the non-success response with the status `429`
  - the `model_id` response's property pattern was changed from `^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|(?:permission|unsub_req|auth_tok|rec_code|webauthn|api_req|aut_att|ext_evt|str_cus|str_sub|sub_imp|sub_tag|adslot|em_dom|em_evt|em_imp|le_evt|str_pd|adsku|socmn|webmn|book|bulk|cnvs|form|hook|inbx|news|note|resp|rssi|snip|snpr|acc|att|aut|com|exp|img|inv|mes|rss|smp|srv|sub|dr|em)_(?:[0-7][0-9abcdefghjkmnpqrstvwxyz]{25}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}))$` to `^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|(?:bsky_ss_doc|bsky_ss_pub|permission|unsub_req|auth_tok|rec_code|webauthn|api_req|aut_att|ext_evt|str_cus|str_sub|sub_imp|sub_tag|adslot|em_dom|em_evt|em_imp|le_evt|str_pd|adsku|socmn|webmn|book|bulk|cnvs|form|hook|inbx|news|note|resp|rssi|snip|snpr|acc|att|aut|com|emr|exp|img|inv|mes|rss|smp|srv|sub|dr|em)_(?:[0-7][0-9abcdefghjkmnpqrstvwxyz]{25}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}))$` for the status `201`
- **2026-06-07** `13f3bc084194`: 12 breaking, 3 warning, 9 info
  - the `body` request property's minLength was increased from `0` to `1`
  - added the pattern `[\s\S]*\S[\s\S]*` to the request property `body`
  - added the pattern `^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|(?:permission|unsub_req|auth_tok|rec_code|webauthn|api_req|aut_att|ext_evt|str_cus|str_sub|sub_imp|sub_tag|adslot|em_dom|em_evt|em_imp|le_evt|str_pd|adsku|socmn|webmn|book|bulk|cnvs|form|hook|inbx|news|note|resp|rssi|snip|snpr|acc|att|aut|com|exp|img|inv|mes|rss|smp|srv|sub|dr|em)_(?:[0-7][0-9abcdefghjkmnpqrstvwxyz]{25}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}))$` to the request property `model_id`
  - response property `user_id` list-of-types was widened by adding types `null` to media type `application/json` of response `201`
  - the `code` response's property type changed from no type to `string` for status `400`
  - the `code` response's property type changed from no type to `string` for status `403`
  - the `user` response's property type changed from `object` to no type for status `201`
  - removed the required property `user/creation_date` from the response with the `201` status
  - removed the required property `user/email_address` from the response with the `201` status
  - removed the required property `user/id` from the response with the `201` status
  - removed the required property `user/permissions` from the response with the `201` status
  - removed the required property `user/status` from the response with the `201` status
  - the `model_id` request property's maxLength was set to `50`
  - removed the optional property `user/last_logged_in` from the response with the `201` status
  - added the new `invitation` enum value to the `model_type` response property for the response status `201`
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `PermissionAuthenticationRequirement` was removed from the API
  - api tag `Notes` added
  - added the new `invitation` enum value to the request property `model_type`
  - added the non-success response with the status `401`
  - added the non-success response with the status `422`
  - added `#/components/schemas/User, subschema #2` to the `user` response property `anyOf` list for the response status `201`
  - the `body` response's property pattern `[\s\S]*\S[\s\S]*` was added for the status `201`
  - the `model_id` response's property pattern `^(?:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|(?:permission|unsub_req|auth_tok|rec_code|webauthn|api_req|aut_att|ext_evt|str_cus|str_sub|sub_imp|sub_tag|adslot|em_dom|em_evt|em_imp|le_evt|str_pd|adsku|socmn|webmn|book|bulk|cnvs|form|hook|inbx|news|note|resp|rssi|snip|snpr|acc|att|aut|com|exp|img|inv|mes|rss|smp|srv|sub|dr|em)_(?:[0-7][0-9abcdefghjkmnpqrstvwxyz]{25}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}))$` was added for the status `201`
- **2026-01-17** `8590daeecaea`: 4 breaking, 4 warning, 5 info
  - the response property `user_id` became optional for the status `201`
  - the `id` response's property format changed from `uuid` to no format for status `201`
  - the `user/id` response's property format changed from `uuid` to no format for status `201`
  - the `user_id` response's property format changed from `uuid` to no format for status `201`
  - added the new `comment` enum value to the `model_type` response property for the response status `201`
  - added the new `conversation` enum value to the `model_type` response property for the response status `201`
  - added the new `socialmention` enum value to the `model_type` response property for the response status `201`
  - added the new `webmention` enum value to the `model_type` response property for the response status `201`
  - added the new `comment` enum value to the request property `model_type`
  - added the new `conversation` enum value to the request property `model_type`
  - added the new `socialmention` enum value to the request property `model_type`
  - added the new `webmention` enum value to the request property `model_type`
  - added the optional property `user/permissions/forms` to the response with the `201` status
- **2025-10-15** `b366d059d1ae`: 1 breaking, 7 warning, 9 info
  - request property `model_type` was restricted to a list of enum values
  - added the new `automation` enum value to the `model_type` response property for the response status `201`
  - added the new `email` enum value to the `model_type` response property for the response status `201`
  - added the new `external_feed` enum value to the `model_type` response property for the response status `201`
  - added the new `stripe_customer` enum value to the `model_type` response property for the response status `201`
  - added the new `subscriber` enum value to the `model_type` response property for the response status `201`
  - added the new `survey` enum value to the `model_type` response property for the response status `201`
  - added the new `tag` enum value to the `model_type` response property for the response status `201`
  - the `metadata` request property default value `{}` was added
  - added the new `automation` enum value to the request property `model_type`
  - added the new `email` enum value to the request property `model_type`
  - added the new `external_feed` enum value to the request property `model_type`
  - added the new `stripe_customer` enum value to the request property `model_type`
  - added the new `subscriber` enum value to the request property `model_type`
  - added the new `survey` enum value to the request property `model_type`
  - added the new `tag` enum value to the request property `model_type`
  - added the required property `source` to the response with the `201` status
- **2025-07-11** `b3fb230c0938`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/buttondown/apis/buttondown-api/docs/notes/post.md) - [API](https://skmtc.dev/buttondown/apis/buttondown-api.md) - [Page](https://skmtc.dev/buttondown/apis/buttondown-api/changes/notes/post)