Public API v1 | Read-only
Check your workspace
from anywhere.
7 REST endpoints to power an internal dashboard, a monitoring tool, or the Tramya Mobile app. Rotatable Bearer token authentication, rate-limited, with no private content exposed beyond a 200-character snippet.
Getting started
Three steps to your first request.
- Create a token in /admin, under "API keys v1." Choose its scopes (billing:read, cloud:read, workspace:read, projects:read) and copy the secret immediately - it will never be shown again.
- Pass it in a Bearer header:
Authorization: Bearer tra_pk_xxx. Thetra_pk_prefix is constant. The rest is random (192 bits). - Call the endpoints. See the reference below or download the OpenAPI spec to generate a client in your language.
Reference
7 endpoints, all read-only.
Active plan, unlocked features, Stripe catalog (masked IDs).
curl -H "Authorization: Bearer $TRAMYA_TOKEN" \ https://app.tramya.com/api/v1/public/billing/status
Cloud connection of the local companion, last backup, masked account ID.
Global stats: number of projects, conversations, messages, tokens, memories, checkpoints, sources.
Complete list of projects with name, description, counters. Without filesystem paths.
Metadata for recent conversations. Zero message content. Filters ?projectId= and ?limit= (1-100).
Saved memories, 200-character snippet, tags. Filters ?projectId= and ?limit=.
Full-text search across memories, checkpoints, and messages. Rate-limited to 30/min per token. Query minimum 2 characters. 200-char snippet.
curl -H "Authorization: Bearer $TRAMYA_TOKEN" \ "https://app.tramya.com/api/v1/public/search?q=stripe"
Security and limits
What you will never expose with this API.
- The full content of a conversation or a memory (never returned, only a 200-character snippet for
/searchand/memories). - Local filesystem paths (stripped from responses).
- Full Stripe IDs (masked: first 4 + last 4 characters).
- Secrets, cloud tokens, or session information.
To extract all of your data, use the local export from the Tramya app instead - the Public API v1 is not designed for that.