---
title: "Changes to Create Guest"
method: POST
path: "/guest"
---

# Changes to Create Guest

`POST /guest`

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

## Timeline

Changed in 18 of 576 revisions.

- **2026-10-12** `30f95dce0284`: 2 info
- **2026-07-29** `d274674f0337`: 3 breaking, 4 info
- **2026-04-13** `0e8699ecb9d0`: 1 info
- **2025-10-06** `4834c2766be0`: 2 info
- **2025-07-31** `ff8af70dc683`: 1 info
- **2025-04-17** `4790b8d86366`: 2 info
- **2025-01-31** `1af2cd87156c`: 1 breaking, 1 warning
- **2024-09-05** `c008f63f0618`: 2 info
- **2024-08-15** `e7439cb08b03`: 5 info
- **2024-07-15** `2c8816c7ade0`: 1 info
- **2024-06-10** `beb8b68c6223`: 1 info
- **2024-05-10** `105f5ea2983c`: 2 breaking
- **2024-05-08** `93c38a25cccf`: 2 info
- **2024-04-30** `8fa8e0a897c0`: 2 info
- **2024-04-29** `a49249cffc7a`: 2 breaking, 5 warning, 26 info
- **2024-02-14** `9abea6d94d53`: 3 warning, 2 info
- **2023-06-19** `1c08d6b56ba4`: 2 breaking, 64 info
- **2023-05-16** `f6f95dfaa122`: 2 breaking, 64 warning

## Changes

- **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-07-29** `d274674f0337`: 3 breaking, 4 info
  - the response property `user/privacy_settings/delivery_receipts/enabled` became optional for the status `201`
  - the response property `user/privacy_settings/read_receipts/enabled` became optional for the status `201`
  - the response property `user/privacy_settings/typing_indicators/enabled` became optional for the status `201`
  - the request property `user/privacy_settings/delivery_receipts/enabled` became optional
  - the request property `user/privacy_settings/read_receipts/enabled` became optional
  - the request property `user/privacy_settings/typing_indicators/enabled` became optional
  - added the optional property `user/devices/items/hardware_id` to the response with the `201` status
- **2026-04-13** `0e8699ecb9d0`: 1 info
  - added the optional property `user/bypass_moderation` to the response with the `201` status
- **2025-10-06** `4834c2766be0`: 2 info
  - added the new optional request property `user/privacy_settings/delivery_receipts`
  - added the optional property `user/privacy_settings/delivery_receipts` to the response with the `201` status
- **2025-07-31** `ff8af70dc683`: 1 info
  - added the optional property `user/avg_response_time` to the response with the `201` status
- **2025-04-17** `4790b8d86366`: 2 info
  - added the new optional request property `user/teams_role`
  - added the optional property `user/teams_role` to the response with the `201` status
- **2025-01-31** `1af2cd87156c`: 1 breaking, 1 warning
  - the response property `user/devices` became optional for the status `201`
  - removed the request property `user/push_notifications`
- **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-15** `e7439cb08b03`: 5 info
  - added the optional property `user/privacy_settings` to the response with the `201` status
  - removed the `apn` enum value from the `user/devices/items/push_provider` response property for the response status `201`
  - removed the `firebase` enum value from the `user/devices/items/push_provider` response property for the response status `201`
  - removed the `huawei` enum value from the `user/devices/items/push_provider` response property for the response status `201`
  - removed the `xiaomi` enum value from the `user/devices/items/push_provider` response property for the response status `201`
- **2024-07-15** `2c8816c7ade0`: 1 info
  - added the optional property `user/ban_expires` to the response with the `201` status
- **2024-06-10** `beb8b68c6223`: 1 info
  - added the required property `user/blocked_user_ids` to the response with the `201` status
- **2024-05-10** `105f5ea2983c`: 2 breaking
  - the response property `user/image` became optional for the status `201`
  - the response property `user/name` became optional for the status `201`
- **2024-05-08** `93c38a25cccf`: 2 info
  - the response property `user/image` became required for the status `201`
  - the response property `user/name` became required for the status `201`
- **2024-04-30** `8fa8e0a897c0`: 2 info
  - added the new optional request property `user/privacy_settings`
  - the response property `user/invisible` became required for the status `201`
- **2024-04-29** `a49249cffc7a`: 2 breaking, 5 warning, 26 info
  - the `user/push_notifications/disabled` request property type changed from `boolean` to `object`
  - the `user/push_notifications/disabled_until` request property type changed from `string` to `object`, and format from `date-time` to no format
  - removed the request property `user/Custom`
  - removed the request property `user/ban_expires`
  - removed the request property `user/banned`
  - removed the request property `user/revoke_tokens_issued_before`
  - removed the optional property `user/ban_expires` from the response with the `201` status
  - api tag `product:chat` added
  - api tag `Users` removed
  - added the new optional request property `user/custom`
  - added the new optional request property `user/image`
  - added the new optional request property `user/name`
  - added the new optional request property `user/push_notifications/disabled/HasValue`
  - added the new optional request property `user/push_notifications/disabled/Value`
  - added the new optional request property `user/push_notifications/disabled_until/HasValue`
  - added the new optional request property `user/push_notifications/disabled_until/Value`
  - added the optional property `user/image` to the response with the `201` status
  - added the optional property `user/name` to the response with the `201` status
  - the response optional property `user/created_at` became not read-only for the status `201`
  - the response optional property `user/deactivated_at` became not read-only for the status `201`
  - the response optional property `user/deleted_at` became not read-only for the status `201`
  - the response optional property `user/last_active` became not read-only for the status `201`
  - the response optional property `user/updated_at` became not read-only for the status `201`
  - the response property `user` became required for the status `201`
  - the response property `user/created_at` became required for the status `201`
  - the response property `user/language` became required for the status `201`
  - the response property `user/teams` became required for the status `201`
  - the response property `user/updated_at` became required for the status `201`
  - added the required property `user/custom` to the response with the `201` status
  - added the required property `user/devices` to the response with the `201` status
  - added the required property `user/shadow_banned` to the response with the `201` status
  - the response required property `user/online` became not read-only for the status `201`
  - removed the required write-only property `user/Custom` from the response with the `201` status
- **2024-02-14** `9abea6d94d53`: 3 warning, 2 info
  - 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`
  - added the new optional request property `user/Custom`
  - added the required write-only property `user/Custom` 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/guest/post.md) - [API](https://skmtc.dev/getstream/apis/stream-api.md) - [Page](https://skmtc.dev/getstream/apis/stream-api/changes/guest/post)
