---
title: "Score program importance"
method: PUT
path: "/v1/admin/importance"
tags: ["Admin"]
---

# Score program importance

`PUT /v1/admin/importance`

## Request

- Base URL: `http://api.technooptimist.io`
- URL: `http://api.technooptimist.io/v1/admin/importance`
- Auth: HTTP bearer

One score or an array (≤100). The five 0–5 dimensions (leap, reach, economy, lead, people) + `reason` (+ `doubtful` for the owner's cut list); the 0–100 score is computed server-side. `version` must equal the current rubric version (409 otherwise). `override` (pin a 0–100 score, null clears) is for admins, not routines. `?dry=1` computes without writing (calibration).

## Query parameters

- `dry` '1' | 'true': Calibration: validate and compute the scores, write nothing

## Headers

- `x-routine-name` string: Name of the routine making the write; recorded as `routine:<name>` in the audit log.

## Request body

- union
  - object
    - `company` string, required
    - `program` string, required
    - `dims` object, required
      - `leap` integer, required
      - `reach` integer, required
      - `economy` integer, required
      - `lead` integer, required
      - `people` integer, required
    - `reason` string, required
    - `doubtful` string
    - `version` integer, required
    - `override` integer, nullable
  - object[]
    - `company` string, required
    - `program` string, required
    - `dims` object, required
      - `leap` integer, required
      - `reach` integer, required
      - `economy` integer, required
      - `lead` integer, required
      - `people` integer, required
    - `reason` string, required
    - `doubtful` string
    - `version` integer, required
    - `override` integer, nullable

## Response `200`

Scored

- object
  - `ok` true, required
  - `results` object[], required

## Other responses

- `401`: Missing or invalid credentials
- `403`: Credential lacks the required scope
- `404`: Not found
- `409`: Conflict
- `422`: Validation failed

---

[API](https://skmtc.dev/technooptimist/apis/the-techno-optimist-api.md) · [All operations](https://skmtc.dev/technooptimist/apis/the-techno-optimist-api/llms.txt) · [OpenAPI document](https://skmtc.dev/technooptimist/apis/the-techno-optimist-api/revisions/b7bcde6a0f30?raw)