{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Once Fin has returned a response to a user's message, its status will be `awaiting_user_reply`.\n\nIf a user replies, use this endpoint to send this response to Fin.\n\n{% admonition type=\"warning\" %}\nTo request access to the Fin Agent API, go to **Settings > Integrations > Fin Agent API** in your workspace and tell us about your use case. Once access is granted, **Fin Agent API** appears under **Fin AI Agent > Deploy**.\n{% /admonition %}\n","properties":{"headers":{"type":"object","properties":{"Intercom-Version":{"$ref":"#/definitions/intercom_version","enum":["2.17"]}},"required":[],"additionalProperties":false},"body":{"type":"object","properties":{"conversation_id":{"type":"string","description":"The ID of the conversation.","examples":["123456"]},"message":{"$ref":"#/definitions/fin_agent_message"},"user":{"$ref":"#/definitions/fin_agent_user"},"attachments":{"type":"array","description":"An array of attachments to include with the message. Maximum of 10 attachments.","maxItems":10,"items":{"$ref":"#/definitions/fin_agent_attachment"}},"response_format":{"type":"string","enum":["html","markdown"],"default":"html","description":"The format of the `body` in Fin's replies. Defaults to `html`. Requesting `markdown` on a workspace where it is not enabled returns a 403 error.","examples":["html"]}},"required":["conversation_id","message","user"],"examples":[{"conversation_id":"123456","message":{"author":"user","body":"Here's the information you requested.","timestamp":"2025-01-24T09:01:00.000Z"},"user":{"id":"123456","name":"John Doe","email":"john.doe@example.com"}}]}},"required":["body"],"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"]},"fin_agent_message":{"title":"Fin Agent Message","type":"object","description":"A message exchanged within a Fin Agent conversation.","properties":{"author":{"type":"string","enum":["user","agent","fin"],"description":"The author that created the message. In `conversation_metadata.history`, only `user` and `agent` are accepted.","examples":["user"]},"body":{"type":"string","description":"The body of the message. Accepts both plain text and HTML format.\nFor the message you send to Fin, this is the user's message. For an `agent` item in `conversation_metadata.history`, it is the agent's message.\nFin's response is returned in the format set by `response_format` (HTML by default).\n","examples":["How can I see my account details?"]},"timestamp":{"type":"string","format":"date-time","description":"The timestamp when the message was created.\nUsed to deduplicate messages sent within a 5 minute window.\nIdeally should include milliseconds for higher precision.\nSend `timestamp` or `timestamp_ms`; at least one is required. If you send both, `timestamp_ms` is used.\nOn the top-level `message`, sending neither fails with a 422 error (`message: timestamp_ms is required`). In `conversation_metadata.history`, an item with neither causes the whole history to be ignored.\n","examples":["2025-01-24T10:01:20.000Z"]},"timestamp_ms":{"type":"string","format":"date-time","description":"The timestamp when the message was created, with millisecond precision.\nAccepted in place of `timestamp` when you send a message, and also present in webhook event responses (fin_replied). At least one of `timestamp` or `timestamp_ms` is required.\n","examples":["2025-01-24T10:01:20.456Z"]}},"required":["author","body"]},"fin_agent_user":{"title":"Fin Agent User","type":"object","description":"A user object representing the user in a Fin Agent conversation.","properties":{"id":{"type":"string","description":"The ID of the user. This value will be used to uniquely identify the user\nduring a conversation with Fin. Maps to the user_id field on the Intercom User object.\n","examples":["123456"]},"name":{"type":"string","description":"The name of the user.","examples":["John Doe"]},"email":{"type":"string","format":"email","description":"The email of the user.","examples":["john.doe@example.com"]},"attributes":{"type":"object","description":"A hash of attributes associated with the user.\nAttributes can be used by Fin to target content and responses.\nLimit to 10 attributes.\n","additionalProperties":true,"examples":[{"plan_type":"Pro","subscription_status":"active"}]}},"required":["id"]},"fin_agent_attachment":{"title":"Fin Agent Attachment","type":"object","description":"An attachment object representing a file or URL attachment included with a message.\nAttachments can be used to provide additional context to Fin.\nMaximum of 10 attachments per request.\n","properties":{"type":{"type":"string","enum":["url","file"],"description":"The type of attachment.","examples":["url"]},"url":{"type":"string","format":"uri","description":"The URL of the attachment. Required when type is 'url'. Must be publicly accessible.","examples":["https://example.com/document.pdf"]},"name":{"type":"string","description":"The name of the file. Required when type is 'file'.","examples":["screenshot.png"]},"content_type":{"type":"string","description":"The MIME type of the file. Required when type is 'file'.","examples":["image/png"]},"data":{"type":"string","format":"byte","description":"Base64-encoded file data. Required when type is 'file'.","examples":["iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk..."]}},"required":["type"]}}},"name":"Reply to Fin","id":"intercom.replytofin","example":{"body":{"conversation_id":"123456","message":{"author":"user","body":"Here's the information you requested.","timestamp":"2025-01-24T09:01:00.000Z"},"user":{"id":"123456","name":"John Doe","email":"john.doe@example.com"}}},"maxRequests":1,"summary":false}}