Module: Rubycord::API::Channel

Defined in:
lib/rubycord/api/channel.rb

Overview

API calls for Channel

Class Method Summary collapse

Class Method Details

.add_group_user(token, group_channel_id, user_id) ⇒ Object

Deprecated.

Discord no longer supports bots in group DMs, this endpoint was repurposed and no longer works as implemented here.

Add a user to a group channel. https://discord.com/developers/docs/resources/channel#group-dm-add-recipient



385
386
387
388
389
390
391
392
393
394
395
 
# File 'lib/rubycord/api/channel.rb', line 385

def add_group_user(token, group_channel_id, user_id)
  Rubycord::API.request(
    :channels_cid_recipients_uid,
    nil,
    :put,
    "#{Rubycord::API.api_base}/channels/#{group_channel_id}/recipients/#{user_id}",
    {}.to_json,
    Authorization: token,
    content_type: :json
  )
end

.add_thread_member(token, channel_id, user_id) ⇒ Object

Add a user to a thread. https://discord.com/developers/docs/resources/channel#add-thread-member



495
496
497
498
499
500
501
502
503
504
 
# File 'lib/rubycord/api/channel.rb', line 495

def add_thread_member(token, channel_id, user_id)
  Rubycord::API.request(
    :channels_cid_thread_members_uid,
    channel_id,
    :put,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/thread-members/#{user_id}",
    nil,
    Authorization: token
  )
end

.bulk_delete_messages(token, channel_id, messages = [], reason = nil) ⇒ Object

Delete messages in bulk https://discord.com/developers/docs/resources/channel#bulk-delete-messages



145
146
147
148
149
150
151
152
153
154
155
156
 
# File 'lib/rubycord/api/channel.rb', line 145

def bulk_delete_messages(token, channel_id, messages = [], reason = nil)
  Rubycord::API.request(
    :channels_cid_messages_bulk_delete,
    channel_id,
    :post,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/messages/bulk-delete",
    {messages: messages}.to_json,
    Authorization: token,
    content_type: :json,
    "X-Audit-Log-Reason": reason
  )
end

.create_empty_group(token, bot_user_id) ⇒ Object

Deprecated.

Discord no longer supports bots in group DMs, this endpoint was repurposed and no longer works as implemented here.

Create an empty group channel. https://discord.com/developers/docs/resources/user#create-group-dm



349
350
351
352
353
354
355
356
357
358
359
 
# File 'lib/rubycord/api/channel.rb', line 349

def create_empty_group(token, bot_user_id)
  Rubycord::API.request(
    :users_uid_channels,
    nil,
    :post,
    "#{Rubycord::API.api_base}/users/#{bot_user_id}/channels",
    {}.to_json,
    Authorization: token,
    content_type: :json
  )
end

.create_group(token, pm_channel_id, user_id) ⇒ Object

Deprecated.

Discord no longer supports bots in group DMs, this endpoint was repurposed and no longer works as implemented here.

Create a group channel. https://discord.com/developers/docs/resources/channel#group-dm-add-recipient



364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
 
# File 'lib/rubycord/api/channel.rb', line 364

def create_group(token, pm_channel_id, user_id)
  Rubycord::API.request(
    :channels_cid_recipients_uid,
    nil,
    :put,
    "#{Rubycord::API.api_base}/channels/#{pm_channel_id}/recipients/#{user_id}",
    {}.to_json,
    Authorization: token,
    content_type: :json
  )
rescue RestClient::InternalServerError
  raise "Attempted to add self as a new group channel recipient!"
rescue RestClient::NoContent
  raise "Attempted to create a group channel with the PM channel recipient!"
rescue RestClient::Forbidden
  raise "Attempted to add a user to group channel without permission!"
end

.create_invite(token, channel_id, max_age = 0, max_uses = 0, temporary = false, unique = false, reason = nil) ⇒ Object

