{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"\nYou can fetch the details of a single conversation.\n\nThis will return a single Conversation model with all its conversation parts.\n\n{% admonition type=\"warning\" name=\"Hard limit of 500 parts\" %}\nThe maximum number of conversation parts that can be returned via the API is 500. If you have more than that we will return the 500 most recent conversation parts.\n{% /admonition %}\n\nFor AI agent conversation metadata, please note that you need to have the agent enabled in your workspace, which is a [paid feature](https://www.intercom.com/help/en/articles/8205718-fin-resolutions#h_97f8c2e671).\n","properties":{"headers":{"type":"object","properties":{"Intercom-Version":{"$ref":"#/definitions/intercom_version","enum":["2.17"]}},"required":[],"additionalProperties":false},"path":{"type":"object","properties":{"conversation_id":{"type":"integer","examples":[123],"description":"The id of the conversation to target"}},"required":["conversation_id"],"additionalProperties":false},"query":{"type":"object","properties":{"display_as":{"type":"string","examples":["plaintext"],"description":"Set to plaintext to retrieve conversation messages in plain text. This affects both the body and subject fields. Inline links are rendered as `label (url)`, preserving the link URL alongside the visible text."},"include_translations":{"type":"boolean","examples":[true],"description":"If set to true, conversation parts will be translated to the detected language of the conversation."},"include_email_history":{"type":"boolean","examples":[true],"description":"If set to true, the source of the conversation will include the email history, for conversations started by email."},"parts_created_after":{"type":"integer","examples":[1700000000],"description":"Only include conversation parts created at or after this time, as a Unix timestamp in seconds."},"parts_created_before":{"type":"integer","examples":[1700086400],"description":"Only include conversation parts created at or before this time, as a Unix timestamp in seconds."},"include_monitors":{"type":"boolean","default":false,"examples":[true],"description":"If set to true, the response will include a `monitor_evaluations` array with the latest QA monitor evaluation for each monitor that has evaluated this conversation."},"include_scorecards":{"type":"boolean","default":false,"examples":[true],"description":"If set to true, the response will include a `scorecards` array with any QA scorecard results for this conversation."}},"required":[],"additionalProperties":false}},"required":["path"],"additionalProperties":false,"definitions":{"intercom_version":{"description":"Intercom API version.</br>If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.","type":"string","enum":["1.0","1.1","1.2","1.3","1.4","2.0","2.1","2.2","2.3","2.4","2.5","2.6","2.7","2.8","2.9","2.10","2.11","2.12","2.13","2.14","2.15","2.16","2.17"],"examples":["2.17"]}}},"name":"Retrieve a conversation","id":"intercom.retrieveconversation","example":{"path":{"conversation_id":123}},"maxRequests":1,"summary":false}}