---
title: "Changes to Create channel type"
method: POST
path: "/channeltypes"
---

# Changes to Create channel type

`POST /channeltypes`

> Every recorded change to this operation, newest first.
> 576 revisions in range; 3 not diffed.

## Timeline

Changed in 24 of 576 revisions.

- **2026-10-19** `c400fa218c9a`: 3 info
- **2026-10-12** `30f95dce0284`: 2 info
- **2026-09-08** `3296f921776b`: 1 breaking, 1 info
- **2026-08-20** `ff38012a3de8`: 1 info
- **2026-03-23** `8bf8e211736c`: 2 info
- **2026-03-06** `3b611b5cf468`: 1 breaking
- **2026-02-13** `72a8c35a3c01`: 2 breaking
- **2026-02-10** `f29eb65f11d5`: 2 info
- **2025-10-16** `d67855da597d`: 2 info
- **2025-08-27** `b23da49bb94a`: 1 info
- **2025-07-18** `ecf82915c7e4`: 4 info
- **2024-12-03** `e455b7bbe9d8`: 1 breaking, 4 info
- **2024-09-24** `dd7459cae556`: 2 breaking
- **2024-09-05** `c008f63f0618`: 2 info
- **2024-08-20** `c70d2b266cd4`: 4 info
- **2024-04-29** `a49249cffc7a`: 9 breaking, 4 info
- **2024-04-15** `6e1df7d4f61d`: 2 info
- **2024-03-29** `4af0644e7a6c`: 3 warning, 2 info
- **2024-02-14** `9abea6d94d53`: 1 breaking, 3 warning
- **2023-12-21** `0aea2badd28a`: 1 warning
- **2023-12-13** `49cc7e01ba9a`: 1 info
- **2023-10-20** `168698649960`: 4 info
- **2023-06-19** `1c08d6b56ba4`: 2 breaking, 64 info
- **2023-05-16** `f6f95dfaa122`: 2 breaking, 64 warning

## Changes

- **2026-10-19** `c400fa218c9a`: 3 info
  - added the new optional request property `automod_thresholds`
  - added the new optional request property `quotes`
  - added the new optional request property `reminders`
- **2026-10-12** `30f95dce0284`: 2 info
  - added the optional property `cooldown_remaining_ms` to the response with the `400` status
  - added the optional property `cooldown_remaining_ms` to the response with the `429` status
- **2026-09-08** `3296f921776b`: 1 breaking, 1 info
  - the response property `grants` became nullable for the status `201`
  - the request property `grants` became nullable
- **2026-08-20** `ff38012a3de8`: 1 info
  - added the required property `message_retention` to the response with the `201` status
- **2026-03-23** `8bf8e211736c`: 2 info
  - added the new optional request property `chat_preferences`
  - added the optional property `chat_preferences` to the response with the `201` status
- **2026-03-06** `3b611b5cf468`: 1 breaking
  - the `permissions/items/resources` request property's minItems was increased to `1`
- **2026-02-13** `72a8c35a3c01`: 2 breaking
  - removed the enum value `infinite` of the request property `message_retention`
  - removed the enum value `numeric` of the request property `message_retention`
- **2026-02-10** `f29eb65f11d5`: 2 info
  - added the new optional request property `push_level`
  - added the optional property `push_level` to the response with the `201` status
- **2025-10-16** `d67855da597d`: 2 info
  - added the new optional request property `delivery_events`
  - added the required property `delivery_events` to the response with the `201` status
- **2025-08-27** `b23da49bb94a`: 1 info
  - added the required property `count_messages` to the response with the `201` status
- **2025-07-18** `ecf82915c7e4`: 4 info
  - added the new optional request property `shared_locations`
  - added the new optional request property `user_message_reminders`
  - added the required property `shared_locations` to the response with the `201` status
  - added the required property `user_message_reminders` to the response with the `201` status
- **2024-12-03** `e455b7bbe9d8`: 1 breaking, 4 info
  - request property `message_retention` was restricted to a list of enum values
  - added the new optional request property `skip_last_msg_update_for_system_msgs`
  - added the new `infinite` enum value to the request property `message_retention`
  - added the new `numeric` enum value to the request property `message_retention`
  - added the required property `skip_last_msg_update_for_system_msgs` to the response with the `201` status
- **2024-09-24** `dd7459cae556`: 2 breaking
  - the response property `partition_ttl` became nullable for the status `201`
  - the `partition_ttl` response's property type changed from `integer` to `string`, and format from no format to `duration` for status `201`
