Start a Situational assessment (async; LLM-augmented)

POST 
/v1/situational/assessments

Creates an async Situational assessment job. Accepts a profile (by subject_id or inline) plus a situation_context describing the situation being evaluated.

Returns 202 Accepted with a job in processing status. Final result delivered via webhook (situational.assessment.completed) or polling.

Production access requires Situational production application approval per ADR-012. Sandbox keys (test_*) work freely; production keys (live_*) require approval.

LLM cost: typically $0.50–$2 per assessment. Spend caps default-on per OPS-PLAYBOOK §7.

Request

Responses

202

Assessment job created; processing

403

Either insufficient scope OR Situational production access not yet approved.

For production-access denial: error_code: production_access_required with docs_url pointing to the application form.