Create an instant invite from a server or a channel id https://discord.com/developers/docs/resources/channel#create-channel-invite



268
269
270
271
272
273
274
275
276
277
278
279
 
# File 'lib/rubycord/api/channel.rb', line 268

def create_invite(token, channel_id, max_age = 0, max_uses = 0, temporary = false, unique = false, reason = nil)
  Rubycord::API.request(
    :channels_cid_invites,
    channel_id,
    :post,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/invites",
    {max_age: max_age, max_uses: max_uses, temporary: temporary, unique: unique}.to_json,
    Authorization: token,
    content_type: :json,
    "X-Audit-Log-Reason": reason
  )
end

.create_message(token, channel_id, message, tts = false, embeds = nil, nonce = nil, attachments = nil, allowed_mentions = nil, message_reference = nil, components = nil) ⇒ Object

Send a message to a channel https://discord.com/developers/docs/resources/channel#create-message

Parameters:



76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
 
# File 'lib/rubycord/api/channel.rb', line 76

def create_message(token, channel_id, message, tts = false, embeds = nil, nonce = nil, attachments = nil, allowed_mentions = nil, message_reference = nil, components = nil)
  body = {content: message, tts: tts, embeds: embeds, nonce: nonce, allowed_mentions: allowed_mentions, message_reference: message_reference, components: components&.to_a}
  body = if attachments
    files = [*0...attachments.size].zip(attachments).to_h
    {**files, payload_json: body.to_json}
  else
    body.to_json
  end

  headers = {Authorization: token}
  headers[:content_type] = :json unless attachments

  Rubycord::API.request(
    :channels_cid_messages_mid,
    channel_id,
    :post,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/messages",
    body,
    **headers
  )
rescue RestClient::BadRequest => e
  parsed = JSON.parse(e.response.body)
  raise Rubycord::Errors::MessageTooLong, "Message over the character limit (#{message.length} > 2000)" if parsed["content"].is_a?(Array) && parsed["content"].first == "Must be 2000 or fewer in length."

  raise
end

.create_reaction(token, channel_id, message_id, emoji) ⇒ Object

Create a reaction on a message using this client https://discord.com/developers/docs/resources/channel#create-reaction



160
161
162
163
164
165
166
167
168
169
170
171
 
# File 'lib/rubycord/api/channel.rb', line 160

def create_reaction(token, channel_id, message_id, emoji)
  emoji = URI.encode_www_form_component(emoji) unless emoji.ascii_only?
  Rubycord::API.request(
    :channels_cid_messages_mid_reactions_emoji_me,
    channel_id,
    :put,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/messages/#{message_id}/reactions/#{emoji}/@me",
    nil,
    Authorization: token,
    content_type: :json
  )
end

.create_webhook(token, channel_id, name, avatar = nil, reason = nil) ⇒ Object

Create a webhook https://discord.com/developers/docs/resources/webhook#create-webhook



427
428
429
430
431
432
433
434
435
436
437
438
 
# File 'lib/rubycord/api/channel.rb', line 427

def create_webhook(token, channel_id, name, avatar = nil, reason = nil)
  Rubycord::API.request(
    :channels_cid_webhooks,
    channel_id,
    :post,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/webhooks",
    {name: name, avatar: avatar}.to_json,
    Authorization: token,
    content_type: :json,
    "X-Audit-Log-Reason": reason
  )
end

.delete(token, channel_id, reason = nil) ⇒ Object

Delete a channel https://discord.com/developers/docs/resources/channel#deleteclose-channel



36
37
38
39
40
41
42
43
44
45
 
# File 'lib/rubycord/api/channel.rb', line 36

def delete(token, channel_id, reason = nil)
  Rubycord::API.request(
    :channels_cid,
    channel_id,
    :delete,
    "#{Rubycord::API.api_base}/channels/#{channel_id}",
    Authorization: token,
    "X-Audit-Log-Reason": reason
  )
