world_restore
DestructivePut a whole world back to how it was at a moment in the last 30 days (at: an ISO time or milliseconds since 1970): the undo for a wrong wipe or a mass grief.
/api/agent/worlds/restoreBehavior
Put a whole world back to how it was at a moment in the last 30 days (at: an ISO time or milliseconds since 1970): the undo for a wrong wipe or a mass grief. Its open rooms are closed first, so players rejoin the restored world. reason is kept in the project's log. For one player's damage, world_revert is narrower.
Input parameters
worldRequiredstring- Pattern: ^[a-z0-9][a-z0-9-]{0,62}$
atRequiredstring | integerNested schema
{
"anyOf": [
{
"type": "string",
"minLength": 10,
"maxLength": 40
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
]
}reasonRequiredstring- 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
{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"world": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]{0,62}$"
},
"at": {
"anyOf": [
{
"type": "string",
"minLength": 10,
"maxLength": 40
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
]
},
"reason": {
"type": "string",
"minLength": 3,
"maxLength": 300
},
"env": {
"type": "string",
"enum": [
"public",
"preview"
]
}
},
"required": [
"world",
"at",
"reason"
],
"additionalProperties": false
}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.