- **2024-09-05** `c008f63f0618`: 2 info
  - added the optional property `unrecoverable` to the response with the `400` status
  - added the optional property `unrecoverable` to the response with the `429` status
- **2024-08-20** `c70d2b266cd4`: 4 info
  - added the new optional request property `partition_size`
  - added the new optional request property `partition_ttl`
  - added the optional property `partition_size` to the response with the `201` status
  - added the optional property `partition_ttl` to the response with the `201` status
- **2024-04-29** `a49249cffc7a`: 9 breaking, 4 info
  - the request property `automod_behavior` became required
  - the request property `blocklists/items/behavior` became required
  - the request property `blocklists/items/blocklist` became required
  - the request property `max_message_length` became required
  - the request property `permissions/items/action` became required
  - the request property `permissions/items/owner` became required
  - the request property `permissions/items/resources` became required
  - the request property `permissions/items/roles` became required
  - removed the required property `message_retention` from the response with the `201` status
  - api tag `product:chat` added
  - api tag `Channel types` removed
  - api tag `Settings` removed
  - added the new optional request property `message_retention`
- **2024-04-15** `6e1df7d4f61d`: 2 info
  - added the new optional request property `polls`
  - added the required property `polls` to the response with the `201` status
- **2024-03-29** `4af0644e7a6c`: 3 warning, 2 info
  - added the new `shadow_block` enum value to the `automod_behavior` response property for the response status `201`
  - added the new `shadow_block` enum value to the `blocklist_behavior` response property for the response status `201`
  - added the new `shadow_block` enum value to the `blocklists/items/behavior` response property for the response status `201`
  - added the new `shadow_block` enum value to the request property `blocklist_behavior`
  - added the new `shadow_block` enum value to the request property `blocklists/items/behavior`
- **2024-02-14** `9abea6d94d53`: 1 breaking, 3 warning
  - the `blocklists` request property type changed from `object` to `array`
  - the optional response header `X-RateLimit-Limit` removed for the status `429`
  - the optional response header `X-RateLimit-Remaining` removed for the status `429`
  - the optional response header `X-RateLimit-Reset` removed for the status `429`
- **2023-12-21** `0aea2badd28a`: 1 warning
  - removed the request property `message_retention`
- **2023-12-13** `49cc7e01ba9a`: 1 info
  - added the optional property `allowed_flag_reasons` to the response with the `201` status
- **2023-10-20** `168698649960`: 4 info
  - added the new optional request property `blocklists`
  - added the new optional request property `mark_messages_pending`
  - added the optional property `blocklists` to the response with the `201` status
  - added the required property `mark_messages_pending` to the response with the `201` status
- **2023-06-19** `1c08d6b56ba4`: 2 breaking, 64 info
  - the `code` response's property type changed from `string` to `integer` for status `400`
  - the `code` response's property type changed from `string` to `integer` for status `429`
  - removed the `access-key-error` enum value from the `code` response property for the response status `400`
  - removed the `access-key-error` enum value from the `code` response property for the response status `429`
  - removed the `app-suspended` enum value from the `code` response property for the response status `400`
  - removed the `app-suspended` enum value from the `code` response property for the response status `429`
  - removed the `auth-failed` enum value from the `code` response property for the response status `400`
  - removed the `auth-failed` enum value from the `code` response property for the response status `429`
  - removed the `channel-feature-not-supported` enum value from the `code` response property for the response status `400`
  - removed the `channel-feature-not-supported` enum value from the `code` response property for the response status `429`
  - removed the `connection-id-not-found` enum value from the `code` response property for the response status `400`
  - removed the `connection-id-not-found` enum value from the `code` response property for the response status `429`
  - removed the `cool-down` enum value from the `code` response property for the response status `400`
  - removed the `cool-down` enum value from the `code` response property for the response status `429`
  - removed the `custom-command-endpoint-missing` enum value from the `code` response property for the response status `400`
  - removed the `custom-command-endpoint-missing` enum value from the `code` response property for the response status `429`
  - removed the `custom-command-endpoint=call-error` enum value from the `code` response property for the response status `400`
  - removed the `custom-command-endpoint=call-error` enum value from the `code` response property for the response status `429`
  - removed the `duplicate-username` enum value from the `code` response property for the response status `400`
  - removed the `duplicate-username` enum value from the `code` response property for the response status `429`
  - removed the `event-not-supported` enum value from the `code` response property for the response status `400`
  - removed the `event-not-supported` enum value from the `code` response property for the response status `429`
  - removed the `expired-token` enum value from the `code` response property for the response status `400`
  - removed the `expired-token` enum value from the `code` response property for the response status `429`
  - removed the `input-error` enum value from the `code` response property for the response status `400`
  - removed the `input-error` enum value from the `code` response property for the response status `429`
  - removed the `internal-error` enum value from the `code` response property for the response status `400`
  - removed the `internal-error` enum value from the `code` response property for the response status `429`
  - removed the `invalid-token-signature` enum value from the `code` response property for the response status `400`
  - removed the `invalid-token-signature` enum value from the `code` response property for the response status `429`
  - removed the `message-too-long` enum value from the `code` response property for the response status `400`
  - removed the `message-too-long` enum value from the `code` response property for the response status `429`
  - removed the `moderation-failed` enum value from the `code` response property for the response status `400`
  - removed the `moderation-failed` enum value from the `code` response property for the response status `429`
  - removed the `multiple-nesting-level` enum value from the `code` response property for the response status `400`
  - removed the `multiple-nesting-level` enum value from the `code` response property for the response status `429`
  - removed the `not-allowed` enum value from the `code` response property for the response status `400`
  - removed the `not-allowed` enum value from the `code` response property for the response status `429`
  - removed the `not-found` enum value from the `code` response property for the response status `400`
  - removed the `not-found` enum value from the `code` response property for the response status `429`
  - …26 more