end

.delete_all_emoji_reactions(token, channel_id, message_id, emoji) ⇒ Object

Deletes all the reactions for a given emoji on a message https://discord.com/developers/docs/resources/channel#delete-all-reactions-for-emoji



227
228
229
230
231
232
233
234
235
236
237
 
# File 'lib/rubycord/api/channel.rb', line 227

def delete_all_emoji_reactions(token, channel_id, message_id, emoji)
  emoji = URI.encode_www_form_component(emoji) unless emoji.ascii_only?

  Rubycord::API.request(
    :channels_cid_messages_mid_reactions_emoji,
    channel_id,
    :delete,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/messages/#{message_id}/reactions/#{emoji}",
    Authorization: token
  )
end

.delete_all_reactions(token, channel_id, message_id) ⇒ Object

Deletes all reactions on a message from all clients https://discord.com/developers/docs/resources/channel#delete-all-reactions



215
216
217
218
219
220
221
222
223
 
# File 'lib/rubycord/api/channel.rb', line 215

def delete_all_reactions(token, channel_id, message_id)
  Rubycord::API.request(
    :channels_cid_messages_mid_reactions,
    channel_id,
    :delete,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/messages/#{message_id}/reactions",
    Authorization: token
  )
end

.delete_message(token, channel_id, message_id, reason = nil) ⇒ Object

Delete a message https://discord.com/developers/docs/resources/channel#delete-message



132
133
134
135
136
137
138
139
140
141
 
# File 'lib/rubycord/api/channel.rb', line 132

def delete_message(token, channel_id, message_id, reason = nil)
  Rubycord::API.request(
    :channels_cid_messages_mid,
    channel_id,
    :delete,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/messages/#{message_id}",
    Authorization: token,
    "X-Audit-Log-Reason": reason
  )
end

.delete_own_reaction(token, channel_id, message_id, emoji) ⇒ Object

Delete this client's own reaction on a message https://discord.com/developers/docs/resources/channel#delete-own-reaction



175
176
177
178
179
180
181
182
183
184
 
# File 'lib/rubycord/api/channel.rb', line 175

def delete_own_reaction(token, channel_id, message_id, emoji)
  emoji = URI.encode_www_form_component(emoji) unless emoji.ascii_only?
  Rubycord::API.request(
    :channels_cid_messages_mid_reactions_emoji_me,
    channel_id,
    :delete,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/messages/#{message_id}/reactions/#{emoji}/@me",
    Authorization: token
  )
end

.delete_permission(token, channel_id, overwrite_id, reason = nil) ⇒ Object

Delete channel permission https://discord.com/developers/docs/resources/channel#delete-channel-permission



283
284
285
286
287
288
289
290
291
292
 
# File 'lib/rubycord/api/channel.rb', line 283

def delete_permission(token, channel_id, overwrite_id, reason = nil)
  Rubycord::API.request(
    :channels_cid_permissions_oid,
    channel_id,
    :delete,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/permissions/#{overwrite_id}",
    Authorization: token,
    "X-Audit-Log-Reason": reason
  )
end

.delete_user_reaction(token, channel_id, message_id, emoji, user_id) ⇒ Object

Delete another client's reaction on a message https://discord.com/developers/docs/resources/channel#delete-user-reaction



188
189
190
191
192
193
194
195
196
197
 
# File 'lib/rubycord/api/channel.rb', line 188

def delete_user_reaction(token, channel_id, message_id, emoji, user_id)
  emoji = URI.encode_www_form_component(emoji) unless emoji.ascii_only?
  Rubycord::API.request(
    :channels_cid_messages_mid_reactions_emoji_uid,
    channel_id,
    :delete,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/messages/#{message_id}/reactions/#{emoji}/#{user_id}",
    Authorization: token
  )
end

.edit_message(token, channel_id, message_id, message, mentions = [], embeds = nil, components = nil) ⇒ Object

