Developers

API Reference

Name: mantle
Author: mantle

Complete endpoint documentation for the mantle REST API.

Authentication

All requests require a Bearer token in the Authorization header:

Authorization: Bearer mk_live_...

Base URL

https://api.mantleai.dev

POST/v1/search

Search across all connected sources and return quality-scored context.

Request Body

{
  "query": "Q3 revenue by region",
  "max_objects": 20,
  "min_quality": 0.8
}

Response

{
  "objects": [...],
  "sources": 4,
  "quality_score": 0.94,
  "latency_ms": 87
}

POST/v1/entities

Resolve and retrieve entities across connected data sources.

Request Body

{
  "name": "Acme Corp",
  "type": "organization",
  "include_relationships": true
}

Response

{
  "entity": { "id": "ent_...", "type": "organization" },
  "matches": 7,
  "sources": ["salesforce", "slack", "snowflake"]
}

GET/v1/sources

List all connected data sources and their sync status.

Response

{
  "sources": [
    { "id": "src_...", "name": "Salesforce", "status": "active" },
    { "id": "src_...", "name": "Snowflake", "status": "active" }
  ],
  "total": 42
}

GET/v1/health

Check API and service health status.

Response

{ "status": "healthy", "latency_ms": 12, "version": "1.0.0" }

Rate Limits

Free1,000 queries / month

Pro100,000 queries / month

EnterpriseUnlimited