- **2023-05-16** `f6f95dfaa122`: 2 breaking, 64 warning
  - the `code` response's property type changed from `integer` to `string` for status `400`
  - the `code` response's property type changed from `integer` to `string` for status `429`
  - added the new `access-key-error` enum value to the `code` response property for the response status `400`
  - added the new `access-key-error` enum value to the `code` response property for the response status `429`
  - added the new `app-suspended` enum value to the `code` response property for the response status `400`
  - added the new `app-suspended` enum value to the `code` response property for the response status `429`
  - added the new `auth-failed` enum value to the `code` response property for the response status `400`
  - added the new `auth-failed` enum value to the `code` response property for the response status `429`
  - added the new `channel-feature-not-supported` enum value to the `code` response property for the response status `400`
  - added the new `channel-feature-not-supported` enum value to the `code` response property for the response status `429`
  - added the new `connection-id-not-found` enum value to the `code` response property for the response status `400`
  - added the new `connection-id-not-found` enum value to the `code` response property for the response status `429`
  - added the new `cool-down` enum value to the `code` response property for the response status `400`
  - added the new `cool-down` enum value to the `code` response property for the response status `429`
  - added the new `custom-command-endpoint-missing` enum value to the `code` response property for the response status `400`
  - added the new `custom-command-endpoint-missing` enum value to the `code` response property for the response status `429`
  - added the new `custom-command-endpoint=call-error` enum value to the `code` response property for the response status `400`
  - added the new `custom-command-endpoint=call-error` enum value to the `code` response property for the response status `429`
  - added the new `duplicate-username` enum value to the `code` response property for the response status `400`
  - added the new `duplicate-username` enum value to the `code` response property for the response status `429`
  - added the new `event-not-supported` enum value to the `code` response property for the response status `400`
  - added the new `event-not-supported` enum value to the `code` response property for the response status `429`
  - added the new `expired-token` enum value to the `code` response property for the response status `400`
  - added the new `expired-token` enum value to the `code` response property for the response status `429`
  - added the new `input-error` enum value to the `code` response property for the response status `400`
  - added the new `input-error` enum value to the `code` response property for the response status `429`
  - added the new `internal-error` enum value to the `code` response property for the response status `400`
  - added the new `internal-error` enum value to the `code` response property for the response status `429`
  - added the new `invalid-token-signature` enum value to the `code` response property for the response status `400`
  - added the new `invalid-token-signature` enum value to the `code` response property for the response status `429`
  - added the new `message-too-long` enum value to the `code` response property for the response status `400`
  - added the new `message-too-long` enum value to the `code` response property for the response status `429`
  - added the new `moderation-failed` enum value to the `code` response property for the response status `400`
  - added the new `moderation-failed` enum value to the `code` response property for the response status `429`
  - added the new `multiple-nesting-level` enum value to the `code` response property for the response status `400`
  - added the new `multiple-nesting-level` enum value to the `code` response property for the response status `429`
  - added the new `not-allowed` enum value to the `code` response property for the response status `400`
  - added the new `not-allowed` enum value to the `code` response property for the response status `429`
  - added the new `not-found` enum value to the `code` response property for the response status `400`
  - added the new `not-found` enum value to the `code` response property for the response status `429`
  - …26 more

---

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