Edit a message https://discord.com/developers/docs/resources/channel#edit-message



118
119
120
121
122
123
124
125
126
127
128
 
# File 'lib/rubycord/api/channel.rb', line 118

def edit_message(token, channel_id, message_id, message, mentions = [], embeds = nil, components = nil)
  Rubycord::API.request(
    :channels_cid_messages_mid,
    channel_id,
    :patch,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/messages/#{message_id}",
    {content: message, mentions: mentions, embeds: embeds, components: components}.to_json,
    Authorization: token,
    content_type: :json
  )
end

.get_reactions(token, channel_id, message_id, emoji, before_id, after_id, limit = 100) ⇒ Object

Get a list of clients who reacted with a specific reaction on a message https://discord.com/developers/docs/resources/channel#get-reactions



201
202
203
204
205
206
207
208
209
210
211
 
# File 'lib/rubycord/api/channel.rb', line 201

def get_reactions(token, channel_id, message_id, emoji, before_id, after_id, limit = 100)
  emoji = URI.encode_www_form_component(emoji) unless emoji.ascii_only?
  query_string = URI.encode_www_form({limit: limit || 100, before: before_id, after: after_id}.compact)
  Rubycord::API.request(
    :channels_cid_messages_mid_reactions_emoji,
    channel_id,
    :get,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/messages/#{message_id}/reactions/#{emoji}?#{query_string}",
    Authorization: token
  )
end

.invites(token, channel_id) ⇒ Object

Get a channel's invite list https://discord.com/developers/docs/resources/channel#get-channel-invites



256
257
258
259
260
261
262
263
264
 
# File 'lib/rubycord/api/channel.rb', line 256

def invites(token, channel_id)
  Rubycord::API.request(
    :channels_cid_invites,
    channel_id,
    :get,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/invites",
    Authorization: token
  )
end

.join_thread(token, channel_id) ⇒ Object

Add the current user to a thread. https://discord.com/developers/docs/resources/channel#join-thread



482
483
484
485
486
487
488
489
490
491
 
# File 'lib/rubycord/api/channel.rb', line 482

def join_thread(token, channel_id)
  Rubycord::API.request(
    :channels_cid_thread_members_me,
    channel_id,
    :put,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/thread-members/@me",
    nil,
    Authorization: token
  )
end

.leave_group(token, group_channel_id) ⇒ Object

Deprecated.

Discord no longer supports bots in group DMs, this endpoint was repurposed and no longer works as implemented here.

Leave a group channel. https://discord.com/developers/docs/resources/channel#deleteclose-channel



414
415
416
417
418
419
420
421
422
423
 
# File 'lib/rubycord/api/channel.rb', line 414

def leave_group(token, group_channel_id)
  Rubycord::API.request(
    :channels_cid,
    nil,
    :delete,
    "#{Rubycord::API.api_base}/channels/#{group_channel_id}",
    Authorization: token,
    content_type: :json
  )
end

.leave_thread(token, channel_id) ⇒ Object

Remove the current user from a thread. https://discord.com/developers/docs/resources/channel#leave-thread



508
509
510
511
512
513
514
515
516
 
# File 'lib/rubycord/api/channel.rb', line 508

def leave_thread(token, channel_id)
  Rubycord::API.request(
    :channels_cid_thread_members_me,
    channel_id,
    :delete,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/thread-members/#{user_id}",
    Authorization: token
  )
end

.list_active_threads(token, channel_id) ⇒ Object

List active threads https://discord.com/developers/docs/resources/channel#list-active-threads



546
547
548
549
550
551
552
553
554
 
# File 'lib/rubycord/api/channel.rb', line 546

def list_active_threads(token, channel_id)
  Rubycord::API.request(
    :channels_cid_threads_active,
    channel_id,
    :get,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/threads/active",
    Authorization: token
  )
end

