RDD owner API reference
Read-only reference for existing RDC owner and account controls. Normal operation uses WEB or /rdd admin. No requests run from this page.Authentication and ownership
These endpoints require an authenticated RDC account. WEB uses its configured authenticated client, cookies and CSRF handling. Server settings require ownership of that Minecraft server; account participation uses only the caller’s verified identities. A Minecraft X-API-Key is not a substitute for owner authentication. The public reference does not make the endpoints public. Examples contain dummy IDs and never execute here.
Payloads and revisions
Provider paths contain one /api prefix. Successful replies use success, message, data and timestamp; error details depend on the originating guard. Configuration writes send the revision from the latest snapshot. options values are strings, including booleans, numbers and serialized reward JSON. Use the GUI for normal editing. Snowflake IDs remain strings. When saving, send the complete configuration, preserve settings you are not changing and review concurrent changes.
Configuration
Route
RoleRule
AlertRule
Owner and account endpoints
Six existing operations; this reference sends no requests.
GET /api/servers/{id}/discord Read the server’s editor snapshot
Authentication
Authenticated RDC account owning this Minecraft server.
Parameters and body
Response
Snapshot with configuration, schema, choices, botRunning, diagnostics and pending.
Response example
{
"success": true,
"message": "RDD settings",
"data": {
"serverId": 42,
"configuration": {
"revision": 7,
"guildId": "123456789012345678",
"primaryServerId": 42,
"enabled": false,
"routes": [
{
"id": "minecraft-chat",
"channelId": "234567890123456789",
"kind": "CHAT",
"direction": "BOTH",
"format": "[{server}] {displayname}: {message}",
"webhook": false,
"allowedRoles": [],
"blockedUsers": [],
"requiredPrefix": "",
"gameChannel": "global"
}
],
"roles": [],
"alerts": [],
"options": {
"guild.inviteUrl": "",
"chat.minecraftFormat": "[Discord | {username}] {message}",
"chat.maxLength": "256",
"chat.blockBots": "true",
"chat.blockWebhooks": "true",
"chat.allowMentions": "false",
"chat.requireLinked": "false",
"chat.blockedPhrases": "",
"chat.emojiMode": "NAME",
"chat.avatarUrl": "",
"chat.mentionSound": "true",
"gate.enabled": "false",
"gate.requireMembership": "true",
"gate.roles": "",
"gate.allRoles": "false",
"gate.cacheHours": "24",
"sync.linkedRole": "",
"sync.nicknameEnabled": "false",
"sync.nicknameFormat": "{username}",
"sync.banToMinecraft": "false",
"sync.banToDiscord": "false",
"sync.intervalSeconds": "300",
"rewards.link": "{\"type\":\"xp\",\"amount\":2,\"mode\":\"POINTS\"}",
"rewards.member": "",
"rewards.boost": "",
"console.enabled": "false",
"console.roles": "",
"console.commands": "list\ntps\nsay",
"console.forwardOutput": "false",
"console.blockedPhrases": "token\nsecret\npassword\napi-key\nauthorization",
"console.deleteAfterSeconds": "0",
"voice.enabled": "false",
"voice.categoryId": "",
"voice.lobbyId": "",
"voice.horizontal": "80",
"voice.vertical": "40",
"voice.falloff": "5",
"voice.intervalTicks": "10",
"voice.visible": "false",
"voice.muteLobby": "false",
"status.panel": "{server}: {online}/{max} players | {status}",
"status.channelName": "",
"status.channelTopic": "",
"status.intervalSeconds": "600",
"status.watchdogSeconds": "30",
"status.watchdogEnabled": "true",
"responses.ip": "",
"responses.website": "",
"locale": "en_US"
}
},
"schema": [
{
"key": "guild.inviteUrl",
"kind": "TEXT",
"defaultValue": "",
"section": "accounts",
"minimum": 0,
"maximum": 255
},
{
"key": "chat.minecraftFormat",
"kind": "TEXT",
"defaultValue": "[Discord | {username}] {message}",
"section": "chat",
"minimum": 0,
"maximum": 1024
},
{
"key": "chat.maxLength",
"kind": "INTEGER",
"defaultValue": "256",
"section": "chat",
"minimum": 1,
"maximum": 2000
},
{
"key": "chat.blockBots",
"kind": "BOOLEAN",
"defaultValue": "true",
"section": "chat",
"minimum": 0,
"maximum": 0
},
{
"key": "chat.blockWebhooks",
"kind": "BOOLEAN",
"defaultValue": "true",
"section": "chat",
"minimum": 0,
"maximum": 0
},
{
"key": "chat.allowMentions",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "chat",
"minimum": 0,
"maximum": 0
},
{
"key": "chat.requireLinked",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "chat",
"minimum": 0,
"maximum": 0
},
{
"key": "chat.blockedPhrases",
"kind": "TEXT",
"defaultValue": "",
"section": "chat",
"minimum": 0,
"maximum": 4096
},
{
"key": "chat.emojiMode",
"kind": "TEXT",
"defaultValue": "NAME",
"section": "chat",
"minimum": 0,
"maximum": 16
},
{
"key": "chat.avatarUrl",
"kind": "TEXT",
"defaultValue": "",
"section": "chat",
"minimum": 0,
"maximum": 512
},
{
"key": "chat.mentionSound",
"kind": "BOOLEAN",
"defaultValue": "true",
"section": "chat",
"minimum": 0,
"maximum": 0
},
{
"key": "gate.enabled",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "accounts",
"minimum": 0,
"maximum": 0
},
{
"key": "gate.requireMembership",
"kind": "BOOLEAN",
"defaultValue": "true",
"section": "accounts",
"minimum": 0,
"maximum": 0
},
{
"key": "gate.roles",
"kind": "TEXT",
"defaultValue": "",
"section": "accounts",
"minimum": 0,
"maximum": 1024
},
{
"key": "gate.allRoles",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "accounts",
"minimum": 0,
"maximum": 0
},
{
"key": "gate.cacheHours",
"kind": "INTEGER",
"defaultValue": "24",
"section": "accounts",
"minimum": 0,
"maximum": 24
},
{
"key": "sync.linkedRole",
"kind": "TEXT",
"defaultValue": "",
"section": "sync",
"minimum": 0,
"maximum": 32
},
{
"key": "sync.nicknameEnabled",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "sync",
"minimum": 0,
"maximum": 0
},
{
"key": "sync.nicknameFormat",
"kind": "TEXT",
"defaultValue": "{username}",
"section": "sync",
"minimum": 0,
"maximum": 128
},
{
"key": "sync.banToMinecraft",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "sync",
"minimum": 0,
"maximum": 0
},
{
"key": "sync.banToDiscord",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "sync",
"minimum": 0,
"maximum": 0
},
{
"key": "sync.intervalSeconds",
"kind": "INTEGER",
"defaultValue": "300",
"section": "sync",
"minimum": 30,
"maximum": 3600
},
{
"key": "rewards.link",
"kind": "TEXT",
"defaultValue": "",
"section": "rewards",
"minimum": 0,
"maximum": 4096
},
{
"key": "rewards.member",
"kind": "TEXT",
"defaultValue": "",
"section": "rewards",
"minimum": 0,
"maximum": 4096
},
{
"key": "rewards.boost",
"kind": "TEXT",
"defaultValue": "",
"section": "rewards",
"minimum": 0,
"maximum": 4096
},
{
"key": "console.enabled",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "console",
"minimum": 0,
"maximum": 0
},
{
"key": "console.roles",
"kind": "TEXT",
"defaultValue": "",
"section": "console",
"minimum": 0,
"maximum": 1024
},
{
"key": "console.commands",
"kind": "TEXT",
"defaultValue": "list\ntps\nsay",
"section": "console",
"minimum": 0,
"maximum": 2048
},
{
"key": "console.forwardOutput",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "console",
"minimum": 0,
"maximum": 0
},
{
"key": "console.blockedPhrases",
"kind": "TEXT",
"defaultValue": "token\nsecret\npassword\napi-key\nauthorization",
"section": "console",
"minimum": 0,
"maximum": 2048
},
{
"key": "console.deleteAfterSeconds",
"kind": "INTEGER",
"defaultValue": "0",
"section": "console",
"minimum": 0,
"maximum": 3600
},
{
"key": "voice.enabled",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "voice",
"minimum": 0,
"maximum": 0
},
{
"key": "voice.categoryId",
"kind": "TEXT",
"defaultValue": "",
"section": "voice",
"minimum": 0,
"maximum": 32
},
{
"key": "voice.lobbyId",
"kind": "TEXT",
"defaultValue": "",
"section": "voice",
"minimum": 0,
"maximum": 32
},
{
"key": "voice.horizontal",
"kind": "INTEGER",
"defaultValue": "80",
"section": "voice",
"minimum": 1,
"maximum": 512
},
{
"key": "voice.vertical",
"kind": "INTEGER",
"defaultValue": "40",
"section": "voice",
"minimum": 1,
"maximum": 256
},
{
"key": "voice.falloff",
"kind": "INTEGER",
"defaultValue": "5",
"section": "voice",
"minimum": 0,
"maximum": 128
},
{
"key": "voice.intervalTicks",
"kind": "INTEGER",
"defaultValue": "10",
"section": "voice",
"minimum": 5,
"maximum": 200
},
{
"key": "voice.visible",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "voice",
"minimum": 0,
"maximum": 0
},
{
"key": "voice.muteLobby",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "voice",
"minimum": 0,
"maximum": 0
},
{
"key": "status.panel",
"kind": "TEXT",
"defaultValue": "{server}: {online}/{max} players | {status}",
"section": "status",
"minimum": 0,
"maximum": 2000
},
{
"key": "status.channelName",
"kind": "TEXT",
"defaultValue": "",
"section": "status",
"minimum": 0,
"maximum": 100
},
{
"key": "status.channelTopic",
"kind": "TEXT",
"defaultValue": "",
"section": "status",
"minimum": 0,
"maximum": 1024
},
{
"key": "status.intervalSeconds",
"kind": "INTEGER",
"defaultValue": "600",
"section": "status",
"minimum": 600,
"maximum": 3600
},
{
"key": "status.watchdogSeconds",
"kind": "INTEGER",
"defaultValue": "30",
"section": "status",
"minimum": 10,
"maximum": 600
},
{
"key": "status.watchdogEnabled",
"kind": "BOOLEAN",
"defaultValue": "true",
"section": "status",
"minimum": 0,
"maximum": 0
},
{
"key": "responses.ip",
"kind": "TEXT",
"defaultValue": "",
"section": "responses",
"minimum": 0,
"maximum": 255
},
{
"key": "responses.website",
"kind": "TEXT",
"defaultValue": "",
"section": "responses",
"minimum": 0,
"maximum": 512
},
{
"key": "locale",
"kind": "TEXT",
"defaultValue": "en_US",
"section": "general",
"minimum": 0,
"maximum": 16
}
],
"choices": [],
"botRunning": true,
"diagnostics": [
"bridge_disabled"
],
"pending": 0
},
"timestamp": 0
}PUT /api/servers/{id}/discord Save a revision-checked configuration
Authentication
Authenticated RDC account owning this Minecraft server.
Parameters and body
Response
Confirmed snapshot after validation and save.
Request example
{
"revision": 7,
"guildId": "123456789012345678",
"primaryServerId": 42,
"enabled": false,
"routes": [
{
"id": "minecraft-chat",
"channelId": "234567890123456789",
"kind": "CHAT",
"direction": "BOTH",
"format": "[{server}] {displayname}: {message}",
"webhook": false,
"allowedRoles": [],
"blockedUsers": [],
"requiredPrefix": "",
"gameChannel": "global"
}
],
"roles": [],
"alerts": [],
"options": {
"chat.blockBots": "true",
"console.enabled": "false",
"voice.enabled": "false",
"rewards.link": "{\"type\":\"xp\",\"amount\":2,\"mode\":\"POINTS\"}"
}
}Response example
{
"success": true,
"message": "RDD settings saved",
"data": {
"serverId": 42,
"configuration": {
"revision": 8,
"guildId": "123456789012345678",
"primaryServerId": 42,
"enabled": false,
"routes": [
{
"id": "minecraft-chat",
"channelId": "234567890123456789",
"kind": "CHAT",
"direction": "BOTH",
"format": "[{server}] {displayname}: {message}",
"webhook": false,
"allowedRoles": [],
"blockedUsers": [],
"requiredPrefix": "",
"gameChannel": "global"
}
],
"roles": [],
"alerts": [],
"options": {
"guild.inviteUrl": "",
"chat.minecraftFormat": "[Discord | {username}] {message}",
"chat.maxLength": "256",
"chat.blockBots": "true",
"chat.blockWebhooks": "true",
"chat.allowMentions": "false",
"chat.requireLinked": "false",
"chat.blockedPhrases": "",
"chat.emojiMode": "NAME",
"chat.avatarUrl": "",
"chat.mentionSound": "true",
"gate.enabled": "false",
"gate.requireMembership": "true",
"gate.roles": "",
"gate.allRoles": "false",
"gate.cacheHours": "24",
"sync.linkedRole": "",
"sync.nicknameEnabled": "false",
"sync.nicknameFormat": "{username}",
"sync.banToMinecraft": "false",
"sync.banToDiscord": "false",
"sync.intervalSeconds": "300",
"rewards.link": "{\"type\":\"xp\",\"amount\":2,\"mode\":\"POINTS\"}",
"rewards.member": "",
"rewards.boost": "",
"console.enabled": "false",
"console.roles": "",
"console.commands": "list\ntps\nsay",
"console.forwardOutput": "false",
"console.blockedPhrases": "token\nsecret\npassword\napi-key\nauthorization",
"console.deleteAfterSeconds": "0",
"voice.enabled": "false",
"voice.categoryId": "",
"voice.lobbyId": "",
"voice.horizontal": "80",
"voice.vertical": "40",
"voice.falloff": "5",
"voice.intervalTicks": "10",
"voice.visible": "false",
"voice.muteLobby": "false",
"status.panel": "{server}: {online}/{max} players | {status}",
"status.channelName": "",
"status.channelTopic": "",
"status.intervalSeconds": "600",
"status.watchdogSeconds": "30",
"status.watchdogEnabled": "true",
"responses.ip": "",
"responses.website": "",
"locale": "en_US"
}
},
"schema": [
{
"key": "guild.inviteUrl",
"kind": "TEXT",
"defaultValue": "",
"section": "accounts",
"minimum": 0,
"maximum": 255
},
{
"key": "chat.minecraftFormat",
"kind": "TEXT",
"defaultValue": "[Discord | {username}] {message}",
"section": "chat",
"minimum": 0,
"maximum": 1024
},
{
"key": "chat.maxLength",
"kind": "INTEGER",
"defaultValue": "256",
"section": "chat",
"minimum": 1,
"maximum": 2000
},
{
"key": "chat.blockBots",
"kind": "BOOLEAN",
"defaultValue": "true",
"section": "chat",
"minimum": 0,
"maximum": 0
},
{
"key": "chat.blockWebhooks",
"kind": "BOOLEAN",
"defaultValue": "true",
"section": "chat",
"minimum": 0,
"maximum": 0
},
{
"key": "chat.allowMentions",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "chat",
"minimum": 0,
"maximum": 0
},
{
"key": "chat.requireLinked",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "chat",
"minimum": 0,
"maximum": 0
},
{
"key": "chat.blockedPhrases",
"kind": "TEXT",
"defaultValue": "",
"section": "chat",
"minimum": 0,
"maximum": 4096
},
{
"key": "chat.emojiMode",
"kind": "TEXT",
"defaultValue": "NAME",
"section": "chat",
"minimum": 0,
"maximum": 16
},
{
"key": "chat.avatarUrl",
"kind": "TEXT",
"defaultValue": "",
"section": "chat",
"minimum": 0,
"maximum": 512
},
{
"key": "chat.mentionSound",
"kind": "BOOLEAN",
"defaultValue": "true",
"section": "chat",
"minimum": 0,
"maximum": 0
},
{
"key": "gate.enabled",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "accounts",
"minimum": 0,
"maximum": 0
},
{
"key": "gate.requireMembership",
"kind": "BOOLEAN",
"defaultValue": "true",
"section": "accounts",
"minimum": 0,
"maximum": 0
},
{
"key": "gate.roles",
"kind": "TEXT",
"defaultValue": "",
"section": "accounts",
"minimum": 0,
"maximum": 1024
},
{
"key": "gate.allRoles",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "accounts",
"minimum": 0,
"maximum": 0
},
{
"key": "gate.cacheHours",
"kind": "INTEGER",
"defaultValue": "24",
"section": "accounts",
"minimum": 0,
"maximum": 24
},
{
"key": "sync.linkedRole",
"kind": "TEXT",
"defaultValue": "",
"section": "sync",
"minimum": 0,
"maximum": 32
},
{
"key": "sync.nicknameEnabled",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "sync",
"minimum": 0,
"maximum": 0
},
{
"key": "sync.nicknameFormat",
"kind": "TEXT",
"defaultValue": "{username}",
"section": "sync",
"minimum": 0,
"maximum": 128
},
{
"key": "sync.banToMinecraft",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "sync",
"minimum": 0,
"maximum": 0
},
{
"key": "sync.banToDiscord",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "sync",
"minimum": 0,
"maximum": 0
},
{
"key": "sync.intervalSeconds",
"kind": "INTEGER",
"defaultValue": "300",
"section": "sync",
"minimum": 30,
"maximum": 3600
},
{
"key": "rewards.link",
"kind": "TEXT",
"defaultValue": "",
"section": "rewards",
"minimum": 0,
"maximum": 4096
},
{
"key": "rewards.member",
"kind": "TEXT",
"defaultValue": "",
"section": "rewards",
"minimum": 0,
"maximum": 4096
},
{
"key": "rewards.boost",
"kind": "TEXT",
"defaultValue": "",
"section": "rewards",
"minimum": 0,
"maximum": 4096
},
{
"key": "console.enabled",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "console",
"minimum": 0,
"maximum": 0
},
{
"key": "console.roles",
"kind": "TEXT",
"defaultValue": "",
"section": "console",
"minimum": 0,
"maximum": 1024
},
{
"key": "console.commands",
"kind": "TEXT",
"defaultValue": "list\ntps\nsay",
"section": "console",
"minimum": 0,
"maximum": 2048
},
{
"key": "console.forwardOutput",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "console",
"minimum": 0,
"maximum": 0
},
{
"key": "console.blockedPhrases",
"kind": "TEXT",
"defaultValue": "token\nsecret\npassword\napi-key\nauthorization",
"section": "console",
"minimum": 0,
"maximum": 2048
},
{
"key": "console.deleteAfterSeconds",
"kind": "INTEGER",
"defaultValue": "0",
"section": "console",
"minimum": 0,
"maximum": 3600
},
{
"key": "voice.enabled",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "voice",
"minimum": 0,
"maximum": 0
},
{
"key": "voice.categoryId",
"kind": "TEXT",
"defaultValue": "",
"section": "voice",
"minimum": 0,
"maximum": 32
},
{
"key": "voice.lobbyId",
"kind": "TEXT",
"defaultValue": "",
"section": "voice",
"minimum": 0,
"maximum": 32
},
{
"key": "voice.horizontal",
"kind": "INTEGER",
"defaultValue": "80",
"section": "voice",
"minimum": 1,
"maximum": 512
},
{
"key": "voice.vertical",
"kind": "INTEGER",
"defaultValue": "40",
"section": "voice",
"minimum": 1,
"maximum": 256
},
{
"key": "voice.falloff",
"kind": "INTEGER",
"defaultValue": "5",
"section": "voice",
"minimum": 0,
"maximum": 128
},
{
"key": "voice.intervalTicks",
"kind": "INTEGER",
"defaultValue": "10",
"section": "voice",
"minimum": 5,
"maximum": 200
},
{
"key": "voice.visible",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "voice",
"minimum": 0,
"maximum": 0
},
{
"key": "voice.muteLobby",
"kind": "BOOLEAN",
"defaultValue": "false",
"section": "voice",
"minimum": 0,
"maximum": 0
},
{
"key": "status.panel",
"kind": "TEXT",
"defaultValue": "{server}: {online}/{max} players | {status}",
"section": "status",
"minimum": 0,
"maximum": 2000
},
{
"key": "status.channelName",
"kind": "TEXT",
"defaultValue": "",
"section": "status",
"minimum": 0,
"maximum": 100
},
{
"key": "status.channelTopic",
"kind": "TEXT",
"defaultValue": "",
"section": "status",
"minimum": 0,
"maximum": 1024
},
{
"key": "status.intervalSeconds",
"kind": "INTEGER",
"defaultValue": "600",
"section": "status",
"minimum": 600,
"maximum": 3600
},
{
"key": "status.watchdogSeconds",
"kind": "INTEGER",
"defaultValue": "30",
"section": "status",
"minimum": 10,
"maximum": 600
},
{
"key": "status.watchdogEnabled",
"kind": "BOOLEAN",
"defaultValue": "true",
"section": "status",
"minimum": 0,
"maximum": 0
},
{
"key": "responses.ip",
"kind": "TEXT",
"defaultValue": "",
"section": "responses",
"minimum": 0,
"maximum": 255
},
{
"key": "responses.website",
"kind": "TEXT",
"defaultValue": "",
"section": "responses",
"minimum": 0,
"maximum": 512
},
{
"key": "locale",
"kind": "TEXT",
"defaultValue": "en_US",
"section": "general",
"minimum": 0,
"maximum": 16
}
],
"choices": [],
"botRunning": true,
"diagnostics": [
"bridge_disabled"
],
"pending": 0
},
"timestamp": 0
}GET /api/servers/{id}/discord/install Read the hosted bot installation link
Authentication
Authenticated RDC account owning this Minecraft server.
Parameters and body
Response
Object containing the Discord OAuth installation URL; permissions are currently zero.
Response example
{
"success": true,
"message": "Invite RaindropDiscord",
"data": {
"url": "https://discord.com/oauth2/authorize?client_id=345678901234567890&scope=bot%20applications.commands&integration_type=0&permissions=0"
},
"timestamp": 0
}GET /api/servers/{id}/discord/operations/{operationId} Read this server’s operation outcome
Authentication
Authenticated RDC account owning this Minecraft server.
Parameters and body
Response
Object with outcome and sanitized detail strings.
Response example
{
"success": true,
"message": "RDD operation",
"data": {
"outcome": "UNKNOWN",
"detail": ""
},
"timestamp": 0
}GET /api/user/discord/participation Read your account’s participation selections
Authentication
Authenticated RDC account; only its own verified character selections.
Response
List of guildId, minecraftUuid and active strings for this account.
Response example
{
"success": true,
"message": "RDD participation",
"data": [
{
"guildId": "123456789012345678",
"minecraftUuid": "123e4567-e89b-12d3-a456-426614174000",
"active": "true"
}
],
"timestamp": 0
}PUT /api/user/discord/participation/{guildId} Select your verified character or opt out
Authentication
Authenticated RDC account; only its own verified character selections.
Parameters and body
Response
Object with the selected minecraftUuid and active string.
Request example
{
"minecraftUuid": "123e4567-e89b-12d3-a456-426614174000",
"active": "true"
}Response example
{
"success": true,
"message": "RDD participation saved",
"data": {
"minecraftUuid": "123e4567-e89b-12d3-a456-426614174000",
"active": "true"
},
"timestamp": 0
}Error example
{
"success": false,
"message": "configuration_conflict",
"data": null,
"timestamp": 0
}Failures and outcomes
Validation failures use 400 and revision/state conflicts use 409. Authentication and ownership guards may return 401, 403 or 404. Missing or foreign operation IDs are not exposed. Do not assume every error has the same envelope. A receipt describes the recorded operation outcome; it does not authorize a blind retry.