Thread Tools

Thread creation and membership operations.

Thread tools behave a lot like channel tools, but the target is a thread ID or thread name rather than a parent text channel.

start_thread_from_message #

  • Purpose: start a thread from an existing message.
  • Key arguments: channel scope + message_id, name.
  • Optional fields: auto-archive duration and slowmode.

start_thread_in_channel #

  • Purpose: start a standalone thread in a channel.
  • Key arguments: channel scope, name.
  • Optional fields: type, invitable, auto-archive, slowmode.
  • Notes:
  • Thread type matters for visibility and whether non-moderators can invite more users.

join_thread #

  • Purpose: join a thread as the bot.
  • Key arguments: thread scope (channel_id or channel_name).

leave_thread #

  • Purpose: leave a thread as the bot.
  • Key arguments: thread scope (channel_id or channel_name).

add_thread_member #

  • Purpose: add a user to a thread.
  • Key arguments: thread scope, member identity.

remove_thread_member #

  • Purpose: remove a user from a thread.
  • Key arguments: thread scope, member identity.