.list_joined_private_archived_threads(token, channel_id, before = nil, limit = nil) ⇒ Object

List joined private archived threads. https://discord.com/developers/docs/resources/channel#list-joined-private-archived-threads



586
587
588
589
590
591
592
593
594
595
596
 
# File 'lib/rubycord/api/channel.rb', line 586

def list_joined_private_archived_threads(token, channel_id, before = nil, limit = nil)
  query = URI.encode_www_form({before: before, limit: limit}.compact)

  Rubycord::API.request(
    :channels_cid_users_me_threads_archived_private,
    channel_id,
    :get,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/users/@me/threads/archived/private?#{query}",
    Authorization: token
  )
end

.list_private_archived_threads(token, channel_id, before = nil, limit = nil) ⇒ Object

List private archived threads. https://discord.com/developers/docs/resources/channel#list-private-archived-threads



572
573
574
575
576
577
578
579
580
581
582
 
# File 'lib/rubycord/api/channel.rb', line 572

def list_private_archived_threads(token, channel_id, before = nil, limit = nil)
  query = URI.encode_www_form({before: before, limit: limit}.compact)

  Rubycord::API.request(
    :channels_cid_threads_archived_private,
    channel_id,
    :get,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/threads/archived/private?#{query}",
    Authorization: token
  )
end

.list_public_archived_threads(token, channel_id, before = nil, limit = nil) ⇒ Object

List public archived threads. https://discord.com/developers/docs/resources/channel#list-public-archived-threads



558
559
560
561
562
563
564
565
566
567
568
 
# File 'lib/rubycord/api/channel.rb', line 558

def list_public_archived_threads(token, channel_id, before = nil, limit = nil)
  query = URI.encode_www_form({before: before, limit: limit}.compact)

  Rubycord::API.request(
    :channels_cid_threads_archived_public,
    channel_id,
    :get,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/threads/archived/public?#{query}",
    Authorization: token
  )
end

.list_thread_members(token, channel_id, before, limit) ⇒ Object

Get the members of a thread. https://discord.com/developers/docs/resources/channel#list-thread-members



532
533
534
535
536
537
538
539
540
541
542
 
# File 'lib/rubycord/api/channel.rb', line 532

def list_thread_members(token, channel_id, before, limit)
  query = URI.encode_www_form({before: before, limit: limit}.compact)

  Rubycord::API.request(
    :channels_cid_thread_members,
    channel_id,
    :get,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/thread-members?#{query}",
    Authorization: token
  )
end

.message(token, channel_id, message_id) ⇒ Object

Get a single message from a channel's history by id https://discord.com/developers/docs/resources/channel#get-channel-message



62
63
64
65
66
67
68
69
70
 
# File 'lib/rubycord/api/channel.rb', line 62

def message(token, channel_id, message_id)
  Rubycord::API.request(
    :channels_cid_messages_mid,
    channel_id,
    :get,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/messages/#{message_id}",
    Authorization: token
  )
end

.messages(token, channel_id, amount, before = nil, after = nil, around = nil) ⇒ Object

Get a list of messages from a channel's history https://discord.com/developers/docs/resources/channel#get-channel-messages



49
50
51
52
53
54
55
56
57
58
 
# File 'lib/rubycord/api/channel.rb', line 49

def messages(token, channel_id, amount, before = nil, after = nil, around = nil)
  query_string = URI.encode_www_form({limit: amount, before: before, after: after, around: around}.compact)
  Rubycord::API.request(
    :channels_cid_messages,
    channel_id,
    :get,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/messages?#{query_string}",
    Authorization: token
  )
end

.pin_message(token, channel_id, message_id, reason = nil) ⇒ Object

Pin a message https://discord.com/developers/docs/resources/channel#add-pinned-channel-message



321
322
323
324
325
326
327
328
329
330
331
 
# File 'lib/rubycord/api/channel.rb', line 321

