{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Return a machine-readable, per-user list of what Fin can do for a given end user, so an\norchestrating agent can decide which endpoint to call.\n\nThe response is audience-matched to the supplied user: each live, API-triggerable\nprocedure is checked against that user before being included, alongside the static\n`reply`, `ask`, and `escalate` actions.\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":{"user":{"allOf":[{"$ref":"#/definitions/fin_agent_user"},{"description":"The user to list capabilities for. If no user exists for the id, one is created from the supplied details; if the user already exists, the supplied email and attributes update it."}]}},"required":["user"],"examples":[{"user":{"id":"123456"}}]}},"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_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"]}}},"name":"Discover Fin's capabilities","id":"intercom.listfincapabilities","example":{"body":{"user":{"id":"123456"}}},"maxRequests":1,"summary":false}}