Skip to main content
POST
/
v1
/
scorecard-templates
Create scorecard template
curl --request POST \
  --url https://api.stardex.ai/v1/scorecard-templates \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "rating_scale": 5,
  "enable_ai_auto_grade": false,
  "overall_default_text": "<string>",
  "team_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "criteria": [
    {
      "name": "<string>",
      "description": "<string>",
      "importance": "nice_to_have",
      "position": 123,
      "default_text": "<string>"
    }
  ]
}
'
{
  "success": true,
  "data": {
    "id": "aaaa1111-2222-3333-4444-555555555555",
    "name": "Senior Backend Engineer Scorecard",
    "description": "Interview rubric for senior backend engineering candidates.",
    "job_id": "456e7890-e12b-34d5-a678-901234567890",
    "rating_scale": 5,
    "enable_ai_auto_grade": false,
    "is_archived": false,
    "overall_default_text": "Summarize the candidate against the must-have criteria first, then list any concerns.",
    "created_by": {
      "id": "567e8901-e23c-45d6-e789-012345678901",
      "first_name": "Jane",
      "last_name": "Smith"
    },
    "created_at": "2026-05-20T10:00:00Z",
    "updated_at": "2026-05-20T10:00:00Z",
    "criteria": [
      {
        "id": "bbbb1111-2222-3333-4444-555555555555",
        "name": "System design depth",
        "description": "Can the candidate reason about consistency, partitioning, and failure modes for a multi-region service?",
        "importance": "must_have",
        "position": 1,
        "is_archived": false,
        "default_text": "Note specific systems they have built, scale handled, and trade-offs discussed."
      },
      {
        "id": "cccc1111-2222-3333-4444-555555555555",
        "name": "Async collaboration",
        "description": "Quality of written communication and decision logs.",
        "importance": "nice_to_have",
        "position": 2,
        "is_archived": false,
        "default_text": null
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Authenticate with a Bearer token: API key, OAuth token, or session token.

Body

application/json
​
name
string
required

Template name shown to raters (required).

Minimum string length: 1
​
description
string

Optional template description.

​
job_id
string<uuid>

Job UUID to scope this template to. Only one active template can exist per job. Omit to create an org-wide template.

​
rating_scale
integer
default:5

Star rating scale. Must be one of: 3, 4, 5 (default), or 10.

​
enable_ai_auto_grade
boolean
default:false

When true, the AI copilot can auto-grade candidates against this template. Defaults to false.

​
overall_default_text
string

Default note text pre-filled in the overall summary section. Plain text only.

​
team_member_id
string<uuid>

Team member UUID to record as the template creator. Defaults to the caller. Required when the caller is authenticated with an API key (no team member context).

​
criteria
object[]

Criteria to attach to the template. Each criterion has a name and optional description, importance, position, and default_text. When position is omitted, criteria are numbered in the order provided.

Response

Scorecard template created

​
success
enum<boolean>
required
Available options:
true
​
data
object
required