def pin_message(token, channel_id, message_id, reason = nil)
  Rubycord::API.request(
    :channels_cid_pins_mid,
    channel_id,
    :put,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/pins/#{message_id}",
    nil,
    Authorization: token,
    "X-Audit-Log-Reason": reason
  )
end

.pinned_messages(token, channel_id) ⇒ Object

Get a list of pinned messages in a channel https://discord.com/developers/docs/resources/channel#get-pinned-messages



309
310
311
312
313
314
315
316
317
 
# File 'lib/rubycord/api/channel.rb', line 309

def pinned_messages(token, channel_id)
  Rubycord::API.request(
    :channels_cid_pins,
    channel_id,
    :get,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/pins",
    Authorization: token
  )
end

.remove_group_user(token, group_channel_id, user_id) ⇒ Object

Deprecated.

Discord no longer supports bots in group DMs, this endpoint was repurposed and no longer works as implemented here.

Remove a user from a group channel. https://discord.com/developers/docs/resources/channel#group-dm-remove-recipient



400
401
402
403
404
405
406
407
408
409
 
# File 'lib/rubycord/api/channel.rb', line 400

def remove_group_user(token, group_channel_id, user_id)
  Rubycord::API.request(
    :channels_cid_recipients_uid,
    nil,
    :delete,
    "#{Rubycord::API.api_base}/channels/#{group_channel_id}/recipients/#{user_id}",
    Authorization: token,
    content_type: :json
  )
end

.remove_thread_member(token, channel_id, user_id) ⇒ Object

Remove a user from a thread. https://discord.com/developers/docs/resources/channel#remove-thread-member



520
521
522
523
524
525
526
527
528
 
# File 'lib/rubycord/api/channel.rb', line 520

def remove_thread_member(token, channel_id, user_id)
  Rubycord::API.request(
    :channels_cid_thread_members_uid,
    channel_id,
    :delete,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/thread-members/#{user_id}",
    Authorization: token
  )
end

.resolve(token, channel_id) ⇒ Object

Get a channel's data https://discord.com/developers/docs/resources/channel#get-channel



7
8
9
10
11
12
13
14
15
 
# File 'lib/rubycord/api/channel.rb', line 7

def resolve(token, channel_id)
  Rubycord::API.request(
    :channels_cid,
    channel_id,
    :get,
    "#{Rubycord::API.api_base}/channels/#{channel_id}",
    Authorization: token
  )
end

.start_thread_with_message(token, channel_id, message_id, name, auto_archive_duration) ⇒ Object

Start a thread based off a channel message. https://discord.com/developers/docs/resources/channel#start-thread-with-message



454
455
456
457
458
459
460
461
462
463
464
 
# File 'lib/rubycord/api/channel.rb', line 454

def start_thread_with_message(token, channel_id, message_id, name, auto_archive_duration)
  Rubycord::API.request(
    :channels_cid_messages_mid_threads,
    channel_id,
    :post,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/messages/#{message_id}/threads",
    {name: name, auto_archive_duration: auto_archive_duration}.to_json,
    Authorization: token,
    content_type: :json
  )
end

.start_thread_without_message(token, channel_id, name, auto_archive_duration, type = 11) ⇒ Object

Start a thread without an associated message. https://discord.com/developers/docs/resources/channel#start-thread-without-message



468
469
470
471
472
473
474
475
476
477
478
 
# File 'lib/rubycord/api/channel.rb', line 468

def start_thread_without_message(token, channel_id, name, auto_archive_duration, type = 11)
  Rubycord::API.request(
    :channels_cid_threads,
    channel_id,
    :post,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/threads",
    {name: name, auto_archive_duration: auto_archive_duration, type: type},
    Authorization: token,
    content_type: :json
  )
end

.start_typing(token, channel_id) ⇒ Object

Start typing (needs to be resent every 5 seconds to keep up the typing) https://discord.com/developers/docs/resources/channel#trigger-typing-indicator



