Session Scores

GET

sessions

:id

scores

curl https://api.promptster.ai/v1/sessions/sess_abc123/scores \
  -H "Authorization: Bearer psk_live_abc123def456"

curl -X POST https://api.promptster.ai/v1/sessions/sess_abc123/scores \
  -H "Authorization: Bearer psk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "dimension": "problem_decomposition",
      "score": 4,
      "notes": "Good breakdown of the problem into subtasks."
    },
    {
      "dimension": "ai_orchestration",
      "score": 5
    }
  ]'

{
  "scores": [
    {
      "id": "sc_abc123",
      "sessionId": "sess_abc123",
      "orgId": "org_2abc123",
      "dimension": "problem_decomposition",
      "score": 4,
      "notes": "Good breakdown of the problem into subtasks.",
      "reviewerId": "user_xyz",
      "createdAt": "2026-04-07T11:00:00.000Z",
      "updatedAt": "2026-04-07T11:00:00.000Z"
    },
    {
      "id": "sc_def456",
      "sessionId": "sess_abc123",
      "orgId": "org_2abc123",
      "dimension": "ai_orchestration",
      "score": 5,
      "notes": null,
      "reviewerId": "user_xyz",
      "createdAt": "2026-04-07T11:00:00.000Z",
      "updatedAt": "2026-04-07T11:00:00.000Z"
    }
  ],
  "prompterScore": null
}

Get Scores

GET /v1/sessions/:id/scores

Retrieves all reviewer rubric scores for a session, plus the computed Prompter Score if available.

Submit Scores

POST /v1/sessions/:id/scores

Submit or update rubric scores for a session. Scores are upserted per dimension — submitting a score for a dimension that already has one will update it.

Authentication

Requires either an org API key or a candidate key.

Authorization: Bearer psk_live_...

string

required

The session ID.

POST Body

The request body is an array of score objects (1 to 5 items).

string

required

Score dimension. One of: problem_decomposition, ai_orchestration, code_quality, debugging_process, communication.

integer

required

Score value from 1 to 5.

string

Optional reviewer notes for this dimension.

GET Response

array

List of rubric score objects.

Show properties

string

Score record ID.

string

Session ID.

string

Score dimension.

integer

Score value (1-5).

string | null

Reviewer notes.

string | null

ID of the reviewer who submitted.

string

ISO 8601 timestamp.

string

ISO 8601 timestamp.

object | null

The computed Prompter Score artifact, or null if not yet computed.

{
  "scores": [
    {
      "id": "sc_abc123",
      "sessionId": "sess_abc123",
      "orgId": "org_2abc123",
      "dimension": "problem_decomposition",
      "score": 4,
      "notes": "Good breakdown of the problem into subtasks.",
      "reviewerId": "user_xyz",
      "createdAt": "2026-04-07T11:00:00.000Z",
      "updatedAt": "2026-04-07T11:00:00.000Z"
    },
    {
      "id": "sc_def456",
      "sessionId": "sess_abc123",
      "orgId": "org_2abc123",
      "dimension": "ai_orchestration",
      "score": 5,
      "notes": null,
      "reviewerId": "user_xyz",
      "createdAt": "2026-04-07T11:00:00.000Z",
      "updatedAt": "2026-04-07T11:00:00.000Z"
    }
  ],
  "prompterScore": null
}

{
  "scores": [
    {
      "id": "sc_abc123",
      "sessionId": "sess_abc123",
      "orgId": "org_2abc123",
      "dimension": "problem_decomposition",
      "score": 4,
      "notes": "Good breakdown of the problem into subtasks.",
      "reviewerId": "user_xyz",
      "createdAt": "2026-04-07T11:00:00.000Z",
      "updatedAt": "2026-04-07T11:00:00.000Z"
    }
  ]
}

curl https://api.promptster.ai/v1/sessions/sess_abc123/scores \
  -H "Authorization: Bearer psk_live_abc123def456"

curl -X POST https://api.promptster.ai/v1/sessions/sess_abc123/scores \
  -H "Authorization: Bearer psk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "dimension": "problem_decomposition",
      "score": 4,
      "notes": "Good breakdown of the problem into subtasks."
    },
    {
      "dimension": "ai_orchestration",
      "score": 5
    }
  ]'

curl https://api.promptster.ai/v1/sessions/sess_abc123/scores \
  -H "Authorization: Bearer psk_live_abc123def456"

curl -X POST https://api.promptster.ai/v1/sessions/sess_abc123/scores \
  -H "Authorization: Bearer psk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "dimension": "problem_decomposition",
      "score": 4,
      "notes": "Good breakdown of the problem into subtasks."
    },
    {
      "dimension": "ai_orchestration",
      "score": 5
    }
  ]'

{
  "scores": [
    {
      "id": "sc_abc123",
      "sessionId": "sess_abc123",
      "orgId": "org_2abc123",
      "dimension": "problem_decomposition",
      "score": 4,
      "notes": "Good breakdown of the problem into subtasks.",
      "reviewerId": "user_xyz",
      "createdAt": "2026-04-07T11:00:00.000Z",
      "updatedAt": "2026-04-07T11:00:00.000Z"
    },
    {
      "id": "sc_def456",
      "sessionId": "sess_abc123",
      "orgId": "org_2abc123",
      "dimension": "ai_orchestration",
      "score": 5,
      "notes": null,
      "reviewerId": "user_xyz",
      "createdAt": "2026-04-07T11:00:00.000Z",
      "updatedAt": "2026-04-07T11:00:00.000Z"
    }
  ],
  "prompterScore": null
}

Get Started

Understanding Sessions

Guides

API Reference

Assessments

Keys

Sessions

Candidates

Analytics

Problem Library

Hooks

Branding

Webhooks

Resources

Get Scores

Submit Scores

Authentication

POST Body

GET Response

​Get Scores

​Submit Scores

​Authentication

​POST Body

​GET Response

Get Scores

Submit Scores

Authentication

POST Body

GET Response