Integrate Compass with Theneo ## Sections • [Introduction](https://app.theneo.io/theneo/integrate-compass-with-theneo/introduction.md): What is Theneo? Theneo is an advanced AI-driven platform that automates the process of creating, managing, and publishing high-quality API documentation. Theneo lets you effortlessly visualize API documentation for your Compass components without the need for implementing complex logic. • [Integrate Compass with Theneo](https://app.theneo.io/theneo/integrate-compass-with-theneo/integrate-compass-with-theneo.md): Installation On Compass, select Apps from the top menu bar. Locate the Theneo tile and select Install . Once installed, select Configure (accessible to admins only). Setting Up the Integration Install Theneo App on Compass Navigate to the Compass app, and paste the copied Theneo API key. This links your Theneo account to Compass. You can either create a new API documentation project or link an existing one from Theneo. • [Add a Project to a Compass Component](https://app.theneo.io/theneo/integrate-compass-with-theneo/add-a-project-to-a-compass-component.md): You have several options for adding a project to Compass components: Upload a File Find the Compass component where you want to add the spec file and select "Theneo." Navigate to the "Upload File" tab. Drag and drop the spec file onto the drop zone or use the drop zone to locate the file on your computer. The spec file can be up to 10MB. Using Webhook If your spec file is part of your build process, you can use a webhook: Example using the cURL command: curl -F file=<@FILE_NAME_TO_IMPORT> -F project_name=<PROJECT_NAME_TO_CREATE> -F ai_option=<none|full|enhance> -H "x-theneo-api-key:<YOUR_API_KEY>" https://api.theneo.io/project/import/specfile Replace FILE_NAME_TO_IMPORT with your .json file's name. Replace PROJECT_NAME_TO_CREATE with the project title you want to add. Replace YOUR_API_KEY with your Theneo API key. Choose one of the options for ai_option : none (no AI assistance), full (full AI assistance), or enhance (enhance existing content). The imported project will appear in the Link Existing Project section. Linking to an Existing Project From the dropdown menu, you can select from all published projects created within Theneo. Transform Your API Documentation with AI Theneo offers AI assistance options for creating API documentation: Full AI Assistance : Allows AI to generate entirely new content, ensuring uniform and engaging documentation. Enhance Existing Content : Lets AI intelligently fill in only missing descriptions, preserving your existing content while enhancing it. All created projects will be accessible from Theneo's dashboard, where you can manage various features, including custom menu, ChatGPT search, and branding. • [Remove the Project from a Compass Component](https://app.theneo.io/theneo/integrate-compass-with-theneo/remove-the-project-from-a-compass-component.md): You can remove the project by following these steps: In your project view, on the right-top side, find the dropdown menu. Select the Generate new project option. • [Remove the API Key from a Compass Component](https://app.theneo.io/theneo/integrate-compass-with-theneo/remove-the-api-key-from-a-compass-component.md): To remove the API key from a Compass component, follow these steps: Navigate through the apps and find Theneo . Click on Configure On the bottom right, you'll find the option to Replace API Key . Note that only administrators can perform this action. • [Uninstall the Theneo App](https://app.theneo.io/theneo/integrate-compass-with-theneo/uninstall-the-theneo-app.md): If you decide to no longer use the Theneo app in your Compass instance, you can uninstall it easily: Navigate to Compass and select Apps from the top menu bar. Find the Theneo tile and select Uninstall . The Theneo app will be uninstalled, and Compass will no longer be integrated with Theneo. It's important to note that all created projects will be saved on Theneo's dashboard, and even if you uninstall the Theneo app from Compass, you will still have access to your projects from Theneo's platform.