Ask a grounded question
Answers a question about an account, user, feature, or portfolio from the workspace's existing signals. The endpoint returns `knows: false` instead of guessing when the bundle does not support an answer.
curl -X POST https://useatune.com/api/v1/understand \ -H "Authorization: Bearer <YOUR_API_KEY>" \ -H "Content-Type: application/json" \ -d '{ "entity": "account:acme", "question": "Why did this account go quiet?" }'Sign in to see this sample with your own workspace API key.
/api/v1/understandAnswers a question about an account, user, feature, or portfolio from
the workspace's existing signals. The endpoint returns knows: false
instead of guessing when the bundle does not support an answer.
Authorization
bearerAuth Workspace API key from Atune settings or onboarding.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/v1/understand" \ -H "Content-Type: application/json" \ -d '{ "entity": "account:acme", "question": "Why did this account go quiet?" }'{ "knows": true, "answer": "Acme's weekly active users fell from 8 to 2 after onboarding stalled.", "confidence": 0.72, "citations": [ { "signal": "account.health.trend", "value": "weekly active users fell from 8 to 2", "when": "2026-07-24T12:00:00.000Z" } ], "recommendedNext": "Ask Acme what blocked onboarding after the first report.", "signals": { "entity": "account:acme", "support": { "knows": true, "confidence": 0.72 } }}Ingest Segment messages POST
Accepts Segment-style `track`, `identify`, `group`, or batch payloads. Segment is a compatibility ingress path; after mapping, messages use the same internal ingest core as native Atune capture.
Next.js
The zero-config path on Next.js, how account detection works, and the escape hatch.