Users

Create private channel

Changed on

Creates a new private channel (direct message) between the current user and one or more recipients. Group DM creation requires a solved captcha challenge (X-Captcha-Token). Returns the newly created channel object.

post/users/@me/channels

Request

  • Base URL: https://web.fluxer.app/api/v1
  • URL: https://web.fluxer.app/api/v1/users/@me/channels
  • Auth: one of:
    • API key in header Authorization
    • API key in header Authorization

Request body

Response

Success

idstring snowflake required
guild_idstring snowflake
namestring nullable

The name of the channel

topicstring nullable

The topic of the channel

urlstring uri nullable

The URL associated with the channel

iconstring nullable

The icon hash of the channel (for group DMs)

owner_idstring snowflake
type0 | 1 | 2 | 3 | 4 | 5 | 10 | 11 | 12 | 15 | 16 | 998 | 999 required

The type of the channel

positioninteger
parent_idstring snowflake
bitrateinteger
user_limitinteger
voice_connection_limitinteger
rtc_regionstring nullable

The voice region ID for the voice channel

rtc_p2pboolean

Whether calls in the voice channel connect participants directly instead of through a voice server

last_message_idstring snowflake
last_pin_timestampstring date-time nullable

The ISO 8601 timestamp of when the last pinned message was pinned

nsfwboolean

Whether the channel is marked as NSFW (effective value, walking channel → category → guild)

nsfw_overrideboolean nullable

Per-channel adult-content override; null means inherit from parent category and then guild. Categories use this same field as their own override.

content_warning_level0 | 1

The content warning level for a guild, category, or channel

content_warning_textstring nullable

Custom channel content warning text (max 200 characters); null inherits from parent or guild

rate_limit_per_userinteger
nicksobject

Custom nicknames for users in this channel (for group DMs)

flagsinteger
applied_tagsSnowflakeStringType[]

IDs of the tags applied to a forum or media post

message_countinteger
total_message_sentinteger
member_countinteger
member_ids_previewSnowflakeStringType[]

IDs of the most recently joined members of a forum or media post, newest first

default_auto_archive_durationinteger
default_thread_rate_limit_per_userinteger
default_sort_orderinteger
default_forum_layoutinteger
default_tag_setting'match_some' | 'match_all'

Default tag search setting

Changes

  • b620d9da76aaRevision changes
    • info

      added the optional property to the response with the status

  • 91a0a8217299Revision changes
    • warning

      added the new 10.00 enum value to the response property for the response status

    • warning

      added the new 11.00 enum value to the response property for the response status

    • warning

      added the new 12.00 enum value to the response property for the response status

    • warning

      added the new 15.00 enum value to the response property for the response status

    • warning

      added the new 16.00 enum value to the response property for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status