EndpointsCoaching Sessions
Start coaching analysis
POST
/v2/coaching-sessions/{coaching_session_id}/analysesQueues another paid synthesis of a finished session, for example after a failed run. One analysis runs at a time per session, and a retry with the same key returns the original.
Authorization
BearerAuth AuthorizationBearer <token>
Bearer token issued by Softmax
In: header
Path Parameters
coaching_session_id*Coaching Session Id
Coaching session to analyze.
Match
^csn_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$Request Body
application/json
idempotency_key*Idempotency Key
Caller-chosen key; a retry with the same key returns the original analysis.
Length
1 <= length <= 200curl -X POST "https://softmax.com/api/observatory/v2/coaching-sessions/string/analyses" \ -H "Content-Type: application/json" \ -d '{ "idempotency_key": "string" }'{ "id": "string", "provider": "string", "model": "string", "prompt_version": "string", "status": "queued", "phase": "string", "upload_percent": 0, "usage_usd": 0, "error": "string", "created_at": "2019-08-24T14:15:22Z", "completed_at": "2019-08-24T14:15:22Z", "plan": { "provider": "gemini", "model": "gemini-3.8-flash", "prompt_version": "coaching-evidence-v8", "source_sha256": "string", "duration_ms": 0, "transport": "inline", "compact_video": true, "layers": [ "string" ], "max_output_tokens": 65536, "max_context_bytes": 1048576, "analysis_passes": 2, "synthesis": "Covers every distinct supported coaching idea, with semantic reasoning, dependencies and tests. No fixed number of suggestions or moments.", "upload": "string", "storage": "string" }, "result": { "summary": "string", "moments": [ { "start_ms": 0, "end_ms": 0, "tick_start": 0, "tick_end": 0, "observation": "string", "coaching_intent": "string", "uncertainty": "string", "evidence_ids": [ "string" ] } ], "ir_proposals": [ { "layer": "string", "change": "string", "rationale": "string", "verification": "string", "evidence_ids": [ "string" ] } ], "questions": [ "string" ], "transcript": [ { "start_ms": 0, "end_ms": 0, "text": "string" } ] }, "calls": [ { "endpoint": "string", "pass_name": "initial", "id": "string", "requested_model": "string", "returned_model": "string", "status": "string", "usage": {}, "request_sha256": "string", "name": "string", "sha256": "string", "bytes": 0 } ], "remote_file": { "name": "string", "cleanup": "pending" }, "api_error": { "http_status": 0, "kind": "server", "quota": { "tier": "free", "unit": "requests", "limit": 0 } }}