API Documentation

curl -X POST https://tonos.fyi/keys \
  -H "Authorization: Bearer tnos_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"label": "production-server"}'

{
  "id": "key_abc123",
  "plaintext": "tnos_live_abc123def456...",
  "prefix": "tnos_live_abc1"
}

curl https://tonos.fyi/keys \
  -H "Authorization: Bearer tnos_live_YOUR_KEY"

{
  "keys": [
    {
      "id": "key_abc123",
      "key_prefix": "tnos_live_abc1",
      "label": "production-server",
      "last_used_at": "2026-04-01T12:00:00Z",
      "revoked": false,
      "created_at": "2026-03-15T08:30:00Z"
    }
  ]
}

curl -X DELETE https://tonos.fyi/keys/key_abc123 \
  -H "Authorization: Bearer tnos_live_YOUR_KEY"

{"revoked": true}

curl https://tonos.fyi/keys/key_abc123/usage \
  -H "Authorization: Bearer tnos_live_YOUR_KEY"

{
  "total_calls": 142,
  "endpoints": [
    {"endpoint": "generation", "call_count": 98},
    {"endpoint": "extraction:profile", "call_count": 44}
  ]
}

curl -X POST https://tonos.fyi/profile \
  -H "Authorization: Bearer tnos_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "samples": [
      {"text": "hey just checking in, lmk if you need anything from my end"},
      {"text": "sounds good, i can hop on a call tomorrow if easier"},
      {"text": "perfect, will send over the updated deck by eod. no rush"}
    ]
  }'

{
  "profile_id": "prof_abc123",
  "voice": {
    "formality": {"value": 2.1, "confidence": 0.85},
    "directness": {"value": 8.6, "confidence": 0.90},
    "warmth": {"value": 7.4, "confidence": 0.82},
    "summary": "Casual, direct communicator who defaults to lowercase...",
    ...
  },
  "confidence": 0.78,
  "confidence_label": "high",
  "tokens_used": 1847
}

curl https://tonos.fyi/profile/prof_abc123 \
  -H "Authorization: Bearer tnos_live_YOUR_KEY"

{
  "profile_id": "prof_abc123",
  "voice": { ... },
  "confidence": 0.78,
  "confidence_label": "high",
  "version": 2,
  "extracted_at": "2026-04-01T12:00:00Z"
}

curl -X DELETE https://tonos.fyi/profile/prof_abc123 \
  -H "Authorization: Bearer tnos_live_YOUR_KEY"

{"deleted": true}

curl -X POST https://tonos.fyi/profile/prof_abc123/samples \
  -H "Authorization: Bearer tnos_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "samples": [
      {"text": "thanks for the quick turnaround on this, really appreciate it"},
      {"text": "just a heads up, i might be a few minutes late to the standup"}
    ]
  }'

{
  "profile_id": "prof_abc123",
  "voice": { ... },
  "confidence": 0.84,
  "confidence_label": "high",
  "tokens_used": 2105
}

curl -X POST "https://tonos.fyi/generate/draft?stream=false" \
  -H "Authorization: Bearer tnos_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "prof_abc123",
    "recipient": "Sarah",
    "purpose": "Follow up on partnership proposal",
    "key_points": [
      "Check if she reviewed the proposal",
      "Offer to hop on a call to discuss"
    ],
    "platform": "email"
  }'

{
  "text": "hey sarah, wanted to circle back on the proposal i sent over last week. no pressure at all, just wondering if you've had a chance to look through it. happy to jump on a quick call if that's easier. let me know",
  "profile_id": "prof_abc123",
  "tokens_used": 312
}

curl -X POST "https://tonos.fyi/generate/rewrite?stream=false" \
  -H "Authorization: Bearer tnos_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "prof_abc123",
    "source_text": "Dear Sarah, I hope this email finds you well. I wanted to follow up regarding our previous conversation about the partnership opportunity. Please let me know your thoughts at your earliest convenience.",
    "platform": "email"
  }'

{
  "text": "hey sarah, just circling back on the partnership thing we talked about. would love to hear what you're thinking whenever you get a chance. no rush",
  "profile_id": "prof_abc123",
  "tokens_used": 287
}