API Reference Overview

The Makinari REST API allows you to programmatically manage your AI team, query data, and trigger workflows.

Authentication

All API requests (except for client-side tracking scripts using CORS) require an API key passed as a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

x-api-key: YOUR_API_KEY is accepted as well. Browser calls with an allowed Origin skip the key. See Auth.

Base URL

All new integrations should use the following base URL:

https://backend.makinari.com

The Site ID

Almost all endpoints require a site_id to know which workspace you are interacting with. You can pass it as a query parameter or in the JSON body, depending on the endpoint.

Interactive API Tester

Many of the endpoints in this reference include an interactive ApiTester component. You can paste your API Key and Site ID directly into the documentation to make live requests against the production API.