{"openapi":"3.1.0","info":{"title":"Inline Bot HTTP API Docs","version":"0.0.1","description":"## Authentication\n\nRecommended: send the bot token via the `Authorization: Bearer <token>` header.\n\nAlternative: include the token in the URL path using `/bot<token>/<method>`.\n\nFor method parameters, use JSON request body (recommended). Query parameters on POST are also accepted for compatibility.\n\nTokens look like `123:IN...` and contain a `:`. Most HTTP clients handle this in the path fine, but if yours doesn't, URL-encode the token segment (e.g. `:` -> `%3A`).\n\n### Header auth (recommended)\n\n```bash\ncurl -sS \\\n  -H 'Authorization: Bearer <token>' \\\n  -H 'Content-Type: application/json' \\\n  -X POST 'https://api.inline.chat/bot/sendMessage' \\\n  -d '{\"user_id\": 1001, \"text\": \"hello from bot\"}'\n```\n\n### Token in path\n\n```bash\ncurl -sS \\\n  -H 'Content-Type: application/json' \\\n  -X POST 'https://api.inline.chat/bot<token>/sendMessage' \\\n  -d '{\"chat_id\": 42, \"text\": \"hello from bot\"}'\n```\n\nTargeting: use `chat_id` for chats/threads or `user_id` for DMs.\n\nErrors return `{ \"ok\": false, \"error_code\": <http status>, \"description\": \"...\" }`; `error` may be present as a machine-readable code.\n\n### Quick check\n\n```bash\ncurl -sS 'https://api.inline.chat/bot<token>/getMe'\n```","contact":{"email":"hi@inline.chat","name":"Inline Team","url":"https://inline.chat"},"termsOfService":"https://inline.chat/terms"},"paths":{"/bot{token}/addThreadParticipant":{"post":{"tags":["Bot"],"operationId":"bot.pathAddThreadParticipant","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Adds one user to a thread. The authenticated bot must have permission to manage that thread's participants.","summary":"Add a thread participant","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadParticipantMutationInput"}}},"required":false}}},"/bot{token}/answerMessageAction":{"post":{"tags":["Bot"],"operationId":"bot.pathAnswerMessageAction","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Acknowledges an action interaction and optionally shows a short toast.","summary":"Answer a message action","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswerMessageActionInput"}}},"required":false}}},"/bot{token}/createAgent":{"post":{"tags":["Bot"],"operationId":"bot.pathCreateAgent","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"BotCreateAgentSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotCreateAgentSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Creates a named specialization owned by the authenticated bot. Name is required; skill and instructions are independently optional.","summary":"Create an Agent","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAgentInput"}}},"required":false}}},"/bot{token}/createReplyThread":{"post":{"tags":["Bot"],"operationId":"bot.pathCreateReplyThread","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful normal or reply-thread creation response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotCreateThreadSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Creates or returns the reply thread anchored to one message.","summary":"Create a reply thread","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateReplyThreadInput"}}},"required":false}}},"/bot{token}/createThread":{"post":{"tags":["Bot"],"operationId":"bot.pathCreateThread","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful normal or reply-thread creation response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotCreateThreadSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Creates a normal home or space thread using Inline's existing access rules.","summary":"Create a thread","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateThreadInput"}}},"required":false}}},"/bot{token}/deleteAgent":{"post":{"tags":["Bot"],"operationId":"bot.pathDeleteAgent","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"BotDeleteAgentSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotDeleteAgentSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Deletes an Agent owned by the authenticated bot without changing the backing bot.","summary":"Delete an Agent","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteAgentInput"}}},"required":false}}},"/bot{token}/deleteMessage":{"post":{"tags":["Bot"],"operationId":"bot.pathDeleteMessage","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Deletes a message from a private conversation or chat. Returns an empty result when the message is deleted.","summary":"Delete a message","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteMessageInput"}}},"required":false}}},"/bot{token}/deleteMessages":{"post":{"tags":["Bot"],"operationId":"bot.pathDeleteMessages","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Deletes up to 100 messages from one chat. Missing message IDs are skipped.","summary":"Delete messages","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteMessagesInput"}}},"required":false}}},"/bot{token}/deleteMyCommands":{"post":{"tags":["Bot"],"operationId":"bot.pathDeleteMyCommands","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Deletes every command published by the authenticated bot. Returns an empty result when the command list is cleared.","summary":"Delete bot commands"}},"/bot{token}/deleteMySkills":{"post":{"tags":["Bot"],"operationId":"bot.pathDeleteMySkills","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Deletes every installed skill published by the authenticated bot harness.","summary":"Delete bot skills"}},"/bot{token}/deleteReaction":{"post":{"tags":["Bot"],"operationId":"bot.pathDeleteReaction","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Removes the bot's emoji reaction from one message.","summary":"Delete a reaction","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteReactionInput"}}},"required":false}}},"/bot{token}/deleteWebhook":{"post":{"tags":["Bot"],"operationId":"bot.pathDeleteWebhook","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"BotTrueSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotTrueSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Disables webhook delivery while preserving pending updates unless explicitly dropped.","summary":"Delete webhook","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteWebhookInput"}}},"required":false}}},"/bot{token}/editMessageActions":{"post":{"tags":["Bot"],"operationId":"bot.pathEditMessageActions","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful sendMessage, editMessageText, or editMessageActions response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotMessageSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Replaces all actions on a bot-authored message without changing its text. Send an empty actions array to clear them.","summary":"Edit message actions","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditMessageActionsInput"}}},"required":false}}},"/bot{token}/editMessageText":{"post":{"tags":["Bot"],"operationId":"bot.pathEditMessageText","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful sendMessage, editMessageText, or editMessageActions response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotMessageSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Replaces the text and formatting of a message in a private conversation or chat. On success, returns the updated message.","summary":"Edit message text","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditMessageTextInput"}}},"required":false}}},"/bot{token}/forwardMessage":{"post":{"tags":["Bot"],"operationId":"bot.pathForwardMessage","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful sendMessage, editMessageText, or editMessageActions response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotMessageSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Forwards one accessible message into another accessible chat.","summary":"Forward a message","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForwardMessageInput"}}},"required":false}}},"/bot{token}/forwardMessages":{"post":{"tags":["Bot"],"operationId":"bot.pathForwardMessages","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"BotForwardMessagesSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForwardMessagesSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Forwards up to 100 accessible messages and returns their new IDs. Missing source IDs are skipped.","summary":"Forward messages","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForwardMessagesInput"}}},"required":false}}},"/bot{token}/getAgent":{"get":{"tags":["Bot"],"operationId":"bot.pathGetAgent","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."},{"name":"agent_id","in":"query","schema":{"$ref":"#/components/schemas/SafeIntegerString"},"required":true,"description":"Bot method parameter."}],"security":[],"responses":{"200":{"description":"BotGetAgentSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetAgentSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns one globally identified Agent owned by the authenticated bot.","summary":"Get an Agent"}},"/bot{token}/getChat":{"get":{"tags":["Bot"],"operationId":"bot.pathGetChat","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."},{"name":"user_id","in":"query","schema":{"$ref":"#/components/schemas/UserIdString"},"required":false,"description":"Target a private conversation with this user. Supply exactly one of user_id or chat_id."},{"name":"chat_id","in":"query","schema":{"$ref":"#/components/schemas/ChatIdString"},"required":false,"description":"Target this chat. Supply exactly one of chat_id or user_id."}],"security":[],"responses":{"200":{"description":"Successful getChat response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetChatSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns current information about a private conversation or chat, including its latest message when available. Supply exactly one of user_id or chat_id.","summary":"Get a chat"}},"/bot{token}/getChatHistory":{"get":{"tags":["Bot"],"operationId":"bot.pathGetChatHistory","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."},{"name":"user_id","in":"query","schema":{"$ref":"#/components/schemas/UserIdString"},"required":false,"description":"Target a private conversation with this user. Supply exactly one of user_id or chat_id."},{"name":"chat_id","in":"query","schema":{"$ref":"#/components/schemas/ChatIdString"},"required":false,"description":"Target this chat. Supply exactly one of chat_id or user_id."},{"name":"limit","in":"query","schema":{"$ref":"#/components/schemas/SafeIntegerString"},"required":false,"description":"Maximum number of messages to return."},{"name":"offset_message_id","in":"query","schema":{"$ref":"#/components/schemas/MessageIdString"},"required":false,"description":"Pagination cursor. When supplied, return messages older than this message."}],"security":[],"responses":{"200":{"description":"Successful getChatHistory response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetChatHistorySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns a page of messages from a private conversation or chat. Supply exactly one of user_id or chat_id, and use offset_message_id to request older messages.","summary":"Get chat history"}},"/bot{token}/getChatParticipant":{"get":{"tags":["Bot"],"operationId":"bot.pathGetChatParticipant","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."},{"name":"chat_id","in":"query","schema":{"$ref":"#/components/schemas/ChatIdString"},"required":true,"description":"Bot method parameter."},{"name":"user_id","in":"query","schema":{"$ref":"#/components/schemas/UserIdString"},"required":true,"description":"Bot method parameter."}],"security":[],"responses":{"200":{"description":"BotGetChatParticipantSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetChatParticipantSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns one participant of an accessible chat, with space membership when applicable.","summary":"Get a chat participant"}},"/bot{token}/getChatParticipantCount":{"get":{"tags":["Bot"],"operationId":"bot.pathGetChatParticipantCount","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."},{"name":"chat_id","in":"query","schema":{"$ref":"#/components/schemas/ChatIdString"},"required":true,"description":"Bot method parameter."}],"security":[],"responses":{"200":{"description":"BotGetChatParticipantCountSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetChatParticipantCountSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns the number of participants in an accessible chat.","summary":"Get chat participant count"}},"/bot{token}/getFile":{"get":{"tags":["Bot"],"operationId":"bot.pathGetFile","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."},{"name":"file_id","in":"query","schema":{"type":"string","allOf":[{"minLength":1}]},"required":true,"description":"Bot method parameter."}],"security":[],"responses":{"200":{"description":"BotGetFileSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetFileSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns metadata and a short-lived download URL for a Bot-owned file or a file in a currently accessible message.","summary":"Get a file"}},"/bot{token}/getMe":{"get":{"tags":["Bot"],"operationId":"bot.pathGetMe","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful getMe response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetMeSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"A simple method for testing bot authentication. Returns basic information about the bot account associated with the supplied token.","summary":"Get the current bot"}},"/bot{token}/getMessages":{"post":{"tags":["Bot"],"operationId":"bot.pathGetMessages","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful exact-message read or search response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotMessagesSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns up to 100 requested messages from one accessible chat, in request order.","summary":"Get exact messages","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetMessagesInput"}}},"required":false}}},"/bot{token}/getMyAgents":{"get":{"tags":["Bot"],"operationId":"bot.pathGetMyAgents","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"BotGetMyAgentsSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetMyAgentsSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns every Agent owned by the authenticated bot.","summary":"List my Agents"}},"/bot{token}/getMyCommands":{"get":{"tags":["Bot"],"operationId":"bot.pathGetMyCommands","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful getMyCommands response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetMyCommandsSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns the command list currently published by the authenticated bot.","summary":"Get bot commands"}},"/bot{token}/getMySkills":{"get":{"tags":["Bot"],"operationId":"bot.pathGetMySkills","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful getMySkills response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetMySkillsSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns the installed skill catalog currently published by the authenticated bot harness.","summary":"Get bot skills"}},"/bot{token}/getSpace":{"post":{"tags":["Bot"],"operationId":"bot.pathGetSpace","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful getSpace response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetSpaceSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns one accessible space, the bot's own membership, and bot-relevant settings without exposing the member roster.","summary":"Get a space","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetSpaceInput"}}},"required":false}}},"/bot{token}/getUpdates":{"get":{"tags":["Bot"],"operationId":"bot.pathGetUpdates","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."},{"name":"offset","in":"query","schema":{"$ref":"#/components/schemas/MessageIdString"},"required":false,"description":"Bot method parameter."},{"name":"limit","in":"query","schema":{"$ref":"#/components/schemas/SafeIntegerString"},"required":false,"description":"Bot method parameter."},{"name":"timeout","in":"query","schema":{"$ref":"#/components/schemas/SafeIntegerString"},"required":false,"description":"Bot method parameter."},{"name":"message_trigger","in":"query","schema":{"$ref":"#/components/schemas/BotMessageTrigger"},"required":false,"description":"Bot method parameter."},{"name":"allowed_updates","in":"query","schema":{"anyOf":[{"type":"string"},{"type":"array","items":{"$ref":"#/components/schemas/BotUpdateKey"}}]},"required":false,"description":"Bot method parameter."}],"security":[],"responses":{"200":{"description":"BotGetUpdatesSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetUpdatesSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Long-polls the authenticated Bot's bounded pending-update queue.","summary":"Get updates"}},"/bot{token}/getWebhookInfo":{"get":{"tags":["Bot"],"operationId":"bot.pathGetWebhookInfo","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"BotWebhookInfoSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotWebhookInfoSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns effective delivery settings and pending/error counters without exposing the secret.","summary":"Get webhook info"}},"/bot{token}/pinMessage":{"post":{"tags":["Bot"],"operationId":"bot.pathPinMessage","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Pins one message in a chat.","summary":"Pin a message","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PinMessageInput"}}},"required":false}}},"/bot{token}/removeThreadParticipant":{"post":{"tags":["Bot"],"operationId":"bot.pathRemoveThreadParticipant","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Removes one user from a thread. The authenticated bot must have permission to manage that thread's participants and cannot remove itself.","summary":"Remove a thread participant","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadParticipantMutationInput"}}},"required":false}}},"/bot{token}/searchMessages":{"post":{"tags":["Bot"],"operationId":"bot.pathSearchMessages","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful exact-message read or search response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotMessagesSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Searches messages within exactly one accessible chat, newest first.","summary":"Search one chat","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchMessagesInput"}}},"required":false}}},"/bot{token}/sendChatAction":{"post":{"tags":["Bot"],"operationId":"bot.pathSendChatAction","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Publishes a short-lived typing or upload indicator.","summary":"Send a chat action","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendChatActionInput"}}},"required":false}}},"/bot{token}/sendMessage":{"post":{"tags":["Bot"],"operationId":"bot.pathSendMessage","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful sendMessage, editMessageText, or editMessageActions response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotMessageSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Sends a text message to a private user or chat. Supply exactly one of user_id or chat_id. On success, returns the sent message.","summary":"Send a message","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendMessageInput"}}},"required":false}}},"/bot{token}/sendReaction":{"post":{"tags":["Bot"],"operationId":"bot.pathSendReaction","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Adds the bot's emoji reaction to a message. Returns an empty result when the reaction is applied.","summary":"Send a reaction","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendReactionInput"}}},"required":false}}},"/bot{token}/setMyCommands":{"post":{"tags":["Bot"],"operationId":"bot.pathSetMyCommands","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Replaces the authenticated bot's complete command list. Commands appear to users in sort_order; send an empty array to clear the list.","summary":"Replace bot commands","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetMyCommandsInput"}}},"required":false}}},"/bot{token}/setMySkills":{"post":{"tags":["Bot"],"operationId":"bot.pathSetMySkills","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Replaces the authenticated bot's complete installed-skill catalog. Send an empty array to clear it.","summary":"Replace bot skills","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetMySkillsInput"}}},"required":false}}},"/bot{token}/setThreadTitle":{"post":{"tags":["Bot"],"operationId":"bot.pathSetThreadTitle","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Changes a thread's title, emoji, or both. An empty emoji removes it.","summary":"Update thread title","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetThreadTitleInput"}}},"required":false}}},"/bot{token}/setWebhook":{"post":{"tags":["Bot"],"operationId":"bot.pathSetWebhook","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"BotTrueSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotTrueSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Enables or replaces webhook delivery for the same pending-update queue.","summary":"Set webhook","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetWebhookInput"}}},"required":false}}},"/bot{token}/unpinMessage":{"post":{"tags":["Bot"],"operationId":"bot.pathUnpinMessage","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Unpins one message in a chat.","summary":"Unpin a message","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PinMessageInput"}}},"required":false}}},"/bot{token}/updateAgent":{"post":{"tags":["Bot"],"operationId":"bot.pathUpdateAgent","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"BotUpdateAgentSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUpdateAgentSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Updates supplied Agent fields. Empty optional strings clear those fields.","summary":"Update an Agent","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAgentInput"}}},"required":false}}},"/bot{token}/uploadFile":{"post":{"tags":["Bot"],"operationId":"bot.pathUploadFile","parameters":[{"name":"token","in":"path","schema":{"type":"string"},"required":true,"description":"Required bot token included in the URL path."},{"name":"authorization","in":"header","schema":{"type":"string"},"required":false,"description":"Optional bot token using the Bearer scheme. When supplied, it takes precedence over the token in the URL."}],"security":[],"responses":{"200":{"description":"BotGetFileSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetFileSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Uploads bot media using multipart/form-data and returns a reusable bot file.","summary":"Upload a file","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/BotUploadFilePayload"}}},"required":false}}},"/bot/addThreadParticipant":{"post":{"tags":["Bot"],"operationId":"bot.headerAddThreadParticipant","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Adds one user to a thread. The authenticated bot must have permission to manage that thread's participants.","summary":"Add a thread participant","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadParticipantMutationInput"}}},"required":false}}},"/bot/answerMessageAction":{"post":{"tags":["Bot"],"operationId":"bot.headerAnswerMessageAction","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Acknowledges an action interaction and optionally shows a short toast.","summary":"Answer a message action","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswerMessageActionInput"}}},"required":false}}},"/bot/createAgent":{"post":{"tags":["Bot"],"operationId":"bot.headerCreateAgent","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"BotCreateAgentSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotCreateAgentSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Creates a named specialization owned by the authenticated bot. Name is required; skill and instructions are independently optional.","summary":"Create an Agent","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAgentInput"}}},"required":false}}},"/bot/createReplyThread":{"post":{"tags":["Bot"],"operationId":"bot.headerCreateReplyThread","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful normal or reply-thread creation response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotCreateThreadSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Creates or returns the reply thread anchored to one message.","summary":"Create a reply thread","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateReplyThreadInput"}}},"required":false}}},"/bot/createThread":{"post":{"tags":["Bot"],"operationId":"bot.headerCreateThread","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful normal or reply-thread creation response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotCreateThreadSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Creates a normal home or space thread using Inline's existing access rules.","summary":"Create a thread","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateThreadInput"}}},"required":false}}},"/bot/deleteAgent":{"post":{"tags":["Bot"],"operationId":"bot.headerDeleteAgent","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"BotDeleteAgentSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotDeleteAgentSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Deletes an Agent owned by the authenticated bot without changing the backing bot.","summary":"Delete an Agent","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteAgentInput"}}},"required":false}}},"/bot/deleteMessage":{"post":{"tags":["Bot"],"operationId":"bot.headerDeleteMessage","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Deletes a message from a private conversation or chat. Returns an empty result when the message is deleted.","summary":"Delete a message","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteMessageInput"}}},"required":false}}},"/bot/deleteMessages":{"post":{"tags":["Bot"],"operationId":"bot.headerDeleteMessages","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Deletes up to 100 messages from one chat. Missing message IDs are skipped.","summary":"Delete messages","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteMessagesInput"}}},"required":false}}},"/bot/deleteMyCommands":{"post":{"tags":["Bot"],"operationId":"bot.headerDeleteMyCommands","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Deletes every command published by the authenticated bot. Returns an empty result when the command list is cleared.","summary":"Delete bot commands"}},"/bot/deleteMySkills":{"post":{"tags":["Bot"],"operationId":"bot.headerDeleteMySkills","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Deletes every installed skill published by the authenticated bot harness.","summary":"Delete bot skills"}},"/bot/deleteReaction":{"post":{"tags":["Bot"],"operationId":"bot.headerDeleteReaction","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Removes the bot's emoji reaction from one message.","summary":"Delete a reaction","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteReactionInput"}}},"required":false}}},"/bot/deleteWebhook":{"post":{"tags":["Bot"],"operationId":"bot.headerDeleteWebhook","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"BotTrueSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotTrueSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Disables webhook delivery while preserving pending updates unless explicitly dropped.","summary":"Delete webhook","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteWebhookInput"}}},"required":false}}},"/bot/editMessageActions":{"post":{"tags":["Bot"],"operationId":"bot.headerEditMessageActions","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful sendMessage, editMessageText, or editMessageActions response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotMessageSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Replaces all actions on a bot-authored message without changing its text. Send an empty actions array to clear them.","summary":"Edit message actions","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditMessageActionsInput"}}},"required":false}}},"/bot/editMessageText":{"post":{"tags":["Bot"],"operationId":"bot.headerEditMessageText","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful sendMessage, editMessageText, or editMessageActions response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotMessageSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Replaces the text and formatting of a message in a private conversation or chat. On success, returns the updated message.","summary":"Edit message text","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditMessageTextInput"}}},"required":false}}},"/bot/forwardMessage":{"post":{"tags":["Bot"],"operationId":"bot.headerForwardMessage","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful sendMessage, editMessageText, or editMessageActions response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotMessageSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Forwards one accessible message into another accessible chat.","summary":"Forward a message","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForwardMessageInput"}}},"required":false}}},"/bot/forwardMessages":{"post":{"tags":["Bot"],"operationId":"bot.headerForwardMessages","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"BotForwardMessagesSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForwardMessagesSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Forwards up to 100 accessible messages and returns their new IDs. Missing source IDs are skipped.","summary":"Forward messages","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForwardMessagesInput"}}},"required":false}}},"/bot/getAgent":{"get":{"tags":["Bot"],"operationId":"bot.headerGetAgent","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."},{"name":"agent_id","in":"query","schema":{"$ref":"#/components/schemas/SafeIntegerString"},"required":true,"description":"Bot method parameter."}],"security":[],"responses":{"200":{"description":"BotGetAgentSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetAgentSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns one globally identified Agent owned by the authenticated bot.","summary":"Get an Agent"}},"/bot/getChat":{"get":{"tags":["Bot"],"operationId":"bot.headerGetChat","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."},{"name":"user_id","in":"query","schema":{"$ref":"#/components/schemas/UserIdString"},"required":false,"description":"Target a private conversation with this user. Supply exactly one of user_id or chat_id."},{"name":"chat_id","in":"query","schema":{"$ref":"#/components/schemas/ChatIdString"},"required":false,"description":"Target this chat. Supply exactly one of chat_id or user_id."}],"security":[],"responses":{"200":{"description":"Successful getChat response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetChatSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns current information about a private conversation or chat, including its latest message when available. Supply exactly one of user_id or chat_id.","summary":"Get a chat"}},"/bot/getChatHistory":{"get":{"tags":["Bot"],"operationId":"bot.headerGetChatHistory","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."},{"name":"user_id","in":"query","schema":{"$ref":"#/components/schemas/UserIdString"},"required":false,"description":"Target a private conversation with this user. Supply exactly one of user_id or chat_id."},{"name":"chat_id","in":"query","schema":{"$ref":"#/components/schemas/ChatIdString"},"required":false,"description":"Target this chat. Supply exactly one of chat_id or user_id."},{"name":"limit","in":"query","schema":{"$ref":"#/components/schemas/SafeIntegerString"},"required":false,"description":"Maximum number of messages to return."},{"name":"offset_message_id","in":"query","schema":{"$ref":"#/components/schemas/MessageIdString"},"required":false,"description":"Pagination cursor. When supplied, return messages older than this message."}],"security":[],"responses":{"200":{"description":"Successful getChatHistory response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetChatHistorySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns a page of messages from a private conversation or chat. Supply exactly one of user_id or chat_id, and use offset_message_id to request older messages.","summary":"Get chat history"}},"/bot/getChatParticipant":{"get":{"tags":["Bot"],"operationId":"bot.headerGetChatParticipant","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."},{"name":"chat_id","in":"query","schema":{"$ref":"#/components/schemas/ChatIdString"},"required":true,"description":"Bot method parameter."},{"name":"user_id","in":"query","schema":{"$ref":"#/components/schemas/UserIdString"},"required":true,"description":"Bot method parameter."}],"security":[],"responses":{"200":{"description":"BotGetChatParticipantSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetChatParticipantSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns one participant of an accessible chat, with space membership when applicable.","summary":"Get a chat participant"}},"/bot/getChatParticipantCount":{"get":{"tags":["Bot"],"operationId":"bot.headerGetChatParticipantCount","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."},{"name":"chat_id","in":"query","schema":{"$ref":"#/components/schemas/ChatIdString"},"required":true,"description":"Bot method parameter."}],"security":[],"responses":{"200":{"description":"BotGetChatParticipantCountSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetChatParticipantCountSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns the number of participants in an accessible chat.","summary":"Get chat participant count"}},"/bot/getFile":{"get":{"tags":["Bot"],"operationId":"bot.headerGetFile","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."},{"name":"file_id","in":"query","schema":{"type":"string","allOf":[{"minLength":1}]},"required":true,"description":"Bot method parameter."}],"security":[],"responses":{"200":{"description":"BotGetFileSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetFileSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns metadata and a short-lived download URL for a Bot-owned file or a file in a currently accessible message.","summary":"Get a file"}},"/bot/getMe":{"get":{"tags":["Bot"],"operationId":"bot.headerGetMe","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful getMe response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetMeSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"A simple method for testing bot authentication. Returns basic information about the bot account associated with the supplied token.","summary":"Get the current bot"}},"/bot/getMessages":{"post":{"tags":["Bot"],"operationId":"bot.headerGetMessages","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful exact-message read or search response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotMessagesSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns up to 100 requested messages from one accessible chat, in request order.","summary":"Get exact messages","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetMessagesInput"}}},"required":false}}},"/bot/getMyAgents":{"get":{"tags":["Bot"],"operationId":"bot.headerGetMyAgents","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"BotGetMyAgentsSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetMyAgentsSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns every Agent owned by the authenticated bot.","summary":"List my Agents"}},"/bot/getMyCommands":{"get":{"tags":["Bot"],"operationId":"bot.headerGetMyCommands","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful getMyCommands response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetMyCommandsSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns the command list currently published by the authenticated bot.","summary":"Get bot commands"}},"/bot/getMySkills":{"get":{"tags":["Bot"],"operationId":"bot.headerGetMySkills","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful getMySkills response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetMySkillsSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns the installed skill catalog currently published by the authenticated bot harness.","summary":"Get bot skills"}},"/bot/getSpace":{"post":{"tags":["Bot"],"operationId":"bot.headerGetSpace","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful getSpace response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetSpaceSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns one accessible space, the bot's own membership, and bot-relevant settings without exposing the member roster.","summary":"Get a space","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetSpaceInput"}}},"required":false}}},"/bot/getUpdates":{"get":{"tags":["Bot"],"operationId":"bot.headerGetUpdates","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."},{"name":"offset","in":"query","schema":{"$ref":"#/components/schemas/MessageIdString"},"required":false,"description":"Bot method parameter."},{"name":"limit","in":"query","schema":{"$ref":"#/components/schemas/SafeIntegerString"},"required":false,"description":"Bot method parameter."},{"name":"timeout","in":"query","schema":{"$ref":"#/components/schemas/SafeIntegerString"},"required":false,"description":"Bot method parameter."},{"name":"message_trigger","in":"query","schema":{"$ref":"#/components/schemas/BotMessageTrigger"},"required":false,"description":"Bot method parameter."},{"name":"allowed_updates","in":"query","schema":{"anyOf":[{"type":"string"},{"type":"array","items":{"$ref":"#/components/schemas/BotUpdateKey"}}]},"required":false,"description":"Bot method parameter."}],"security":[],"responses":{"200":{"description":"BotGetUpdatesSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetUpdatesSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Long-polls the authenticated Bot's bounded pending-update queue.","summary":"Get updates"}},"/bot/getWebhookInfo":{"get":{"tags":["Bot"],"operationId":"bot.headerGetWebhookInfo","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"BotWebhookInfoSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotWebhookInfoSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Returns effective delivery settings and pending/error counters without exposing the secret.","summary":"Get webhook info"}},"/bot/pinMessage":{"post":{"tags":["Bot"],"operationId":"bot.headerPinMessage","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Pins one message in a chat.","summary":"Pin a message","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PinMessageInput"}}},"required":false}}},"/bot/removeThreadParticipant":{"post":{"tags":["Bot"],"operationId":"bot.headerRemoveThreadParticipant","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Removes one user from a thread. The authenticated bot must have permission to manage that thread's participants and cannot remove itself.","summary":"Remove a thread participant","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ThreadParticipantMutationInput"}}},"required":false}}},"/bot/searchMessages":{"post":{"tags":["Bot"],"operationId":"bot.headerSearchMessages","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful exact-message read or search response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotMessagesSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Searches messages within exactly one accessible chat, newest first.","summary":"Search one chat","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchMessagesInput"}}},"required":false}}},"/bot/sendChatAction":{"post":{"tags":["Bot"],"operationId":"bot.headerSendChatAction","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Publishes a short-lived typing or upload indicator.","summary":"Send a chat action","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendChatActionInput"}}},"required":false}}},"/bot/sendMessage":{"post":{"tags":["Bot"],"operationId":"bot.headerSendMessage","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful sendMessage, editMessageText, or editMessageActions response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotMessageSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Sends a text message to a private user or chat. Supply exactly one of user_id or chat_id. On success, returns the sent message.","summary":"Send a message","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendMessageInput"}}},"required":false}}},"/bot/sendReaction":{"post":{"tags":["Bot"],"operationId":"bot.headerSendReaction","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Adds the bot's emoji reaction to a message. Returns an empty result when the reaction is applied.","summary":"Send a reaction","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendReactionInput"}}},"required":false}}},"/bot/setMyCommands":{"post":{"tags":["Bot"],"operationId":"bot.headerSetMyCommands","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Replaces the authenticated bot's complete command list. Commands appear to users in sort_order; send an empty array to clear the list.","summary":"Replace bot commands","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetMyCommandsInput"}}},"required":false}}},"/bot/setMySkills":{"post":{"tags":["Bot"],"operationId":"bot.headerSetMySkills","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Replaces the authenticated bot's complete installed-skill catalog. Send an empty array to clear it.","summary":"Replace bot skills","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetMySkillsInput"}}},"required":false}}},"/bot/setThreadTitle":{"post":{"tags":["Bot"],"operationId":"bot.headerSetThreadTitle","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Changes a thread's title, emoji, or both. An empty emoji removes it.","summary":"Update thread title","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetThreadTitleInput"}}},"required":false}}},"/bot/setWebhook":{"post":{"tags":["Bot"],"operationId":"bot.headerSetWebhook","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"BotTrueSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotTrueSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Enables or replaces webhook delivery for the same pending-update queue.","summary":"Set webhook","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetWebhookInput"}}},"required":false}}},"/bot/unpinMessage":{"post":{"tags":["Bot"],"operationId":"bot.headerUnpinMessage","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"Successful response for an action with no return value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotEmptySuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Unpins one message in a chat.","summary":"Unpin a message","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PinMessageInput"}}},"required":false}}},"/bot/updateAgent":{"post":{"tags":["Bot"],"operationId":"bot.headerUpdateAgent","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"BotUpdateAgentSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUpdateAgentSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Updates supplied Agent fields. Empty optional strings clear those fields.","summary":"Update an Agent","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAgentInput"}}},"required":false}}},"/bot/uploadFile":{"post":{"tags":["Bot"],"operationId":"bot.headerUploadFile","parameters":[{"name":"authorization","in":"header","schema":{"type":"string"},"required":true,"description":"Required bot token using the Bearer scheme."}],"security":[],"responses":{"200":{"description":"BotGetFileSuccess","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotGetFileSuccess"}}}},"400":{"description":"The request parameters are missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotBadRequestError"}}}},"401":{"description":"The bot token is missing or invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotUnauthorizedError"}}}},"403":{"description":"The bot is not allowed to perform this action.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotForbiddenError"}}}},"404":{"description":"The requested method or resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotNotFoundError"}}}},"500":{"description":"The server could not complete the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotInternalServerError"}}}}},"description":"Uploads bot media using multipart/form-data and returns a reusable bot file.","summary":"Upload a file","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/BotUploadFilePayload"}}},"required":false}}}},"components":{"schemas":{"AnswerMessageActionInput":{"type":"object","properties":{"interaction_id":{"$ref":"#/components/schemas/MessageId"},"text":{"type":"string","allOf":[{"maxLength":200}]}},"required":["interaction_id"],"additionalProperties":false},"BotActivationReason":{"type":"string","enum":["direct","all","mention","reply","command","action"]},"BotAgent":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/WirePositiveInteger"},"bot_user_id":{"$ref":"#/components/schemas/UserId"},"name":{"type":"string","allOf":[{"minLength":1},{"maxLength":256}]},"handle":{"type":"string","allOf":[{"maxLength":256}]},"emoji":{"type":"string","allOf":[{"maxLength":64}]},"description":{"type":"string","allOf":[{"maxLength":4000}]},"skill_key":{"type":"string","allOf":[{"maxLength":256}]},"instructions":{"type":"string","allOf":[{"maxLength":32000}]}},"required":["id","bot_user_id","name"],"additionalProperties":false,"description":"A named, mentionable specialization owned and executed by a bot."},"BotAttachment":{"type":"object","properties":{"type":{"type":"string","enum":["url_preview"]},"url":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"image":{"$ref":"#/components/schemas/BotFile"}},"required":["type","url"],"additionalProperties":false,"description":"Structured attachment shown with a message."},"BotBadRequestError":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false],"allOf":[{"description":"Always false for an unsuccessful request."}]},"error":{"type":"string","allOf":[{"description":"Stable machine-readable error name."}]},"error_code":{"allOf":[{"$ref":"#/components/schemas/HttpStatusCode"},{"description":"HTTP status code returned for the request."}]},"description":{"type":"string","allOf":[{"description":"Human-readable explanation of the error."}]},"parameters":{"type":"object","properties":{"retry_after":{"$ref":"#/components/schemas/WireNonNegativeInteger"}},"additionalProperties":false,"allOf":[{"description":"Optional structured recovery information."}]}},"required":["ok","error_code","description"],"additionalProperties":false,"description":"The request parameters are missing or invalid.","examples":[{"ok":false,"error":"CHAT_ID_INVALID","error_code":400,"description":"The chat id is invalid"}]},"BotChat":{"type":"object","properties":{"chat_id":{"allOf":[{"$ref":"#/components/schemas/ChatId"},{"description":"Unique identifier for this chat."}]},"type":{"allOf":[{"$ref":"#/components/schemas/BotChatType"},{"description":"Conversation kind."}]},"title":{"type":"string","allOf":[{"description":"Display title of the chat."}]},"space_id":{"allOf":[{"$ref":"#/components/schemas/SpaceId"},{"description":"Space that contains the chat, when applicable."}]},"is_public":{"type":"boolean","allOf":[{"description":"Whether the chat is public."}]},"parent_chat_id":{"allOf":[{"$ref":"#/components/schemas/ChatId"},{"description":"Structural parent for a nested or reply thread."}]},"number":{"allOf":[{"$ref":"#/components/schemas/WirePositiveInteger"},{"description":"Human-facing thread number within its space or home scope."}]},"participants":{"type":"object","properties":{"count":{"$ref":"#/components/schemas/WireNonNegativeInteger"}},"required":["count"],"additionalProperties":false,"allOf":[{"description":"Safe aggregate participant information."}]},"last_message_id":{"allOf":[{"$ref":"#/components/schemas/MessageId"},{"description":"Identifier of the latest known message in the chat."}]},"last_message":{"allOf":[{"$ref":"#/components/schemas/BotChatLastMessage"},{"description":"Latest message, when it is available to the bot."}]},"emoji":{"type":"string","allOf":[{"description":"Emoji used as the chat's icon."}]},"agent_context":{"type":"object","properties":{"bot_user_id":{"$ref":"#/components/schemas/UserId"},"agent_id":{"$ref":"#/components/schemas/WireSafeInteger"},"configuration":{"type":"object","properties":{"project_id":{"type":"string"},"model_id":{"type":"string"},"reasoning_effort_id":{"type":"string"}},"additionalProperties":false}},"required":["bot_user_id"],"additionalProperties":false,"allOf":[{"description":"Visible Agent target and selected execution preset for this chat."}]},"parent_message":{"allOf":[{"$ref":"#/components/schemas/BotMessageReference"},{"description":"Message anchoring this reply thread. Its chat omits parent_message and it has no reply_to_message."}]}},"required":["chat_id","type"],"additionalProperties":false,"description":"Information about an Inline user chat or thread."},"BotChatAction":{"type":"string","enum":["typing","upload_photo","upload_video","upload_document","record_voice","cancel"]},"BotChatLastMessage":{"type":"object","properties":{"message_id":{"allOf":[{"$ref":"#/components/schemas/MessageId"},{"description":"Unique identifier for this message within the chat."}]},"from_id":{"allOf":[{"$ref":"#/components/schemas/UserId"},{"description":"Unique identifier of the message sender."}]},"from":{"allOf":[{"$ref":"#/components/schemas/BotUser"},{"description":"Basic information about the message sender."}]},"date":{"allOf":[{"$ref":"#/components/schemas/WireNonNegativeInteger"},{"description":"Time the message was sent, as Unix time in seconds."}]},"text":{"type":"string","allOf":[{"description":"Text of the message, when present."}]},"entities":{"type":"array","items":{"$ref":"#/components/schemas/BotMessageEntityOutput"},"allOf":[{"description":"Formatting and semantic entities found in the message text."}]},"rich_message":{"allOf":[{"$ref":"#/components/schemas/BotRichMessage"},{"description":"Recursive rich content, when the message has structural blocks."}]}},"required":["message_id","from_id","from","date"],"additionalProperties":false,"description":"Compact representation of the most recent message in a chat."},"BotChatParticipant":{"type":"object","properties":{"user":{"$ref":"#/components/schemas/BotUser"},"member":{"$ref":"#/components/schemas/BotSpaceMember"}},"required":["user"],"additionalProperties":false},"BotChatType":{"type":"string","enum":["user","thread"],"description":"Public conversation kind."},"BotCommand":{"type":"object","properties":{"command":{"type":"string","allOf":[{"minLength":1},{"maxLength":32},{"pattern":"^[a-z0-9_]+$"},{"description":"Command name without a leading slash. Use 1–32 lowercase letters, digits, or underscores."}]},"description":{"type":"string","allOf":[{"minLength":1},{"maxLength":256},{"description":"User-facing description shown in the command menu, up to 256 characters."}]},"sort_order":{"allOf":[{"$ref":"#/components/schemas/WireSafeInteger"},{"description":"Optional order in the command menu. Lower values appear first."}]}},"required":["command","description"],"additionalProperties":false,"description":"A command advertised by the bot."},"BotCreateAgentSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"type":"object","properties":{"agent":{"$ref":"#/components/schemas/BotAgent"}},"required":["agent"],"additionalProperties":false,"allOf":[{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false},"BotCreateThreadResult":{"type":"object","properties":{"chat":{"$ref":"#/components/schemas/BotChat"}},"required":["chat"],"additionalProperties":false,"description":"The created or existing thread."},"BotCreateThreadSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"allOf":[{"$ref":"#/components/schemas/BotCreateThreadResult"},{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false,"description":"Successful normal or reply-thread creation response."},"BotDeleteAgentSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"type":"object","properties":{"agent_id":{"$ref":"#/components/schemas/WirePositiveInteger"}},"required":["agent_id"],"additionalProperties":false,"allOf":[{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false},"BotEmptyResult":{"type":"object","additionalProperties":false,"description":"Empty result returned when an action completes successfully."},"BotEmptySuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"allOf":[{"$ref":"#/components/schemas/BotEmptyResult"},{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false,"description":"Successful response for an action with no return value.","examples":[{"ok":true,"result":{}}]},"BotEventChat":{"type":"object","properties":{"chat_id":{"allOf":[{"$ref":"#/components/schemas/ChatId"},{"description":"Unique identifier for this chat."}]},"type":{"$ref":"#/components/schemas/BotChatType"},"title":{"type":"string","allOf":[{"description":"Display title of the chat."}]},"space_id":{"allOf":[{"$ref":"#/components/schemas/SpaceId"},{"description":"Space that contains the chat, when applicable."}]},"is_public":{"type":"boolean","allOf":[{"description":"Whether the chat is public."}]},"parent_chat_id":{"allOf":[{"$ref":"#/components/schemas/ChatId"},{"description":"Structural parent for a nested or reply thread."}]},"number":{"allOf":[{"$ref":"#/components/schemas/WirePositiveInteger"},{"description":"Human-facing thread number within its space or home scope."}]},"participants":{"type":"object","properties":{"count":{"$ref":"#/components/schemas/WireNonNegativeInteger"}},"required":["count"],"additionalProperties":false,"allOf":[{"description":"Safe aggregate participant information."}]},"last_message_id":{"allOf":[{"$ref":"#/components/schemas/MessageId"},{"description":"Identifier of the latest known message in the chat."}]},"last_message":{"allOf":[{"$ref":"#/components/schemas/BotChatLastMessage"},{"description":"Latest message, when it is available to the bot."}]},"emoji":{"type":"string","allOf":[{"description":"Emoji used as the chat's icon."}]},"agent_context":{"type":"object","properties":{"bot_user_id":{"$ref":"#/components/schemas/UserId"},"agent_id":{"$ref":"#/components/schemas/WireSafeInteger"},"configuration":{"type":"object","properties":{"project_id":{"type":"string"},"model_id":{"type":"string"},"reasoning_effort_id":{"type":"string"}},"additionalProperties":false}},"required":["bot_user_id"],"additionalProperties":false,"allOf":[{"description":"Visible Agent target and selected execution preset for this chat."}]},"parent_message":{"allOf":[{"$ref":"#/components/schemas/BotMessageReference"},{"description":"Message anchoring this reply thread. Its chat omits parent_message and it has no reply_to_message."}]}},"required":["chat_id","type"],"additionalProperties":false,"description":"Chat snapshot embedded in a bot update."},"BotEventMessage":{"type":"object","properties":{"message_id":{"allOf":[{"$ref":"#/components/schemas/MessageId"},{"description":"Unique identifier for this message within the chat."}]},"peer_id":{"allOf":[{"$ref":"#/components/schemas/BotPeerId"},{"description":"Required peer identity used to address this conversation."}]},"chat_id":{"allOf":[{"$ref":"#/components/schemas/ChatId"},{"description":"Deprecated compatibility alias. Prefer peer_id.chat_id."}]},"peer":{"allOf":[{"$ref":"#/components/schemas/BotPeer"},{"description":"Deprecated compatibility peer. Prefer peer_id."}]},"from_id":{"allOf":[{"$ref":"#/components/schemas/UserId"},{"description":"Unique identifier of the message sender."}]},"from":{"allOf":[{"$ref":"#/components/schemas/BotUser"},{"description":"Basic information about the message sender."}]},"date":{"allOf":[{"$ref":"#/components/schemas/WireNonNegativeInteger"},{"description":"Time the message was sent, as Unix time in seconds."}]},"edit_date":{"allOf":[{"$ref":"#/components/schemas/WireNonNegativeInteger"},{"description":"Time of the latest edit, as Unix time in seconds."}]},"text":{"type":"string","allOf":[{"description":"Text of the message, when present."}]},"entities":{"type":"array","items":{"$ref":"#/components/schemas/BotMessageEntityOutput"},"allOf":[{"description":"Formatting and semantic entities found in the message text."}]},"rich_message":{"allOf":[{"$ref":"#/components/schemas/BotRichMessage"},{"description":"Recursive structural content. When present, this is the semantic rich-content source instead of entities."}]},"media":{"allOf":[{"$ref":"#/components/schemas/BotMedia"},{"description":"Media attached to the message."}]},"attachments":{"type":"array","items":{"$ref":"#/components/schemas/BotAttachment"},"allOf":[{"description":"Structured attachments associated with the message."}]},"actions":{"type":"array","items":{"type":"array","items":{"$ref":"#/components/schemas/BotMessageAction"}},"allOf":[{"description":"Rows of interactive message actions."}]},"reactions":{"type":"array","items":{"$ref":"#/components/schemas/BotMessageReaction"},"allOf":[{"description":"Aggregated reactions on the message."}]},"chat":{"$ref":"#/components/schemas/BotEventChat"},"reply_to_message":{"allOf":[{"$ref":"#/components/schemas/BotMessageReference"},{"description":"Original message when this message is a reply."}]}},"required":["message_id","peer_id","from_id","from","date","chat"],"additionalProperties":false,"description":"Message snapshot embedded in a bot update."},"BotFile":{"type":"object","properties":{"file_id":{"type":"string"},"file_name":{"type":"string"},"mime_type":{"type":"string"},"file_size":{"$ref":"#/components/schemas/WireNonNegativeInteger"},"width":{"$ref":"#/components/schemas/WireNonNegativeInteger"},"height":{"$ref":"#/components/schemas/WireNonNegativeInteger"},"duration":{"$ref":"#/components/schemas/WireNonNegativeInteger"},"download_url":{"type":"string"},"download_url_expires_at":{"$ref":"#/components/schemas/WireNonNegativeInteger"}},"required":["file_id"],"additionalProperties":false,"description":"Reusable file metadata. File identifiers and URLs are opaque."},"BotForbiddenError":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false],"allOf":[{"description":"Always false for an unsuccessful request."}]},"error":{"type":"string","allOf":[{"description":"Stable machine-readable error name."}]},"error_code":{"allOf":[{"$ref":"#/components/schemas/HttpStatusCode"},{"description":"HTTP status code returned for the request."}]},"description":{"type":"string","allOf":[{"description":"Human-readable explanation of the error."}]},"parameters":{"type":"object","properties":{"retry_after":{"$ref":"#/components/schemas/WireNonNegativeInteger"}},"additionalProperties":false,"allOf":[{"description":"Optional structured recovery information."}]}},"required":["ok","error_code","description"],"additionalProperties":false,"description":"The bot is not allowed to perform this action.","examples":[{"ok":false,"error":"FORBIDDEN","error_code":403,"description":"Forbidden"}]},"BotForwardMessagesResult":{"type":"object","properties":{"message_ids":{"type":"array","items":{"$ref":"#/components/schemas/MessageId"}}},"required":["message_ids"],"additionalProperties":false,"description":"New message IDs, in the same order as the source messages that were forwarded."},"BotForwardMessagesSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"allOf":[{"$ref":"#/components/schemas/BotForwardMessagesResult"},{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false},"BotGetAgentSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"type":"object","properties":{"bot":{"$ref":"#/components/schemas/BotUser"},"agent":{"$ref":"#/components/schemas/BotAgent"}},"required":["bot","agent"],"additionalProperties":false,"allOf":[{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false},"BotGetChatHistoryResult":{"type":"object","properties":{"messages":{"type":"array","items":{"$ref":"#/components/schemas/BotMessage"},"allOf":[{"description":"Messages in the requested history page."}]}},"required":["messages"],"additionalProperties":false,"description":"A page of messages from a chat."},"BotGetChatHistorySuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"allOf":[{"$ref":"#/components/schemas/BotGetChatHistoryResult"},{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false,"description":"Successful getChatHistory response.","examples":[{"ok":true,"result":{"messages":[{"message_id":1808,"peer_id":{"user_id":391204},"chat_id":73143,"peer":{"user_id":391204},"from_id":284901,"from":{"id":284901,"is_bot":true,"username":"deploy_bot","first_name":"Deploy Bot"},"date":1784332860,"text":"Deployment finished successfully.","entities":[{"type":"bold","offset":0,"length":10}]}]}}]},"BotGetChatParticipantCountResult":{"type":"object","properties":{"count":{"$ref":"#/components/schemas/WireNonNegativeInteger"}},"required":["count"],"additionalProperties":false},"BotGetChatParticipantCountSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"allOf":[{"$ref":"#/components/schemas/BotGetChatParticipantCountResult"},{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false},"BotGetChatParticipantResult":{"type":"object","properties":{"participant":{"$ref":"#/components/schemas/BotChatParticipant"}},"required":["participant"],"additionalProperties":false},"BotGetChatParticipantSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"allOf":[{"$ref":"#/components/schemas/BotGetChatParticipantResult"},{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false},"BotGetChatResult":{"type":"object","properties":{"chat":{"allOf":[{"$ref":"#/components/schemas/BotChat"},{"description":"The requested chat."}]}},"required":["chat"],"additionalProperties":false,"description":"Information about the requested chat."},"BotGetChatSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"allOf":[{"$ref":"#/components/schemas/BotGetChatResult"},{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false,"description":"Successful getChat response.","examples":[{"ok":true,"result":{"chat":{"chat_id":73142,"type":"thread","title":"Product","space_id":912,"is_public":false,"number":42,"last_message_id":1807,"last_message":{"message_id":1807,"from_id":391204,"from":{"id":391204,"is_bot":false,"username":"maya","first_name":"Maya","last_name":"Chen"},"date":1784332800,"text":"Can you deploy the latest build?"},"emoji":"🚀"}}}]},"BotGetFileResult":{"type":"object","properties":{"file":{"$ref":"#/components/schemas/BotFile"}},"required":["file"],"additionalProperties":false},"BotGetFileSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"allOf":[{"$ref":"#/components/schemas/BotGetFileResult"},{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false},"BotGetMeResult":{"type":"object","properties":{"user":{"allOf":[{"$ref":"#/components/schemas/BotUser"},{"description":"The bot account authenticated by the supplied token."}]}},"required":["user"],"additionalProperties":false,"description":"Information about the authenticated bot."},"BotGetMeSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"allOf":[{"$ref":"#/components/schemas/BotGetMeResult"},{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false,"description":"Successful getMe response.","examples":[{"ok":true,"result":{"user":{"id":284901,"is_bot":true,"username":"deploy_bot","first_name":"Deploy Bot"}}}]},"BotGetMyAgentsSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"type":"object","properties":{"agents":{"type":"array","items":{"$ref":"#/components/schemas/BotAgent"}}},"required":["agents"],"additionalProperties":false,"allOf":[{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false},"BotGetMyCommandsResult":{"type":"object","properties":{"commands":{"type":"array","items":{"$ref":"#/components/schemas/BotCommand"},"allOf":[{"description":"Commands currently published by the bot, in display order."}]}},"required":["commands"],"additionalProperties":false,"description":"The authenticated bot's command list."},"BotGetMyCommandsSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"allOf":[{"$ref":"#/components/schemas/BotGetMyCommandsResult"},{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false,"description":"Successful getMyCommands response.","examples":[{"ok":true,"result":{"commands":[{"command":"deploy","description":"Deploy the latest build","sort_order":10},{"command":"status","description":"Show the current deployment status","sort_order":20}]}}]},"BotGetMySkillsResult":{"type":"object","properties":{"skills":{"type":"array","items":{"$ref":"#/components/schemas/BotSkill"}}},"required":["skills"],"additionalProperties":false,"description":"The authenticated bot's published skill catalog."},"BotGetMySkillsSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"allOf":[{"$ref":"#/components/schemas/BotGetMySkillsResult"},{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false,"description":"Successful getMySkills response."},"BotGetSpaceResult":{"type":"object","properties":{"space":{"$ref":"#/components/schemas/BotSpace"},"membership":{"$ref":"#/components/schemas/BotSpaceMember"},"settings":{"type":"object","properties":{"grid_enabled":{"type":"boolean"}},"required":["grid_enabled"],"additionalProperties":false}},"required":["space","membership","settings"],"additionalProperties":false,"description":"An accessible space, the bot's membership, and bot-relevant settings."},"BotGetSpaceSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"allOf":[{"$ref":"#/components/schemas/BotGetSpaceResult"},{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false,"description":"Successful getSpace response."},"BotGetUpdatesResult":{"type":"array","items":{"$ref":"#/components/schemas/BotUpdate"}},"BotGetUpdatesSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"allOf":[{"$ref":"#/components/schemas/BotGetUpdatesResult"},{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false},"BotInternalServerError":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false],"allOf":[{"description":"Always false for an unsuccessful request."}]},"error":{"type":"string","allOf":[{"description":"Stable machine-readable error name."}]},"error_code":{"allOf":[{"$ref":"#/components/schemas/HttpStatusCode"},{"description":"HTTP status code returned for the request."}]},"description":{"type":"string","allOf":[{"description":"Human-readable explanation of the error."}]},"parameters":{"type":"object","properties":{"retry_after":{"$ref":"#/components/schemas/WireNonNegativeInteger"}},"additionalProperties":false,"allOf":[{"description":"Optional structured recovery information."}]}},"required":["ok","error_code","description"],"additionalProperties":false,"description":"The server could not complete the request.","examples":[{"ok":false,"error":"SERVER_ERROR","error_code":500,"description":"Server error"}]},"BotMedia":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"file":{"$ref":"#/components/schemas/BotFile"}},"required":["type","file"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["video"]},"file":{"$ref":"#/components/schemas/BotFile"},"thumbnail":{"$ref":"#/components/schemas/BotFile"},"is_animated":{"type":"boolean"},"has_audio":{"type":"boolean"}},"required":["type","file"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["document"]},"file":{"$ref":"#/components/schemas/BotFile"},"thumbnail":{"$ref":"#/components/schemas/BotFile"}},"required":["type","file"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["voice"]},"file":{"$ref":"#/components/schemas/BotFile"},"waveform_base64":{"type":"string"}},"required":["type","file"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["nudge"]}},"required":["type"],"additionalProperties":false}],"description":"One media item attached to a message."},"BotMessage":{"type":"object","properties":{"message_id":{"allOf":[{"$ref":"#/components/schemas/MessageId"},{"description":"Unique identifier for this message within the chat."}]},"peer_id":{"allOf":[{"$ref":"#/components/schemas/BotPeerId"},{"description":"Required peer identity used to address this conversation."}]},"chat_id":{"allOf":[{"$ref":"#/components/schemas/ChatId"},{"description":"Deprecated compatibility alias. Prefer peer_id.chat_id."}]},"peer":{"allOf":[{"$ref":"#/components/schemas/BotPeer"},{"description":"Deprecated compatibility peer. Prefer peer_id."}]},"from_id":{"allOf":[{"$ref":"#/components/schemas/UserId"},{"description":"Unique identifier of the message sender."}]},"from":{"allOf":[{"$ref":"#/components/schemas/BotUser"},{"description":"Basic information about the message sender."}]},"date":{"allOf":[{"$ref":"#/components/schemas/WireNonNegativeInteger"},{"description":"Time the message was sent, as Unix time in seconds."}]},"edit_date":{"allOf":[{"$ref":"#/components/schemas/WireNonNegativeInteger"},{"description":"Time of the latest edit, as Unix time in seconds."}]},"text":{"type":"string","allOf":[{"description":"Text of the message, when present."}]},"entities":{"type":"array","items":{"$ref":"#/components/schemas/BotMessageEntityOutput"},"allOf":[{"description":"Formatting and semantic entities found in the message text."}]},"rich_message":{"allOf":[{"$ref":"#/components/schemas/BotRichMessage"},{"description":"Recursive structural content. When present, this is the semantic rich-content source instead of entities."}]},"media":{"allOf":[{"$ref":"#/components/schemas/BotMedia"},{"description":"Media attached to the message."}]},"attachments":{"type":"array","items":{"$ref":"#/components/schemas/BotAttachment"},"allOf":[{"description":"Structured attachments associated with the message."}]},"actions":{"type":"array","items":{"type":"array","items":{"$ref":"#/components/schemas/BotMessageAction"}},"allOf":[{"description":"Rows of interactive message actions."}]},"reactions":{"type":"array","items":{"$ref":"#/components/schemas/BotMessageReaction"},"allOf":[{"description":"Aggregated reactions on the message."}]},"chat":{"allOf":[{"$ref":"#/components/schemas/BotChat"},{"description":"Expanded containing chat when useful in this response. Repeated history and nested messages may omit it."}]},"reply_to_message":{"allOf":[{"$ref":"#/components/schemas/BotMessageReference"},{"description":"Original message when this message is a reply."}]}},"required":["message_id","peer_id","from_id","from","date"],"additionalProperties":false,"description":"A message returned by the Inline Bot API."},"BotMessageAction":{"anyOf":[{"type":"object","properties":{"action_id":{"type":"string"},"text":{"type":"string"},"type":{"type":"string","enum":["callback"]},"callback_data":{"type":"string"},"callback_data_base64":{"not":{}}},"required":["action_id","text","type","callback_data"],"additionalProperties":false},{"type":"object","properties":{"action_id":{"type":"string"},"text":{"type":"string"},"type":{"type":"string","enum":["callback"]},"callback_data":{"not":{}},"callback_data_base64":{"type":"string"}},"required":["action_id","text","type","callback_data_base64"],"additionalProperties":false},{"type":"object","properties":{"action_id":{"type":"string"},"text":{"type":"string"},"type":{"type":"string","enum":["callback"]},"callback_data":{"not":{}},"callback_data_base64":{"not":{}}},"required":["action_id","text","type"],"additionalProperties":false},{"type":"object","properties":{"action_id":{"type":"string"},"text":{"type":"string"},"type":{"type":"string","enum":["copy_text"]},"copy_text":{"type":"string"},"callback_data":{"not":{}},"callback_data_base64":{"not":{}}},"required":["action_id","text","type","copy_text"],"additionalProperties":false}],"description":"Interactive message action."},"BotMessageEntityOutput":{"type":"object","properties":{"type":{"type":"string","enum":["mention","text_mention","url","text_link","email","bold","italic","underline","strikethrough","highlight","math","code","pre","phone_number","thread","thread_title","bot_command","group_mention","unknown"],"allOf":[{"description":"Kind of formatting or semantic entity."}]},"offset":{"allOf":[{"$ref":"#/components/schemas/WireNonNegativeInteger"},{"description":"Zero-based UTF-16 code-unit offset where the entity begins in text."}]},"length":{"allOf":[{"$ref":"#/components/schemas/WireNonNegativeInteger"},{"description":"Number of UTF-16 code units covered by the entity."}]},"user":{"allOf":[{"$ref":"#/components/schemas/BotUser"},{"description":"Referenced user for mention entities."}]},"agent_id":{"allOf":[{"$ref":"#/components/schemas/WireSafeInteger"},{"description":"Agent selected beneath the referenced bot user."}]},"url":{"type":"string","allOf":[{"description":"Destination URL for a text_link entity."}]},"language":{"type":"string","allOf":[{"description":"Programming language hint for a preformatted code block."}]},"chat_id":{"allOf":[{"$ref":"#/components/schemas/ChatId"},{"description":"Referenced chat for thread link entities."}]},"space_id":{"allOf":[{"$ref":"#/components/schemas/SpaceId"},{"description":"Referenced space for thread-title link entities."}]},"title":{"type":"string","allOf":[{"description":"Display title for a linked thread or space."}]},"group_id":{"allOf":[{"$ref":"#/components/schemas/WirePositiveInteger"},{"description":"Referenced group for a group_mention entity."}]}},"required":["type","offset","length"],"additionalProperties":false,"description":"Formatting or semantic metadata found in message text."},"BotMessageReaction":{"type":"object","properties":{"emoji":{"type":"string"},"count":{"$ref":"#/components/schemas/WireNonNegativeInteger"},"chosen":{"type":"boolean"}},"required":["emoji","count","chosen"],"additionalProperties":false},"BotMessageReference":{"type":"object","properties":{"message_id":{"allOf":[{"$ref":"#/components/schemas/MessageId"},{"description":"Unique identifier for this message within the chat."}]},"peer_id":{"allOf":[{"$ref":"#/components/schemas/BotPeerId"},{"description":"Required peer identity used to address this conversation."}]},"chat_id":{"allOf":[{"$ref":"#/components/schemas/ChatId"},{"description":"Deprecated compatibility alias. Prefer peer_id.chat_id."}]},"peer":{"allOf":[{"$ref":"#/components/schemas/BotPeer"},{"description":"Deprecated compatibility peer. Prefer peer_id."}]},"from_id":{"allOf":[{"$ref":"#/components/schemas/UserId"},{"description":"Unique identifier of the message sender."}]},"from":{"allOf":[{"$ref":"#/components/schemas/BotUser"},{"description":"Basic information about the message sender."}]},"date":{"allOf":[{"$ref":"#/components/schemas/WireNonNegativeInteger"},{"description":"Time the message was sent, as Unix time in seconds."}]},"edit_date":{"allOf":[{"$ref":"#/components/schemas/WireNonNegativeInteger"},{"description":"Time of the latest edit, as Unix time in seconds."}]},"text":{"type":"string","allOf":[{"description":"Text of the message, when present."}]},"entities":{"type":"array","items":{"$ref":"#/components/schemas/BotMessageEntityOutput"},"allOf":[{"description":"Formatting and semantic entities found in the message text."}]},"rich_message":{"allOf":[{"$ref":"#/components/schemas/BotRichMessage"},{"description":"Recursive structural content. When present, this is the semantic rich-content source instead of entities."}]},"media":{"allOf":[{"$ref":"#/components/schemas/BotMedia"},{"description":"Media attached to the message."}]},"attachments":{"type":"array","items":{"$ref":"#/components/schemas/BotAttachment"},"allOf":[{"description":"Structured attachments associated with the message."}]},"actions":{"type":"array","items":{"type":"array","items":{"$ref":"#/components/schemas/BotMessageAction"}},"allOf":[{"description":"Rows of interactive message actions."}]},"reactions":{"type":"array","items":{"$ref":"#/components/schemas/BotMessageReaction"},"allOf":[{"description":"Aggregated reactions on the message."}]}},"required":["message_id","peer_id","from_id","from","date"],"additionalProperties":false,"description":"A message without its replied-to message attached."},"BotMessageResult":{"type":"object","properties":{"message":{"allOf":[{"$ref":"#/components/schemas/BotMessage"},{"description":"The sent or updated message."}]}},"required":["message"],"additionalProperties":false,"description":"A message returned after a successful mutation."},"BotMessagesResult":{"type":"object","properties":{"messages":{"type":"array","items":{"$ref":"#/components/schemas/BotMessage"}}},"required":["messages"],"additionalProperties":false,"description":"Messages returned by an exact read or search."},"BotMessagesSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"allOf":[{"$ref":"#/components/schemas/BotMessagesResult"},{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false,"description":"Successful exact-message read or search response."},"BotMessageSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"allOf":[{"$ref":"#/components/schemas/BotMessageResult"},{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false,"description":"Successful sendMessage, editMessageText, or editMessageActions response.","examples":[{"ok":true,"result":{"message":{"message_id":1808,"peer_id":{"user_id":391204},"chat_id":73143,"chat":{"chat_id":73143,"type":"user","title":"Maya Chen","is_public":false,"last_message_id":1808,"last_message":{"message_id":1808,"from_id":284901,"from":{"id":284901,"is_bot":true,"username":"deploy_bot","first_name":"Deploy Bot"},"date":1784332860,"text":"Deployment finished successfully.","entities":[{"type":"bold","offset":0,"length":10}]}},"peer":{"user_id":391204},"from_id":284901,"from":{"id":284901,"is_bot":true,"username":"deploy_bot","first_name":"Deploy Bot"},"date":1784332860,"text":"Deployment finished successfully.","entities":[{"type":"bold","offset":0,"length":10}]}}}]},"BotMessageTrigger":{"type":"string","enum":["all","mentions"]},"BotNotFoundError":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false],"allOf":[{"description":"Always false for an unsuccessful request."}]},"error":{"type":"string","allOf":[{"description":"Stable machine-readable error name."}]},"error_code":{"allOf":[{"$ref":"#/components/schemas/HttpStatusCode"},{"description":"HTTP status code returned for the request."}]},"description":{"type":"string","allOf":[{"description":"Human-readable explanation of the error."}]},"parameters":{"type":"object","properties":{"retry_after":{"$ref":"#/components/schemas/WireNonNegativeInteger"}},"additionalProperties":false,"allOf":[{"description":"Optional structured recovery information."}]}},"required":["ok","error_code","description"],"additionalProperties":false,"description":"The requested method or resource was not found.","examples":[{"ok":false,"error":"METHOD_NOT_FOUND","error_code":404,"description":"Method not found"}]},"BotParticipationChange":{"type":"object","properties":{"chat":{"$ref":"#/components/schemas/BotEventChat"},"actor":{"$ref":"#/components/schemas/BotUser"},"date":{"$ref":"#/components/schemas/WireNonNegativeInteger"},"status":{"type":"string","enum":["added","removed"]}},"required":["chat","date","status"],"additionalProperties":false},"BotPeer":{"type":"object","properties":{"user_id":{"allOf":[{"$ref":"#/components/schemas/UserId"},{"description":"The other user in a user chat. Threads do not include this field."}]}},"additionalProperties":false,"description":"Additional peer information retained for user-chat compatibility. Prefer message.chat_id as the conversation identifier."},"BotPeerId":{"oneOf":[{"type":"object","properties":{"user_id":{"$ref":"#/components/schemas/UserId"},"chat_id":{"not":{}}},"required":["user_id"],"additionalProperties":false},{"type":"object","properties":{"user_id":{"not":{}},"chat_id":{"$ref":"#/components/schemas/ChatId"}},"required":["chat_id"],"additionalProperties":false}],"description":"Stable conversation identity: a user ID for a private chat or a chat ID for a thread."},"BotReaction":{"type":"object","properties":{"emoji":{"type":"string"}},"required":["emoji"],"additionalProperties":false},"BotRichBlock":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["math"]},"latex":{"type":"string"}},"required":["type","latex"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["paragraph"]},"text":{"$ref":"#/components/schemas/BotRichText"},"is_rtl":{"type":"boolean","enum":[true]}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["heading"]},"text":{"$ref":"#/components/schemas/BotRichText"},"size":{"$ref":"#/components/schemas/WirePositiveInteger"},"is_rtl":{"type":"boolean","enum":[true]}},"required":["type","text","size"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["pre"]},"text":{"$ref":"#/components/schemas/BotRichText"},"language":{"type":"string"}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["footer"]},"text":{"$ref":"#/components/schemas/BotRichText"},"is_rtl":{"type":"boolean","enum":[true]}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["divider"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["list"]},"items":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"blocks":{"type":"array","items":{"$ref":"#/components/schemas/BotRichBlock"}},"has_checkbox":{"type":"boolean","enum":[true]},"is_checked":{"type":"boolean","enum":[true]},"value":{"$ref":"#/components/schemas/WireSafeInteger"}},"required":["label","blocks"],"additionalProperties":false}},"is_rtl":{"type":"boolean","enum":[true]}},"required":["type","items"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["blockquote"]},"blocks":{"type":"array","items":{"$ref":"#/components/schemas/BotRichBlock"}},"is_rtl":{"type":"boolean","enum":[true]}},"required":["type","blocks"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["collage"]},"blocks":{"type":"array","items":{"$ref":"#/components/schemas/BotRichBlock"}}},"required":["type","blocks"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["details"]},"summary":{"$ref":"#/components/schemas/BotRichText"},"blocks":{"type":"array","items":{"$ref":"#/components/schemas/BotRichBlock"}},"is_open":{"type":"boolean","enum":[true]},"kind":{"type":"string","enum":["progress"]},"is_rtl":{"type":"boolean","enum":[true]}},"required":["type","summary","blocks"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["table"]},"cells":{"type":"array","items":{"type":"array","items":{"type":"object","properties":{"text":{"$ref":"#/components/schemas/BotRichText"},"align":{"type":"string","enum":["left","center","right"]},"is_header":{"type":"boolean","enum":[true]}},"required":["text","align"],"additionalProperties":false}}},"is_bordered":{"type":"boolean","enum":[true]},"is_rtl":{"type":"boolean","enum":[true]}},"required":["type","cells"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["photo"]},"alt":{"$ref":"#/components/schemas/BotRichText"},"file":{"$ref":"#/components/schemas/BotFile"},"width":{"$ref":"#/components/schemas/WireNonNegativeInteger"},"height":{"$ref":"#/components/schemas/WireNonNegativeInteger"}},"required":["type"],"additionalProperties":false}],"description":"A structural content block containing recursive rich text or child blocks."},"BotRichMessage":{"type":"object","properties":{"blocks":{"type":"array","items":{"$ref":"#/components/schemas/BotRichBlock"}}},"required":["blocks"],"additionalProperties":false,"description":"Structural rich content for a message."},"BotRichText":{"oneOf":[{"type":"string"},{"type":"array","items":{"$ref":"#/components/schemas/BotRichText"}},{"type":"object","properties":{"type":{"type":"string","enum":["bold","italic","underline","strikethrough","highlight","code"]},"text":{"$ref":"#/components/schemas/BotRichText"}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["url"]},"text":{"$ref":"#/components/schemas/BotRichText"},"url":{"type":"string"}},"required":["type","text","url"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["math"]},"text":{"$ref":"#/components/schemas/BotRichText"},"latex":{"type":"string"}},"required":["type","text","latex"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["email_address"]},"text":{"$ref":"#/components/schemas/BotRichText"},"email_address":{"type":"string"}},"required":["type","text","email_address"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["phone_number"]},"text":{"$ref":"#/components/schemas/BotRichText"},"phone_number":{"type":"string"}},"required":["type","text","phone_number"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["mention"]},"text":{"$ref":"#/components/schemas/BotRichText"},"username":{"type":"string"}},"required":["type","text","username"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["text_mention"]},"text":{"$ref":"#/components/schemas/BotRichText"},"user":{"$ref":"#/components/schemas/BotUser"}},"required":["type","text","user"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["bot_command"]},"text":{"$ref":"#/components/schemas/BotRichText"},"bot_command":{"type":"string"}},"required":["type","text","bot_command"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["chat_link"]},"text":{"$ref":"#/components/schemas/BotRichText"},"chat_id":{"$ref":"#/components/schemas/ChatId"}},"required":["type","text","chat_id"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["thread_title"]},"text":{"$ref":"#/components/schemas/BotRichText"},"title":{"type":"string"},"space_id":{"$ref":"#/components/schemas/SpaceId"}},"required":["type","text","title"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["group_mention"]},"text":{"$ref":"#/components/schemas/BotRichText"},"group_id":{"$ref":"#/components/schemas/WirePositiveInteger"}},"required":["type","text","group_id"],"additionalProperties":false}],"description":"Recursive rich text following Telegram's text-tree model."},"BotSearchFilter":{"type":"string","enum":["photo","video","photo_video","document","link","voice"]},"BotSkill":{"type":"object","properties":{"key":{"type":"string","allOf":[{"minLength":1},{"maxLength":256},{"description":"Stable harness activation key."}]},"name":{"type":"string","allOf":[{"minLength":1},{"maxLength":256},{"description":"Human-facing installed skill name."}]},"description":{"type":"string","allOf":[{"maxLength":4000}]},"sort_order":{"$ref":"#/components/schemas/WireSafeInteger"}},"required":["key","name"],"additionalProperties":false,"description":"An installed skill published by the authenticated bot harness."},"BotSpace":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/SpaceId"},"name":{"type":"string"},"is_public":{"type":"boolean"},"handle":{"type":"string"}},"required":["id","name"],"additionalProperties":false},"BotSpaceMember":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/WirePositiveInteger"},"space_id":{"$ref":"#/components/schemas/SpaceId"},"user_id":{"$ref":"#/components/schemas/UserId"},"role":{"type":"string","enum":["owner","admin","member"]},"date":{"$ref":"#/components/schemas/WireNonNegativeInteger"},"can_access_public_chats":{"type":"boolean"}},"required":["id","space_id","user_id","date","can_access_public_chats"],"additionalProperties":false},"BotTrueSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"type":"boolean","enum":[true],"allOf":[{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false},"BotUnauthorizedError":{"type":"object","properties":{"ok":{"type":"boolean","enum":[false],"allOf":[{"description":"Always false for an unsuccessful request."}]},"error":{"type":"string","allOf":[{"description":"Stable machine-readable error name."}]},"error_code":{"allOf":[{"$ref":"#/components/schemas/HttpStatusCode"},{"description":"HTTP status code returned for the request."}]},"description":{"type":"string","allOf":[{"description":"Human-readable explanation of the error."}]},"parameters":{"type":"object","properties":{"retry_after":{"$ref":"#/components/schemas/WireNonNegativeInteger"}},"additionalProperties":false,"allOf":[{"description":"Optional structured recovery information."}]}},"required":["ok","error_code","description"],"additionalProperties":false,"description":"The bot token is missing or invalid.","examples":[{"ok":false,"error":"UNAUTHORIZED","error_code":401,"description":"Unauthorized"}]},"BotUpdate":{"oneOf":[{"type":"object","properties":{"update_id":{"$ref":"#/components/schemas/WirePositiveInteger"},"activation_reason":{"$ref":"#/components/schemas/BotActivationReason"},"activated_agent":{"$ref":"#/components/schemas/BotAgent"},"message":{"$ref":"#/components/schemas/BotEventMessage"}},"required":["update_id","message"],"additionalProperties":false},{"type":"object","properties":{"update_id":{"$ref":"#/components/schemas/WirePositiveInteger"},"activation_reason":{"$ref":"#/components/schemas/BotActivationReason"},"activated_agent":{"$ref":"#/components/schemas/BotAgent"},"edited_message":{"$ref":"#/components/schemas/BotEventMessage"}},"required":["update_id","edited_message"],"additionalProperties":false},{"type":"object","properties":{"update_id":{"$ref":"#/components/schemas/WirePositiveInteger"},"activation_reason":{"$ref":"#/components/schemas/BotActivationReason"},"activated_agent":{"$ref":"#/components/schemas/BotAgent"},"message_reaction":{"type":"object","properties":{"chat":{"$ref":"#/components/schemas/BotEventChat"},"message_id":{"$ref":"#/components/schemas/MessageId"},"actor":{"$ref":"#/components/schemas/BotUser"},"date":{"$ref":"#/components/schemas/WireNonNegativeInteger"},"old_reaction":{"type":"array","items":{"$ref":"#/components/schemas/BotReaction"}},"new_reaction":{"type":"array","items":{"$ref":"#/components/schemas/BotReaction"}}},"required":["chat","message_id","actor","date","old_reaction","new_reaction"],"additionalProperties":false}},"required":["update_id","message_reaction"],"additionalProperties":false},{"type":"object","properties":{"update_id":{"$ref":"#/components/schemas/WirePositiveInteger"},"activation_reason":{"$ref":"#/components/schemas/BotActivationReason"},"activated_agent":{"$ref":"#/components/schemas/BotAgent"},"message_action":{"type":"object","properties":{"interaction_id":{"$ref":"#/components/schemas/WirePositiveInteger"},"chat":{"$ref":"#/components/schemas/BotEventChat"},"message_id":{"$ref":"#/components/schemas/MessageId"},"actor":{"$ref":"#/components/schemas/BotUser"},"date":{"$ref":"#/components/schemas/WireNonNegativeInteger"},"action":{"anyOf":[{"type":"object","properties":{"action_id":{"type":"string"},"callback_data":{"type":"string"},"callback_data_base64":{"not":{}}},"required":["action_id","callback_data"],"additionalProperties":false},{"type":"object","properties":{"action_id":{"type":"string"},"callback_data":{"not":{}},"callback_data_base64":{"type":"string"}},"required":["action_id","callback_data_base64"],"additionalProperties":false},{"type":"object","properties":{"action_id":{"type":"string"},"callback_data":{"not":{}},"callback_data_base64":{"not":{}}},"required":["action_id"],"additionalProperties":false}]}},"required":["interaction_id","chat","message_id","actor","date","action"],"additionalProperties":false}},"required":["update_id","message_action"],"additionalProperties":false},{"type":"object","properties":{"update_id":{"$ref":"#/components/schemas/WirePositiveInteger"},"activation_reason":{"$ref":"#/components/schemas/BotActivationReason"},"activated_agent":{"$ref":"#/components/schemas/BotAgent"},"bot_participation":{"$ref":"#/components/schemas/BotParticipationChange"}},"required":["update_id","bot_participation"],"additionalProperties":false}],"description":"One durable event from the authenticated bot's update stream."},"BotUpdateAgentSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"type":"object","properties":{"agent":{"$ref":"#/components/schemas/BotAgent"}},"required":["agent"],"additionalProperties":false,"allOf":[{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false},"BotUpdateKey":{"type":"string","enum":["message","edited_message","message_reaction","message_action","bot_participation"]},"BotUploadFilePayload":{"type":"object","properties":{"type":{"type":"string","enum":["photo","video","document","voice"]},"file":{"type":"string","format":"binary"},"thumbnail":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}]},"width":{"type":"string"},"height":{"type":"string"},"duration":{"type":"string"},"is_animated":{"type":"string"},"has_audio":{"type":"string"},"waveform_base64":{"type":"string"}},"required":["type","file"],"additionalProperties":false},"BotUser":{"type":"object","properties":{"id":{"allOf":[{"$ref":"#/components/schemas/UserId"},{"description":"Unique identifier for this Inline user."}]},"is_bot":{"type":"boolean","allOf":[{"description":"True when the user represents a bot account."}]},"username":{"type":"string","allOf":[{"description":"Public username, without the leading @."}]},"first_name":{"type":"string","allOf":[{"description":"User's first or display name."}]},"last_name":{"type":"string","allOf":[{"description":"User's last name, when available."}]}},"required":["id","is_bot"],"additionalProperties":false,"description":"Basic information about an Inline user or bot.","examples":[{"id":284901,"is_bot":true,"username":"deploy_bot","first_name":"Deploy Bot"}]},"BotWebhookInfo":{"type":"object","properties":{"url":{"type":"string"},"pending_update_count":{"$ref":"#/components/schemas/WireNonNegativeInteger"},"allowed_updates":{"type":"array","items":{"$ref":"#/components/schemas/BotUpdateKey"}},"message_trigger":{"$ref":"#/components/schemas/BotMessageTrigger"},"last_error_date":{"$ref":"#/components/schemas/WireNonNegativeInteger"},"last_error_message":{"type":"string"},"dropped_update_count":{"$ref":"#/components/schemas/WireNonNegativeInteger"}},"required":["url","pending_update_count","allowed_updates","message_trigger","dropped_update_count"],"additionalProperties":false},"BotWebhookInfoSuccess":{"type":"object","properties":{"ok":{"type":"boolean","enum":[true],"allOf":[{"description":"Always true for a successful request."}]},"result":{"allOf":[{"$ref":"#/components/schemas/BotWebhookInfo"},{"description":"Method-specific response payload."}]}},"required":["ok","result"],"additionalProperties":false},"ChatId":{"type":"integer","allOf":[{"minimum":1,"maximum":9007199254740991,"description":"A positive Inline chat identifier"}]},"ChatIdString":{"type":"string","allOf":[{"pattern":"^[1-9][0-9]*$","description":"A positive decimal Inline chat identifier","examples":["123456789"]}]},"CreateAgentInput":{"type":"object","properties":{"name":{"type":"string","allOf":[{"minLength":1},{"maxLength":256}]},"handle":{"type":"string","allOf":[{"maxLength":256}]},"emoji":{"type":"string","allOf":[{"maxLength":64}]},"description":{"type":"string","allOf":[{"maxLength":4000}]},"skill_key":{"type":"string","allOf":[{"maxLength":256}]},"instructions":{"type":"string","allOf":[{"maxLength":32000}]}},"required":["name"],"additionalProperties":false},"CreateReplyThreadInput":{"type":"object","properties":{"chat_id":{"$ref":"#/components/schemas/ChatId"},"message_id":{"$ref":"#/components/schemas/MessageId"},"title":{"type":"string"},"emoji":{"type":"string"},"participants":{"type":"array","items":{"$ref":"#/components/schemas/UserId"},"allOf":[{"maxItems":50}]}},"required":["chat_id","message_id"],"additionalProperties":false,"description":"Creates or returns the reply thread anchored to a message."},"CreateThreadInput":{"type":"object","properties":{"title":{"type":"string"},"emoji":{"type":"string"},"space_id":{"$ref":"#/components/schemas/SpaceId"},"is_public":{"type":"boolean"},"participants":{"type":"array","items":{"$ref":"#/components/schemas/UserId"},"allOf":[{"maxItems":50}]}},"additionalProperties":false,"description":"Creates a normal Inline thread using existing access rules."},"DeleteAgentInput":{"type":"object","properties":{"agent_id":{"$ref":"#/components/schemas/WireSafeIntegerInput"}},"required":["agent_id"],"additionalProperties":false},"DeleteMessageInput":{"type":"object","properties":{"user_id":{"allOf":[{"$ref":"#/components/schemas/UserId"},{"description":"Target a private conversation with this user. Supply exactly one of user_id or chat_id."}]},"chat_id":{"allOf":[{"$ref":"#/components/schemas/ChatId"},{"description":"Target this chat. Supply exactly one of chat_id or user_id."}]},"message_id":{"allOf":[{"$ref":"#/components/schemas/MessageId"},{"description":"Message to delete in the target chat."}]}},"required":["message_id"],"additionalProperties":false,"description":"Parameters for deleting a message. Exactly one target field is required."},"DeleteMessagesInput":{"type":"object","properties":{"user_id":{"allOf":[{"$ref":"#/components/schemas/UserId"},{"description":"Target a private conversation with this user. Supply exactly one of user_id or chat_id."}]},"chat_id":{"allOf":[{"$ref":"#/components/schemas/ChatId"},{"description":"Target this chat. Supply exactly one of chat_id or user_id."}]},"message_ids":{"type":"array","items":{"$ref":"#/components/schemas/MessageId"},"allOf":[{"minItems":1},{"maxItems":100}]}},"required":["message_ids"],"additionalProperties":false,"description":"Deletes up to 100 messages. Missing message IDs are skipped, matching Telegram's batch behavior."},"DeleteReactionInput":{"type":"object","properties":{"user_id":{"allOf":[{"$ref":"#/components/schemas/UserId"},{"description":"Target a private conversation with this user. Supply exactly one of user_id or chat_id."}]},"chat_id":{"allOf":[{"$ref":"#/components/schemas/ChatId"},{"description":"Target this chat. Supply exactly one of chat_id or user_id."}]},"message_id":{"allOf":[{"$ref":"#/components/schemas/MessageId"},{"description":"Message to react to in the target chat."}]},"emoji":{"type":"string","allOf":[{"description":"Emoji reaction to add or update."}]}},"required":["message_id","emoji"],"additionalProperties":false,"description":"Removes the bot's own reaction from a message."},"DeleteWebhookInput":{"type":"object","properties":{"drop_pending_updates":{"type":"boolean"}},"additionalProperties":false},"EditMessageActionsInput":{"type":"object","properties":{"user_id":{"allOf":[{"$ref":"#/components/schemas/UserId"},{"description":"Target a private conversation with this user. Supply exactly one of user_id or chat_id."}]},"chat_id":{"allOf":[{"$ref":"#/components/schemas/ChatId"},{"description":"Target this chat. Supply exactly one of chat_id or user_id."}]},"message_id":{"$ref":"#/components/schemas/MessageId"},"actions":{"type":"array","items":{"type":"array","items":{"$ref":"#/components/schemas/BotMessageAction"},"allOf":[{"maxItems":8}]},"allOf":[{"maxItems":8}]}},"required":["message_id","actions"],"additionalProperties":false,"description":"Replaces all actions on a bot-authored message. An empty array clears them without changing text."},"EditMessageTextInput":{"type":"object","properties":{"user_id":{"allOf":[{"$ref":"#/components/schemas/UserId"},{"description":"Target a private conversation with this user. Supply exactly one of user_id or chat_id."}]},"chat_id":{"allOf":[{"$ref":"#/components/schemas/ChatId"},{"description":"Target this chat. Supply exactly one of chat_id or user_id."}]},"message_id":{"allOf":[{"$ref":"#/components/schemas/MessageId"},{"description":"Message to edit in the target chat."}]},"text":{"type":"string","allOf":[{"description":"New text for the message."}]},"parse_markdown":{"type":"boolean","allOf":[{"description":"Parse Inline's supported Markdown surface from the new text. Defaults to true; false preserves the supplied syntax literally."}]},"actions":{"type":"array","items":{"type":"array","items":{"$ref":"#/components/schemas/BotMessageAction"},"allOf":[{"maxItems":8}]},"allOf":[{"maxItems":8}]}},"required":["message_id","text"],"additionalProperties":false,"description":"Parameters for editing a text message. Exactly one target field is required."},"ForwardMessageInput":{"type":"object","properties":{"chat_id":{"$ref":"#/components/schemas/ChatId"},"from_chat_id":{"$ref":"#/components/schemas/ChatId"},"message_id":{"$ref":"#/components/schemas/MessageId"}},"required":["chat_id","from_chat_id","message_id"],"additionalProperties":false},"ForwardMessagesInput":{"type":"object","properties":{"chat_id":{"$ref":"#/components/schemas/ChatId"},"from_chat_id":{"$ref":"#/components/schemas/ChatId"},"message_ids":{"type":"array","items":{"$ref":"#/components/schemas/MessageId"},"allOf":[{"minItems":1},{"maxItems":100}]}},"required":["chat_id","from_chat_id","message_ids"],"additionalProperties":false,"description":"Forwards up to 100 messages and returns the new IDs. Missing source IDs are skipped."},"GetMessagesInput":{"type":"object","properties":{"user_id":{"allOf":[{"$ref":"#/components/schemas/UserId"},{"description":"Target a private conversation with this user. Supply exactly one of user_id or chat_id."}]},"chat_id":{"allOf":[{"$ref":"#/components/schemas/ChatId"},{"description":"Target this chat. Supply exactly one of chat_id or user_id."}]},"message_ids":{"type":"array","items":{"$ref":"#/components/schemas/MessageId"},"allOf":[{"minItems":1},{"maxItems":100}]}},"required":["message_ids"],"additionalProperties":false,"description":"Selects up to 100 exact messages in one conversation."},"GetSpaceInput":{"type":"object","properties":{"space_id":{"$ref":"#/components/schemas/SpaceId"}},"required":["space_id"],"additionalProperties":false,"description":"Returns one accessible space and only the bot's own membership."},"HttpStatusCode":{"type":"integer","allOf":[{"minimum":100,"maximum":599,"description":"A standard HTTP response status code from 100 through 599"}]},"MessageId":{"type":"integer","allOf":[{"minimum":1,"maximum":9007199254740991,"description":"A positive Inline message identifier"}]},"MessageIdString":{"type":"string","allOf":[{"pattern":"^[1-9][0-9]*$","description":"A positive decimal Inline message identifier","examples":["123456789"]}]},"PinMessageInput":{"type":"object","properties":{"chat_id":{"$ref":"#/components/schemas/ChatId"},"message_id":{"$ref":"#/components/schemas/MessageId"}},"required":["chat_id","message_id"],"additionalProperties":false},"SafeIntegerString":{"type":"string","allOf":[{"pattern":"^[+-]?[0-9]+$","description":"A signed decimal integer string within JavaScript's safe-integer range","examples":["42"]}]},"SearchMessagesInput":{"type":"object","properties":{"user_id":{"allOf":[{"$ref":"#/components/schemas/UserId"},{"description":"Target a private conversation with this user. Supply exactly one of user_id or chat_id."}]},"chat_id":{"allOf":[{"$ref":"#/components/schemas/ChatId"},{"description":"Target this chat. Supply exactly one of chat_id or user_id."}]},"query":{"type":"string","allOf":[{"minLength":1},{"maxLength":256}]},"filter":{"$ref":"#/components/schemas/BotSearchFilter"},"offset_message_id":{"$ref":"#/components/schemas/MessageId"},"limit":{"type":"integer","allOf":[{"minimum":-9007199254740991,"maximum":9007199254740991,"description":"An integer that can be represented exactly by a JavaScript number"},{"minimum":1,"maximum":100}]}},"required":["query"],"additionalProperties":false,"description":"Searches messages within exactly one accessible chat."},"SendChatActionInput":{"type":"object","properties":{"user_id":{"allOf":[{"$ref":"#/components/schemas/UserId"},{"description":"Target a private conversation with this user. Supply exactly one of user_id or chat_id."}]},"chat_id":{"allOf":[{"$ref":"#/components/schemas/ChatId"},{"description":"Target this chat. Supply exactly one of chat_id or user_id."}]},"action":{"$ref":"#/components/schemas/BotChatAction"}},"required":["action"],"additionalProperties":false},"SendMessageInput":{"type":"object","properties":{"user_id":{"allOf":[{"$ref":"#/components/schemas/UserId"},{"description":"Target a private conversation with this user. Supply exactly one of user_id or chat_id."}]},"chat_id":{"allOf":[{"$ref":"#/components/schemas/ChatId"},{"description":"Target this chat. Supply exactly one of chat_id or user_id."}]},"text":{"type":"string","allOf":[{"description":"Text of the message to send."}]},"reply_to_message_id":{"allOf":[{"$ref":"#/components/schemas/MessageId"},{"description":"Message to reply to in the target chat."}]},"parse_markdown":{"type":"boolean","allOf":[{"description":"Parse Inline's supported Markdown surface. Defaults to true; false preserves the supplied syntax literally."}]},"media":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["nudge"]}},"required":["type"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","enum":["photo","video","document","voice"]},"file_id":{"type":"string","allOf":[{"minLength":1}]}},"required":["type","file_id"],"additionalProperties":false}]},"actions":{"type":"array","items":{"type":"array","items":{"$ref":"#/components/schemas/BotMessageAction"},"allOf":[{"maxItems":8}]},"allOf":[{"maxItems":8}]},"silent":{"type":"boolean"},"source_chat_id":{"allOf":[{"$ref":"#/components/schemas/ChatId"},{"description":"Source chat for an explicit same-bot cross-thread Agent handoff."}]}},"additionalProperties":false,"description":"Parameters for sending a text message. Exactly one target field is required."},"SendReactionInput":{"type":"object","properties":{"user_id":{"allOf":[{"$ref":"#/components/schemas/UserId"},{"description":"Target a private conversation with this user. Supply exactly one of user_id or chat_id."}]},"chat_id":{"allOf":[{"$ref":"#/components/schemas/ChatId"},{"description":"Target this chat. Supply exactly one of chat_id or user_id."}]},"message_id":{"allOf":[{"$ref":"#/components/schemas/MessageId"},{"description":"Message to react to in the target chat."}]},"emoji":{"type":"string","allOf":[{"description":"Emoji reaction to add or update."}]}},"required":["message_id","emoji"],"additionalProperties":false,"description":"Parameters for reacting to a message. Exactly one target field is required."},"SetMyCommandsInput":{"type":"object","properties":{"commands":{"type":"array","items":{"$ref":"#/components/schemas/BotCommand"},"allOf":[{"description":"Complete replacement list of up to 100 commands. Send an empty array to clear it."}],"maxItems":100}},"required":["commands"],"additionalProperties":false,"description":"Commands to publish for the authenticated bot."},"SetMySkillsInput":{"type":"object","properties":{"skills":{"type":"array","items":{"$ref":"#/components/schemas/BotSkill"},"allOf":[{"maxItems":250},{"description":"Complete replacement catalog of up to 250 installed skills. Send an empty array to clear it."}]}},"required":["skills"],"additionalProperties":false,"description":"Installed skills to publish for the authenticated bot harness."},"SetThreadTitleInput":{"type":"object","properties":{"chat_id":{"$ref":"#/components/schemas/ChatId"},"title":{"type":"string","allOf":[{"minLength":1},{"maxLength":256}]},"emoji":{"type":"string","allOf":[{"maxLength":20}]}},"required":["chat_id"],"additionalProperties":false},"SetWebhookInput":{"type":"object","properties":{"url":{"type":"string"},"secret_token":{"type":"string","allOf":[{"minLength":1},{"maxLength":256}]},"message_trigger":{"$ref":"#/components/schemas/BotMessageTrigger"},"allowed_updates":{"type":"array","items":{"$ref":"#/components/schemas/BotUpdateKey"}},"drop_pending_updates":{"type":"boolean"}},"required":["url"],"additionalProperties":false},"SpaceId":{"type":"integer","allOf":[{"minimum":1,"maximum":9007199254740991,"description":"A positive Inline space identifier"}]},"ThreadParticipantMutationInput":{"type":"object","properties":{"chat_id":{"$ref":"#/components/schemas/ChatId"},"user_id":{"$ref":"#/components/schemas/UserId"}},"required":["chat_id","user_id"],"additionalProperties":false},"UpdateAgentInput":{"type":"object","properties":{"agent_id":{"$ref":"#/components/schemas/WireSafeIntegerInput"},"name":{"type":"string","allOf":[{"minLength":1},{"maxLength":256}]},"handle":{"type":"string","allOf":[{"maxLength":256}]},"emoji":{"type":"string","allOf":[{"maxLength":64}]},"description":{"type":"string","allOf":[{"maxLength":4000}]},"skill_key":{"type":"string","allOf":[{"maxLength":256}]},"instructions":{"type":"string","allOf":[{"maxLength":32000}]}},"required":["agent_id"],"additionalProperties":false},"UserId":{"type":"integer","allOf":[{"minimum":1,"maximum":9007199254740991,"description":"A positive Inline user identifier"}]},"UserIdString":{"type":"string","allOf":[{"pattern":"^[1-9][0-9]*$","description":"A positive decimal Inline user identifier","examples":["123456789"]}]},"WireNonNegativeInteger":{"type":"integer","allOf":[{"minimum":0,"maximum":9007199254740991,"description":"A non-negative integer that can be represented exactly by a JavaScript number"}]},"WirePositiveInteger":{"type":"integer","allOf":[{"minimum":1,"maximum":9007199254740991,"description":"A positive integer that can be represented exactly by a JavaScript number"}]},"WireSafeInteger":{"type":"integer","allOf":[{"minimum":-9007199254740991,"maximum":9007199254740991,"description":"An integer that can be represented exactly by a JavaScript number"}]},"WireSafeIntegerInput":{"anyOf":[{"$ref":"#/components/schemas/WireSafeInteger"},{"$ref":"#/components/schemas/SafeIntegerString"}],"description":"A safe integer supplied as a JSON integer or decimal integer string"}},"securitySchemes":{}},"security":[],"tags":[{"name":"Bot","description":"Inline Bot HTTP API methods."}],"servers":[{"url":"https://api.inline.chat","description":"Production API server"}]}