Triplit System API
Server health, version, and administrative endpoints
Server health, version, and administrative endpoints
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/triplit-system-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Triplit HTTP Advanced System API
description: RESTful HTTP API for interacting with a Triplit sync server. Supports fetch, insert, bulk-insert, update, delete, delete-all, schema, stats, clear, and healthcheck operations. Authenticated via JWT Bearer tokens (Service or Anonymous tokens). Base URL follows the pattern https://<project-id>.triplit.io.
version: 1.0.0
contact:
name: Triplit
url: https://www.triplit.dev
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0
servers:
- url: https://{projectId}.triplit.io
description: Triplit Cloud sync server
variables:
projectId:
description: Your Triplit project ID
default: your-project-id
- url: http://localhost:6543
description: Local development server
security:
- BearerAuth: []
tags:
- name: System
description: Server health, version, and administrative endpoints
paths:
/healthcheck:
get:
operationId: healthcheck
summary: Health check
description: Returns 200 OK if the server is running. Does not require authentication.
security: []
tags:
- System
responses:
'200':
description: Server is healthy
content:
text/plain:
schema:
type: string
example: OK
/version:
get:
operationId: getVersion
summary: Get server version
description: Returns the server version string.
security: []
tags:
- System
responses:
'200':
description: Server version
content:
text/plain:
schema:
type: string
example: 1.0.0
/stats:
post:
operationId: getStats
summary: Get collection statistics
description: Returns entity count statistics for all collections. Requires a service (admin) token.
tags:
- System
responses:
'200':
description: Collection statistics
content:
application/json:
schema:
$ref: '#/components/schemas/CollectionStats'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
/clear:
post:
operationId: clearDatabase
summary: Clear the database
description: 'Clears all data from the database. Pass `full: true` to perform a complete reset including metadata. Requires a service (admin) token.'
tags:
- System
requestBody:
required: false
content:
application/json:
schema:
type: object
properties:
full:
type: boolean
description: If true, performs a full reset including metadata; otherwise only clears user data
default: false
responses:
'200':
description: Database cleared
content:
application/json:
schema:
type: object
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
components:
responses:
Forbidden:
description: Service key (admin token) required for this operation
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Unauthorized:
description: Missing or invalid authentication token
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
schemas:
ErrorResponse:
type: object
properties:
name:
type: string
description: Error type name
example: TriplitError
message:
type: string
description: Human-readable error description
example: No token provided
status:
type: integer
description: HTTP status code
example: 401
CollectionStats:
type: array
description: Statistics for each collection
items:
type: object
properties:
collection:
type: string
description: Collection name
example: todos
numEntities:
type: integer
description: Number of entities in the collection
example: 42
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: JWT Bearer token. Use a Service Token (secret) for admin operations or an Anonymous token for standard user operations.