Quickstart

This guide walks you through creating a Personal Access Token and making your first API call.

Prerequisites

• A Tholos account with at least one organization
• Access to the Tholos Dashboard

Setup

1. Create a Personal Access Token

   Go to Settings > Account > Advanced in the Tholos Dashboard. Click Create Token, give it a descriptive name, and optionally set an expiration date.

   Copy the token immediately — it is only shown once. The token will look like tholos_pat_abc123...

2. Store the token securely

   Save your token in an environment variable:

   export THOLOS_API_TOKEN="tholos_pat_your_token_here"

3. Make your first request — verify your token works by fetching your user profile (see examples below).

4. List your vaults — fetch the vaults in your organization (see examples below).

Verify your token

cURL

curl https://api.tholos.app/user/me \
  -H "Authorization: Bearer $THOLOS_API_TOKEN"

JavaScript

const response = await fetch("https://api.tholos.app/user/me", {
  headers: {
    Authorization: `Bearer ${process.env.THOLOS_API_TOKEN}`,
  },
});
const data = await response.json();
console.log(data);

Python

import httpx

response = httpx.get(
"https://api.tholos.app/user/me",
headers={"Authorization": f"Bearer {os.environ['THOLOS_API_TOKEN']}"},
)
print(response.json())

You should get back your user profile with your id, email, and organizations.

List your vaults

cURL

curl https://api.tholos.app/organization/{organizationId}/vaults \
-H "Authorization: Bearer $THOLOS_API_TOKEN"

JavaScript

const response = await fetch(
  "https://api.tholos.app/organization/123/vaults",
  {
    headers: {
      Authorization: `Bearer ${process.env.THOLOS_API_TOKEN}`,
    },
  },
);
const data = await response.json();
console.log(data);

Python

response = httpx.get(
    "https://api.tholos.app/organization/123/vaults",
    headers={"Authorization": f"Bearer {os.environ['THOLOS_API_TOKEN']}"},
)
print(response.json())

Next steps

• Authentication — understand all authentication methods
• Core Concepts — learn about organizations, vaults, and transactions
• Generate an SDK — generate a type-safe client for your language
• API Reference — browse the full API