Integrator API

The Integrator API enables B2B partners to resell Snipara to their clients with isolated workspaces, dedicated API keys, and configurable resource limits.

Partner Program Only

The Integrator API is available to approved partners. Apply to the Partner Program to get started.

Overview

The Integrator system has a hierarchical structure:

Integrator (B2B Partner)
└── Workspace (white-label container)
    ├── Client A (end-user)
    │   ├── Project (isolated Snipara project)
    │   └── API Keys (snipara_ic_*)
    ├── Client B
    │   ├── Project
    │   └── API Keys
    └── Webhooks (client lifecycle events)

Authentication

All Integrator API endpoints require your standard Snipara API key with integrator permissions. You must be logged in as an approved integrator.

curl -H "Authorization: Bearer YOUR_SESSION_TOKEN" https://www.snipara.com/api/integrator/...

For MCP Server access (api.snipara.com), use your team API key with the X-API-Key header.

Base URLs

Service	Base URL	Use Case
Web App	`https://www.snipara.com/api/integrator`	Dashboard operations (requires session)
MCP Server	`https://api.snipara.com/v1/integrator`	Programmatic access (requires API key)

Integrator Tiers

Tier	Price	Client Limit
STARTER	$99/mo	10 clients
GROWTH	$249/mo	50 clients
SCALE	$499/mo	200 clients
ENTERPRISE	Custom	Unlimited

Client Bundles

Each client is assigned a bundle that determines their resource limits:

Bundle	Price	Queries/mo	Memories	Swarms	Agents/Swarm	Documents	Storage
`LITE`	$19/mo	500	100	1	5	50	100 MB
`STANDARD`	$49/mo	5,000	500	5	10	200	1 GB
`UNLIMITED`	$99/mo	Unlimited	Unlimited	Unlimited	20	Unlimited	10 GB

Workspace API

Get Workspace

GET /api/integrator/workspace

Returns your workspace details, including client count and limits.

