world_delete
DestructiveDelete one world: its rooms close and a join to its name is refused.
POST
/api/agent/worlds/deleteBehavior
Delete one world: its rooms close and a join to its name is refused. Its data is kept 7 days, and world_delete with undo: true within them brings it back; after that it is gone. reason is kept in the project's log. world_export first if the creator wants a copy. Deleting a world is the creator's decision: confirm it with them first.
Input parameters
worldRequiredstring- Pattern: ^[a-z0-9][a-z0-9-]{0,62}$
undoOptionalbooleanreasonRequiredstring- Min. length: 3
- Max. length: 300
envOptional"public" | "preview"The descriptions above include conditional requirements. The full schema below shows structural validation; runtime checks also apply.
JSON Schema
Input schema · draft-7
{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"world": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,62}$"
},
"undo": {
"type": "boolean"
},
"reason": {
"type": "string",
"minLength": 3,
"maxLength": 300
},
"env": {
"type": "string",
"enum": [
"public",
"preview"
]
}
},
"required": [
"world",
"reason"
],
"additionalProperties": false
}Calling this tool
Use its name in your connected MCP client. For the HTTP API, the route is relative to your Convex site URL and requires your agent key as a bearer token. Keep the key on the agent side, outside a game build.