threads_join
threads_join
Section titled “threads_join”Category: threads
Join the current bot user to a thread.
When to use
Section titled “When to use”- Bot must be a member to receive thread events / send messages.
When NOT to use
Section titled “When NOT to use”- Adding another user → use
threads_add_member.
| Field | Type | Required | Description |
|---|---|---|---|
thread_id | string | yes | Thread to join |
Returns
Section titled “Returns”\{joined, thread_id\}. Idempotent — re-joining is a no-op.
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
joined | boolean | yes | |
thread_id | string | yes | Discord channel ID (snowflake) |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | no |
| Destructive | no |
| Idempotent | yes |
| Open-world | yes |
| Confirmation required | no |