Current User (Me)

GET /v1/me

{
  "id": "...",
  "username": "alice",
  "email": "alice@example.com",
  "email_verified": true,
  "email_verification_required": false,
  "created_at": "2024-01-01T00:00:00Z",
  "org_id": "...",
  "org_name": "Acme Corp",
  "role": "admin",
  "permissions": ["data.threads.read", "data.threads.manage"]
}

PATCH /v1/me

{ "username": "new_name" }

GET /v1/me/usage

{
  "org_id": "...",
  "year": 2024,
  "month": 1,
  "total_input_tokens": 100000,
  "total_output_tokens": 50000,
  "total_cost_usd": 0.15,
  "record_count": 42
}

GET /v1/me/usage/daily

[
  {
    "date": "2024-01-01",
    "input_tokens": 1000,
    "output_tokens": 500,
    "cost_usd": 0.01,
    "record_count": 3
  }
]

GET /v1/me/usage/by-model

[
  {
    "model": "claude-3-5-sonnet",
    "input_tokens": 50000,
    "output_tokens": 25000,
    "cost_usd": 0.08,
    "record_count": 20
  }
]

GET /v1/me/credits

{
  "balance": 1000,
  "transactions": [
    {
      "id": "...",
      "org_id": "...",
      "amount": 100,
      "type": "credit",
      "reference_type": "admin_adjust",
      "reference_id": "...",
      "note": "Initial recharge",
      "thread_title": null,
      "created_at": "2024-01-01T00:00:00Z"
    }
  ]
}

GET /v1/me/invite-code

{
  "id": "...",
  "user_id": "...",
  "code": "ABC123",
  "max_uses": 10,
  "use_count": 2,
  "is_active": true,
  "created_at": "2024-01-01T00:00:00Z"
}

POST /v1/me/invite-code/reset

POST /v1/me/redeem

{
  "code": "PROMO2024",
  "type": "credits",
  "value": "100"
}