Your first API call,
in three steps.

Generate a read-only public token

From the Tramya app, open Account → API Keys and click “Create a token”. The token is shown only once - copy it and store it like a secret.

export TRAMYA_TOKEN="tra_pk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

A public token exposes only aggregated data (counts, titles, snippets) - never the full content of conversations. It can be rotated at any time.

Verify with curl

A ping to /workspace/status returns JSON with project / conversation / memory counts. If you get 200 OK, your token is good.

curl -sS -H "Authorization: Bearer $TRAMYA_TOKEN" \
  https://app.tramya.com/api/v1/public/workspace/status | jq

Choose your SDK

Three official clients, zero external transport dependencies.

npm install @tramya/sdk

import { TramyaClient } from '@tramya/sdk';
const tramya = new TramyaClient({ token: process.env.TRAMYA_TOKEN });
const status = await tramya.workspace.status();
console.log(status);

pip install tramya-sdk

from tramya_sdk import TramyaClient
client = TramyaClient(token="$TRAMYA_TOKEN")
print(client.workspace.status())

go get github.com/arthurferreira64/tramya/sdk/tramya-sdk-go

client, _ := tramya.NewClient(tramya.Config{Token: os.Getenv("TRAMYA_TOKEN")})
status, _ := client.Workspace.Status(ctx)
fmt.Printf("%+v\n", status)