Evermuse API - Evermuse API

Welcome to the Evermuse API documentation. The API allows you to upload integration payloads wrapped in a stable canonical envelope for processing by the Evermuse platform.

Evermuse MCP Server

Connect Claude, ChatGPT, Cursor, Codex and other AI agents to your customer evidence over the Model Context Protocol.

Authentication

Learn how to authenticate your API requests with workspace-scoped API keys.

Data Lake

Understand how ingested data is stored, deduplicated, and monitored.

API Reference

Explore the full Ingestion API reference with interactive examples.

Overview

The Ingestion API accepts records in three formats:

A single record object
An array of record objects
An object with a records key containing an array

For high-volume sends, use application/x-ndjson (one JSON object per line). Each record follows the Integration Envelope schema, which wraps the original vendor payload in a canonical structure with metadata fields like _type, _event_at, _vendor_ids, _product_id, and _project_id.

Base URL

https://api.evermuse.com

Quick Start

curl -X POST https://api.evermuse.com/api/v1/ingest \
  -H "Content-Type: application/json" \
  -H "x-api-key: em_sk_your_api_key" \
  -d '{
    "_type": "message",
    "_schema_version": "1.0.0",
    "_event_at": "2026-02-24T12:34:56Z",
    "_nature": "evidence",
    "_vendor_ids": { "slack_message_id": "1710.000200" },
    "_product_id": "prod-abc",
    "_project_id": "proj-123",
    "data": {
      "type": "message",
      "user": "U123",
      "text": "Hello world",
      "ts": "1710.000200"
    }
  }'