Skip to content
TruthVouch Docs

Platform API Reference

Platform Management API — Coming Soon

The Platform Management API for organizations, billing, and subscription management is currently in development and will be available in Q2 2026.

Cache Management API (Professional+)

Manage your organization’s LLM response cache. Requires Admin or Superadmin role and Professional tier or above.

Get Cache Statistics

GET /api/v1/cache/stats

Returns cache entry count, estimated memory usage, 24-hour hit rate, and connection status.

Response:

{
  "entryCount": 142,
  "estimatedMemoryBytes": 2400000,
  "hitRate24h": 87.3,
  "status": "connected"
}

Get Cache Policy

GET /api/v1/cache/policy

Returns current cache TTL and auto-invalidation settings.

Response:

{
  "ttlSeconds": 3600,
  "autoInvalidate": true
}

Update Cache Policy

PUT /api/v1/cache/policy

Request Body:

{
  "ttlSeconds": 21600,
  "autoInvalidate": true
}

ttlSeconds must be between 300 (5 minutes) and 604800 (7 days). Returns 400 if out of range.

Clear Cached Responses

DELETE /api/v1/cache/responses

Clears all cached LLM responses for your organization. Rate-limited to 10 clears per hour. Returns 204 on success, 429 with Retry-After header when rate limited.

Get Cache Activity

GET /api/v1/cache/activity?limit=10

Returns recent cache operations (clears, policy changes, auto-invalidations). limit parameter: 1–50, default 10.

Response:

[
  {
    "timestamp": "2026-04-15T14:15:00Z",
    "action": "Cache cleared (all)",
    "actorEmail": "[email protected]"
  }
]

Current Options

For now, manage your account and organization settings via:

Web Dashboard

Access all account management features in the TruthVouch web app:

  1. Go to app.truthvouch.com
  2. Settings → Manage your organization, members, API keys, billing
  3. Billing → View invoices, change plans, update payment methods

REST API

Use the existing REST APIs for programmatic access:

When It’s Available

When the Platform Management API is released (Q2 2026), you’ll be able to:

  • Create and manage organizations programmatically
  • Invite and manage team members
  • Update subscription and billing details
  • Query usage and quotas
  • Manage API keys and integrations

Check back here for updates, or contact support if you need these capabilities urgently.