Update membership screening
discord_
Write
- Toolset
- Screening
screening - Discord permission
- Manage Server
- Context cost
- 362 tokens, estimated1,446 bytes of definition, divided by 4
Update the server's membership screening form: set the welcome description and the rules new members must agree to. Only provided fields change. Passing form_fields replaces every existing field with TERMS rule blocks, which deletes any question field. Read the form first with discord_. Requires the Community feature and the Manage Server permission. Returns the updated form.
Risk and annotations
Read-onlyreadOnlyHint | no | Can modify your server. |
|---|---|---|
DestructivedestructiveHint | no | Declared non-destructive. |
IdempotentidempotentHint | yes | Repeating the call with the same arguments has no additional effect. |
Open worldopenWorldHint | yes | Interacts with an external system: Discord. |
Annotations are hints the server declares. Clients use them to decide when to ask you before a call.
Parameters
| Parameter | Type | Rules | Description |
|---|---|---|---|
| guild_ | string | pattern ^\d{17,20}$ | Discord server (guild) ID (snowflake). |
| descriptionoptional | string | none | Welcome message shown at the top of the screening form. |
| form_ | array of objects | none | Rules/agreement blocks new members must accept. Replaces the existing fields when provided. |
| label (nested, level 1)required | string | none | Title of this rules block. |
| values (nested, level 1)required | array of strings | none | Individual rule lines shown under the label. |
| required (nested, level 1) | boolean | none | Whether the member must agree to this block. Default true. |
Output
This tool declares no output schema. Its description says what it returns; this page shows no example rather than invent one.
Related tools
Named in its description
Raw definition (1,446 bytes)
{
"name": "discord_update_membership_screening",
"description": "Update the server's membership screening form: set the welcome description and the rules new members must agree to. Only provided fields change. Passing form_fields replaces every existing field with TERMS rule blocks, which deletes any question field. Read the form first with discord_get_membership_screening. Requires the Community feature and the Manage Server permission. Returns the updated form.",
"inputSchema": {
"type": "object",
"properties": {
"guild_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "Discord server (guild) ID (snowflake)."
},
"description": {
"description": "Welcome message shown at the top of the screening form.",
"type": "string"
},
"form_fields": {
"description": "Rules/agreement blocks new members must accept. Replaces the existing fields when provided.",
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "Title of this rules block."
},
"values": {
"type": "array",
"items": {
"type": "string"
},
"description": "Individual rule lines shown under the label."
},
"required": {
"description": "Whether the member must agree to this block. Default true.",
"type": "boolean"
}
},
"required": [
"label",
"values"
],
"additionalProperties": false
}
}
},
"required": [
"guild_id"
],
"additionalProperties": false
},
"annotations": {
"title": "Update membership screening",
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": true
}
}