Skip to main content
POST
/
models
/
{handle}
/
samples
cURL
curl -X POST https://u22a8.ai/v1/models/acme.support-tone/samples \
  -H "Authorization: Bearer $U22A8_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"samples": [{"trait": "warmth", "text": "Happy to help — let us sort this out together.", "quality": 1.0}, {"trait": "warmth", "text": "Request denied. Refer to the policy.", "quality": 0.0}]}'
{
  "ids": [
    123
  ]
}

Documentation Index

Fetch the complete documentation index at: https://u22a8-police-sweep-2026-06-01.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Each sample labels one trait: quality 1.0 is the positive pole, 0.0 the negative. Up to 500 samples per request.
Draft-only — trait and sample edits apply only while the model is in the draft state. A trained (ready) model returns 409; the samples and traits are frozen into its versions.

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"

Body

application/json
​
samples
SampleInput · object[]
required
Required array length: 1 - 500 elements

Response

Successful Response

​
ids
integer[]
required