API reference
On this page
The CluedIn REST API is documented endpoint by endpoint across the categories listed below. Each category is its own page, with an interactive reference for just that subset of the API. Splitting the reference keeps each page fast even though the full API has more than 700 endpoints.
Before making requests, review Get started for base URLs, authentication, and conventions that apply across the whole API.
Try it out against your environment
Each category page (and the full-screen viewer) includes a connection bar at the top. Enter your environment’s base URL (for example, https://acme.cluedin.com), your email, and your password, then select Connect. The viewer requests a bearer token on your behalf and attaches it to every request, which enables the Try it out button on every endpoint so you can send live calls and inspect the responses.
The token and base URL are held in your browser’s session storage and shared across the category pages until you close the tab or select Disconnect. If your CluedIn organization name differs from the first part of the host, expand Advanced to set the Client ID explicitly.
The calls run from your browser, so the target environment must allow cross-origin (CORS) requests from wherever you are viewing this documentation. If a request is blocked, host the documentation on an allowed origin, or use the curl/PowerShell examples in Get started instead. Credentials are sent only to the environment you specify and are never stored beyond the browser session.
Categories
| Category | Description |
|---|---|
| Access control & governance | Access control policies, audit logs, ownership, and tag metadata. |
| Entities | Read, create, modify, merge, and inspect golden records. |
| Search | Query the CluedIn graph and manage saved searches. |
| Vocabularies | Manage vocabularies and vocabulary keys. |
| Glossary | Manage glossary categories and terms. |
| Hierarchies | Build and manage hierarchies and the global data model. |
| Deduplication | Deduplication projects, automation, match results, and entity split. |
| Rules & evaluation | Manage rules, preview rule output, and inspect evaluation logs. |
| Streams, connectors & export | Configure, operate, and monitor export streams and connectors. |
| Data preparation & enrichment | Clean and enrich records. |
| AI | AI agents, jobs, skills, and Copilot. |
| Administration & configuration | Settings, logs, and metered billing. |
| Organization | Organization profile and usage statistics. |
Download the specification
The full CluedIn OpenAPI specification is bundled with this documentation and can be downloaded directly. Per-category specifications are linked from each category page.