296
297
298
299
300
301
302
303
304
305
 
# File 'lib/rubycord/api/channel.rb', line 296

def start_typing(token, channel_id)
  Rubycord::API.request(
    :channels_cid_typing,
    channel_id,
    :post,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/typing",
    nil,
    Authorization: token
  )
end

.unpin_message(token, channel_id, message_id, reason = nil) ⇒ Object

Unpin a message https://discord.com/developers/docs/resources/channel#delete-pinned-channel-message



335
336
337
338
339
340
341
342
343
344
 
# File 'lib/rubycord/api/channel.rb', line 335

def unpin_message(token, channel_id, message_id, reason = nil)
  Rubycord::API.request(
    :channels_cid_pins_mid,
    channel_id,
    :delete,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/pins/#{message_id}",
    Authorization: token,
    "X-Audit-Log-Reason": reason
  )
end

.update(token, channel_id, name, topic, position, bitrate, user_limit, nsfw, permission_overwrites = nil, parent_id = nil, rate_limit_per_user = nil, reason = nil) ⇒ Object

Update a channel's data https://discord.com/developers/docs/resources/channel#modify-channel



19
20
21
22
23
24
25
26
27
28
29
30
31
32
 
# File 'lib/rubycord/api/channel.rb', line 19

def update(token, channel_id, name, topic, position, bitrate, user_limit, nsfw, permission_overwrites = nil, parent_id = nil, rate_limit_per_user = nil, reason = nil)
  data = {name: name, position: position, topic: topic, bitrate: bitrate, user_limit: user_limit, nsfw: nsfw, parent_id: parent_id, rate_limit_per_user: rate_limit_per_user}
  data[:permission_overwrites] = permission_overwrites unless permission_overwrites.nil?
  Rubycord::API.request(
    :channels_cid,
    channel_id,
    :patch,
    "#{Rubycord::API.api_base}/channels/#{channel_id}",
    data.to_json,
    Authorization: token,
    content_type: :json,
    "X-Audit-Log-Reason": reason
  )
end

.update_permission(token, channel_id, overwrite_id, allow, deny, type, reason = nil) ⇒ Object

Update a channels permission for a role or member https://discord.com/developers/docs/resources/channel#edit-channel-permissions



241
242
243
244
245
246
247
248
249
250
251
252
 
# File 'lib/rubycord/api/channel.rb', line 241

def update_permission(token, channel_id, overwrite_id, allow, deny, type, reason = nil)
  Rubycord::API.request(
    :channels_cid_permissions_oid,
    channel_id,
    :put,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/permissions/#{overwrite_id}",
    {type: type, id: overwrite_id, allow: allow, deny: deny}.to_json,
    Authorization: token,
    content_type: :json,
    "X-Audit-Log-Reason": reason
  )
end

.upload_file(token, channel_id, file, caption: nil, tts: false) ⇒ Object

Send a file as a message to a channel https://discord.com/developers/docs/resources/channel#upload-file



105
106
107
108
109
110
111
112
113
114
 
# File 'lib/rubycord/api/channel.rb', line 105

def upload_file(token, channel_id, file, caption: nil, tts: false)
  Rubycord::API.request(
    :channels_cid_messages_mid,
    channel_id,
    :post,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/messages",
    {file: file, content: caption, tts: tts},
    Authorization: token
  )
end

.webhooks(token, channel_id) ⇒ Object

Get channel webhooks https://discord.com/developers/docs/resources/webhook#get-channel-webhooks



442
443
444
445
446
447
448
449
450
 
# File 'lib/rubycord/api/channel.rb', line 442

def webhooks(token, channel_id)
  Rubycord::API.request(
    :channels_cid_webhooks,
    channel_id,
    :get,
    "#{Rubycord::API.api_base}/channels/#{channel_id}/webhooks",
    Authorization: token
  )
end