POSTReviewedv1
Submit a governed analytical question
The contract does not accept raw SQL or tenant selection from prompt text. The server creates a semantic plan over certified metrics.
https://bi.foodtech-pos.com/api/v1/ai/questionsContract state: Reviewed
A path is not a production contract until it is marked verified and matches the runtime source.
Authentication
AuthenticationSigned SSO session or authorized service token
Required scopebusiness · branch · permission
Environmenthttps://bi.foodtech-pos.com
Last reviewedJuly 16, 2026
Headers
AuthorizationRequiredIdentity scheme depends on embedded or service mode.
Idempotency-KeyOptionalRecommended for metered asynchronous variants.
Request example
Send a natural-language question and non-sensitive presentation context; field names await the published schema.
{
"question": "<natural-language-question>",
"locale": "ar"
}Response example
The answer must identify metrics, period, quality, and audit trace without claiming data that was not retrieved.
{
"answer": "<governed-answer>",
"correlation_id": "<opaque-id>",
"quality": "<certified-quality-state>"
}