Overview
Cloud Stacks can be created within OTTO projects using knowledge bases via the Search Atlas API. This article explains what you will need and how to get started. Because the exact endpoint details, required payload fields, and navigation paths vary based on your account configuration, our team can walk you through the precise steps for your setup.
What You Need Before You Start
- A Search Atlas account with an active OTTO project
- Your OTTO Project ID (found within your Search Atlas account)
- Your Knowledge Graph ID (linked to the OTTO project, found within your Search Atlas account)
- Your Search Atlas API key (found in Account Menu → Settings → API Keys)
- An API client capable of sending HTTP requests
How to Find Your OTTO Project ID and Knowledge Graph ID
Your OTTO Project ID and Knowledge Graph ID are available within your Search Atlas account when you open the relevant OTTO project. In many cases, these IDs appear in the page URL when you are viewing that project. If you are unsure where to locate them, our support team can help you identify the correct values for your account.
Authentication
Every API request to Search Atlas must be authenticated using your Search Atlas API key. Include your API key as a Bearer token in the Authorization header of each request. Never share your API key publicly. You can locate your API key in Account Menu → Settings → API Keys.
Sending Your API Request
To create a Cloud Stack via the API, you will need to send an authenticated request that references your OTTO Project ID and Knowledge Graph ID. The specific endpoint URL, required JSON payload fields, and exact parameter names for Cloud Stack creation are confirmed in the Search Atlas API documentation available in your account portal. We recommend consulting that documentation for the most accurate and up-to-date details.
Need Help Getting Started?
If you are unsure of your OTTO Project ID, Knowledge Graph ID, or the correct API endpoint and payload structure for your account, our team is here to help. When reaching out, please have the following ready:
- Your OTTO project name
- The knowledge base you intend to use
- Any error messages or response codes you have received
- The API client you are using
If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be connected with a member of our team.