Sessions
Get Session Decisions
Retrieve all decision events captured during a session.
GET
/
v1
/
sessions
/
:id
/
decisions
curl https://api.promptster.ai/v1/sessions/sess_abc123/decisions \
-H "Authorization: Bearer psk_live_abc123def456"
{
"decisions": [
{
"id": "evt_dec123",
"sessionId": "sess_abc123",
"orgId": "org_2abc123",
"kind": "decision_event",
"ts": "2026-04-07T09:25:00.000Z",
"data": {
"title": "Chose useReducer over useState for complex state",
"context": "The component needed to manage multiple interdependent state values.",
"rationale": "useReducer provides more predictable state transitions and avoids the stale closure issues seen with useState.",
"chosenOption": "useReducer with typed actions",
"tradeoffs": "Slightly more boilerplate but better type safety and testability.",
"impactScore": 0.8,
"severity": "high",
"category": "architecture"
},
"createdAt": "2026-04-07T09:25:00.000Z"
}
]
}
Returns all decision events from a session’s timeline. Decisions are significant choices the candidate made during the assessment, captured by the CLI and optionally enriched by LLM analysis.
Authentication
Requires either an org API key or a candidate key.Authorization: Bearer psk_live_...
string
required
The session ID.
array
List of decision timeline event objects.
Show properties
Show properties
string
Event ID.
string
Session ID.
string
Always
decision_event.string
ISO 8601 timestamp of the decision.
{
"decisions": [
{
"id": "evt_dec123",
"sessionId": "sess_abc123",
"orgId": "org_2abc123",
"kind": "decision_event",
"ts": "2026-04-07T09:25:00.000Z",
"data": {
"title": "Chose useReducer over useState for complex state",
"context": "The component needed to manage multiple interdependent state values.",
"rationale": "useReducer provides more predictable state transitions and avoids the stale closure issues seen with useState.",
"chosenOption": "useReducer with typed actions",
"tradeoffs": "Slightly more boilerplate but better type safety and testability.",
"impactScore": 0.8,
"severity": "high",
"category": "architecture"
},
"createdAt": "2026-04-07T09:25:00.000Z"
}
]
}
curl https://api.promptster.ai/v1/sessions/sess_abc123/decisions \
-H "Authorization: Bearer psk_live_abc123def456"
curl https://api.promptster.ai/v1/sessions/sess_abc123/decisions \
-H "Authorization: Bearer psk_live_abc123def456"
{
"decisions": [
{
"id": "evt_dec123",
"sessionId": "sess_abc123",
"orgId": "org_2abc123",
"kind": "decision_event",
"ts": "2026-04-07T09:25:00.000Z",
"data": {
"title": "Chose useReducer over useState for complex state",
"context": "The component needed to manage multiple interdependent state values.",
"rationale": "useReducer provides more predictable state transitions and avoids the stale closure issues seen with useState.",
"chosenOption": "useReducer with typed actions",
"tradeoffs": "Slightly more boilerplate but better type safety and testability.",
"impactScore": 0.8,
"severity": "high",
"category": "architecture"
},
"createdAt": "2026-04-07T09:25:00.000Z"
}
]
}