{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "method": "getInboxConversation",
    "group": "Inbox",
    "summary": "Get a conversation by ID",
    "description": "`Conversation` is keyed by message ID, oldest first. A sender who is no longer a\nparticipant renders as `Unknown[<id>]`, and sender ID 0 is `System`.",
    "deprecated": false,
    "params": {
        "type": "object",
        "properties": {
            "key": {
                "description": "API key",
                "type": "string"
            },
            "ConvID": {
                "$ref": "#/$defs/NumericInput"
            }
        },
        "required": [
            "key",
            "ConvID"
        ],
        "x-order": [
            "key",
            "ConvID"
        ]
    },
    "result": {
        "type": "object",
        "properties": {
            "Subject": {
                "type": "string"
            },
            "Sticky": {
                "type": "string",
                "pattern": "^-?\\d+(\\.\\d+)?$"
            },
            "UnRead": {
                "type": "string",
                "pattern": "^-?\\d+(\\.\\d+)?$"
            },
            "Conversation": {
                "type": "object",
                "additionalProperties": {
                    "$ref": "#/$defs/ConversationMessage"
                }
            }
        },
        "required": [
            "Subject",
            "Sticky",
            "UnRead",
            "Conversation"
        ],
        "additionalProperties": false
    },
    "errors": [
        {
            "code": -32001,
            "message": "Invalid API Key"
        },
        {
            "code": -32002,
            "message": "Call Limit Exceeded"
        },
        {
            "code": -32003,
            "message": "User Account Disabled"
        },
        {
            "code": -32004,
            "message": "IP address needs authorization - please check your notices on BTN"
        },
        {
            "code": -32004,
            "message": "Unauthorized IP address"
        },
        {
            "code": 0,
            "message": "ERROR 400"
        },
        {
            "code": 0,
            "message": "Conversation not found."
        },
        {
            "code": 0,
            "message": "Access denied"
        }
    ],
    "examples": [],
    "x-mutating": "Marks the conversation as read for the calling user.",
    "$defs": {
        "ConversationMessage": {
            "type": "object",
            "properties": {
                "Time": {
                    "type": "string",
                    "pattern": "^-?\\d+(\\.\\d+)?$"
                },
                "Username": {
                    "type": "string"
                },
                "Body": {
                    "type": "string"
                }
            },
            "required": [
                "Time",
                "Username",
                "Body"
            ],
            "additionalProperties": false
        },
        "NumericInput": {
            "description": "A whole number, sent either as a JSON number or as a string containing one.\n`5` and `\"5\"` are equivalent, and both are accepted wherever this type appears.",
            "oneOf": [
                {
                    "type": "integer"
                },
                {
                    "type": "string",
                    "pattern": "^-?\\d+(\\.\\d+)?$"
                }
            ]
        }
    }
}
