Get one trait

One trait’s metadata. Includes its kind and, for discovered (intrinsic) traits, the discovery diagnostics — discrimination, explained_variance, and anchor_sample_ids. key matches by trait key or name.

GET /models/{handle}/traits/{key}

cURL

cURL

curl https://u22a8.ai/v1/models/acme.support-tone/traits/warmth \
  -H "Authorization: Bearer $U22A8_API_KEY"

200

{
  "key": "<string>",
  "name": "<string>",
  "positive_label": "<string>",
  "negative_label": "<string>",
  "sample_count": 123,
  "positive_samples": 123,
  "negative_samples": 123,
  "description": "",
  "kind": "extrinsic",
  "discrimination": 123,
  "explained_variance": 123,
  "anchor_sample_ids": {}
}

Authorizations

Authorization · string · header · required

API key issued in the platform console, sent as Authorization: Bearer <key>.

Path Parameters

handle · string · required

Model handle, e.g. 'u22a8.technical-writing'.

Example:

"u22a8.technical-writing"

key · string · required

Response

200

application/json

Successful Response

key · string · required

Example:

"clarity_and_simplicity"

name · string · required

Example:

"Clarity and Simplicity"

positive_label · string · required

Example:

"Clear"

negative_label · string · required

Example:

"Obscure"

sample_count · integer · required

Example:

20

positive_samples · integer · required

Example:

10

negative_samples · integer · required

Example:

10

description · string · default: ""

kind · string · default: extrinsic

How the trait is defined: extrinsic (taught directly by labelled samples; its axis is re-derived on every train) or intrinsic (the axis itself is the trait, produced by discovery and held fixed across retrains).

Example:

"extrinsic"

discrimination · number | null

Discriminator strength in [0, 1] for discovered traits (1.0 = perfect separation, 0.5 = chance). Null for authored.

explained_variance · number | null

Fraction of variance the intrinsic axis explains. Null for extrinsic traits.

anchor_sample_ids · Anchor Sample Ids · object

Positive/negative exemplar sample ids anchoring an intrinsic axis ({positive: [...], negative: [...]}). Null for extrinsic.