Skip to main content

Templates & Settings API

Template routers

Four template types share one CRUD shape. UI: Templates & Presets.

PrefixTemplate type
/api/v1/training-templatesSAE training configurations
/api/v1/extraction-templatesFeature-extraction configurations
/api/v1/labeling-prompt-templatesLabeling prompt/system templates
/api/v1/prompt-templatesSteering prompt sets (multi-prompt)

Common endpoints (all four routers):

MethodPathDescription
POST``Create (201)
GET``List (search + pagination)
GET/{id}Get one
PATCH/{id}Update
DELETE/{id}Delete
POST/exportExport selected templates as JSON
POST/importImport templates from JSON

Router-specific additions:

  • training-, extraction-, prompt-templates: GET /favorites, POST /{id}/favorite
  • prompt-templates: POST /{id}/duplicate
  • labeling-prompt-templates: GET /default, POST /{id}/set-default, POST /{id}/clone, GET /{id}/usage-count

Settings — prefix /api/v1/settings

DB-backed application settings. UI: Settings Reference.

MethodPathDescription
GET``List settings (sensitive values returned masked)
GET/{key}Get one setting
PUT``Upsert a setting — body: {key, value, is_sensitive, category}. Sensitive values are AES-256-GCM encrypted at rest
PUT/bulkUpsert several settings at once
DELETE/{key}Remove a setting (204)

PIN protection

MethodPathDescription
GET/pin/status{configured, bypass_active} — whether a PIN is set and whether MISTUDIO_BYPASS_PIN is active
POST/pin/verifyVerify an entered PIN (PBKDF2-SHA256)
POST/pin/setSet or reset the PIN