Skip to main content

​
Get Profile

GET /user/profile 
curl -X GET "https://api.buildwithtrace.com/api/v2/user/profile" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "id": "uuid",
  "email": "user@example.com",
  "full_name": "John Doe",
  "plan": "pro",
  "avatar_url": "https://...",
  "created_at": "2025-01-01T00:00:00Z"
}

​
Update Profile

PUT /user/profile 
curl -X PUT "https://api.buildwithtrace.com/api/v2/user/profile" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"full_name": "Jane Doe"}'
Upload avatar via multipart form (5MB max): 
curl -X PUT "https://api.buildwithtrace.com/api/v2/user/profile" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "avatar=@photo.jpg"

​
Get Statistics

GET /user/stats 
curl -X GET "https://api.buildwithtrace.com/api/v2/user/stats" \
  -H "Authorization: Bearer YOUR_TOKEN"
Returns conversation count, message count, and token usage.

​
Get Quota

GET /user/quota 
curl -X GET "https://api.buildwithtrace.com/api/v2/user/quota" \
  -H "Authorization: Bearer YOUR_TOKEN"
Returns your current quota status including remaining messages and token limits.

​
Get Activity

GET /user/activity Returns your recent activity feed.

​
Get Usage History

GET /user/usage Returns per-request token counts and costs.