Response

  "success": true,

  "data": {

    "id": "ws_abc123",

    "name": "Acme Workspace",

    "slug": "acme",

    "webhookUrl": "https://acme.com/webhooks/snipara",

    "hasWebhookSecret": true,

    "clientCount": 5,

    "clientLimit": 10,

    "tier": "STARTER"

Create Workspace

POST /api/integrator/workspace

  "name": "Acme Workspace",

  "slug": "acme"  // lowercase, alphanumeric + hyphens only

Update Workspace

PATCH /api/integrator/workspace

  "name": "New Name",  // optional

  "webhookUrl": "https://...",  // optional

  "webhookSecret": "your-secret"  // optional

Clients API

List Clients

GET /api/integrator/clients?limit=50&offset=0&is_active=true&bundle=STANDARD

Query Parameters

limit - Results per page (default: 50, max: 100)
offset - Pagination offset
is_active - Filter by status: true or false
bundle - Filter by bundle: LITE, STANDARD, UNLIMITED

Response

  "success": true,

  "data": {

    "clients": [

        "id": "client_456",

        "projectId": "proj_789",

        "projectSlug": "acme-client-a",

        "name": "Client A",

        "email": "admin@clienta.com",

        "externalId": "cust_123",

        "bundle": "STANDARD",

        "isActive": true,

        "limits": { "queries_per_month": 2000, ... }

],

    "pagination": { "total": 5, "limit": 50, "offset": 0, "hasMore": false }

Create Client

POST /api/integrator/clients

  "name": "Client A",

  "email": "admin@clienta.com",

  "external_id": "cust_123",  // optional, your internal ID

  "bundle": "STANDARD"  // LITE, STANDARD, or UNLIMITED

Creating a client automatically provisions an isolated Snipara project with the slug format: {workspace_slug}-{client_name}.

Get Client

GET /api/integrator/clients/:clientId

Update Client

PATCH /api/integrator/clients/:clientId

  "name": "New Name",  // optional

  "email": "new@email.com",  // optional

  "bundle": "UNLIMITED",  // optional

  "is_active": false  // optional, deactivate client

Delete Client

DELETE /api/integrator/clients/:clientId

Warning: Permanent Deletion

Deleting a client permanently removes their project and all associated data. This action cannot be undone.

Client API Keys

Client API keys use the snipara_ic_ prefix to distinguish them from regular API keys. These keys grant access only to the client's project.

List API Keys

GET /api/integrator/clients/:clientId/api-keys

Create API Key

POST /api/integrator/clients/:clientId/api-keys

  "name": "Production Key",

  "expires_in_days": 365  // optional, null for no expiration

Response

  "success": true,

  "data": {

    "id": "key_abc123",

    "name": "Production Key",

    "key": "snipara_ic_a1b2c3d4...",  // ONLY shown once!

    "keyPrefix": "snipara_ic_a1b2",

    "expiresAt": "2027-02-19T00:00:00Z"

Save the API Key

The full API key is only returned once during creation. Store it securely and provide it to your client.

Revoke API Key

DELETE /api/integrator/clients/:clientId/api-keys/:keyId

Webhooks

Configure a webhook URL in your workspace to receive real-time notifications about client lifecycle events.

Events

Event	Trigger
`client.created`	New client added to workspace
`client.updated`	Client details changed (name, email, bundle, status)
`client.deleted`	Client removed from workspace
`api_key.created`	New API key generated for a client
`api_key.revoked`	API key revoked

Payload Format

  "event": "client.created",

  "timestamp": "2026-02-19T15:30:00Z",

  "workspace_id": "ws_abc123",

  "data": {

    "client_id": "client_456",

    "name": "Client A",

    "email": "admin@clienta.com",

    "bundle": "STANDARD",

    "project_id": "proj_789",

    "project_slug": "acme-client-a"

Signature Verification

If you configure a webhook secret, all deliveries include an X-Snipara-Signature header for verification:

X-Snipara-Signature: sha256=abc123...

Verify using HMAC-SHA256:

import crypto from "crypto";

function verifyWebhook(payload: string, signature: string, secret: string): boolean {

  const expected = "sha256=" + crypto.createHmac("sha256", secret).update(payload).digest("hex");

  return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));

Bundle Limit Enforcement

When a client exceeds their bundle limits, the MCP API returns a 429 error:

  "success": false,

  "error": {

    "code": "BUNDLE_LIMIT_EXCEEDED",

    "message": "Monthly query limit exceeded",

    "limit": 500,

    "current": 201,

    "reset_at": "2026-03-01T00:00:00Z"

Enforced Limits

Limit	Enforcement Point
Queries/month	Every MCP tool call
Memories	`rlm_remember` tool
Swarms	`rlm_swarm_create` tool
Agents/swarm	`rlm_swarm_join` tool
Documents	Document upload endpoints
Storage	File upload size validation

Client API Key Usage

Once you provide a client with their snipara_ic_* API key, they can use it with any MCP-compatible client.

Claude Code Configuration

// .mcp.json

  "mcpServers": {

    "snipara": {

      "type": "http",

      "url": "https://api.snipara.com/mcp/{project_slug}",

      "headers": {

        "X-API-Key": "snipara_ic_..."

The project_slug is automatically set when you create the client (format: {workspace_slug}-{client_name}).

Error Responses

Status	Code	Description
400	`BAD_REQUEST`	Invalid request body or parameters
401	`UNAUTHORIZED`	Missing or invalid authentication
403	`FORBIDDEN`	Not an approved integrator
404	`NOT_FOUND`	Workspace, client, or key not found
409	`CONFLICT`	Duplicate email, external_id, or slug
429	`CLIENT_LIMIT_EXCEEDED`	Tier client limit reached
500	`INTERNAL_ERROR`	Server error

Next Steps

Partner Program

Learn about tiers, pricing, and apply to become a partner.

REST API Reference

Standard API for projects and documents.

MCP Tools Reference

Context-optimized query tools.

Integration Guide

Set up Snipara with Claude, Cursor, VS Code, and more.