Behaviour Specs

A behaviour spec is the core entity in Tuned Tensor — a structured description of the model behaviour you want to achieve.

The Behaviour Spec Object

{
  "id": "cafd8799-9180-482e-b0b2-c46d08e4b045",
  "name": "Customer Support Bot",
  "description": "Handles billing and support questions",
  "system_prompt": "You are a helpful support agent...",
  "guidelines": ["Be concise", "Show empathy"],
  "constraints": ["Never promise refunds"],
  "examples": [
    { "input": "How do I cancel?", "output": "Go to Settings > Billing..." }
  ],
  "base_model": "meta-llama/Llama-3.2-3B-Instruct",
  "created_at": "2026-03-06T08:27:33.492Z",
  "updated_at": "2026-03-06T08:27:33.492Z"
}

Field	Type	Description
`id`	UUID	Unique identifier
`name`	string	Human-readable name (1–255 chars)
`description`	string	Purpose of the spec
`system_prompt`	string	System message that sets the model's persona
`guidelines`	string[]	Rules the model should follow (max 50)
`constraints`	string[]	Things the model must not do (max 50)
`examples`	{input, output}[]	Training examples (1–500)
`base_model`	string	Model to fine-tune

Create a Behaviour Spec

POST /api/v1/behavior-specs

curl -X POST https://api.tunedtensor.com/v1/behavior-specs \
  -H "Authorization: Bearer tt_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Customer Support Bot",
    "system_prompt": "You are a helpful support agent...",
    "guidelines": ["Be concise"],
    "constraints": ["Never promise refunds"],
    "examples": [
      {"input": "How do I cancel?", "output": "Go to Settings > Billing..."}
    ],
    "base_model": "meta-llama/Llama-3.2-3B-Instruct"
  }'

Required: name, examples (at least 1). Optional: description, system_prompt, guidelines, constraints, base_model (defaults to Llama 3.2 3B).

List Behaviour Specs

GET /api/v1/behavior-specs

curl https://api.tunedtensor.com/v1/behavior-specs \
  -H "Authorization: Bearer tt_your_api_key"

Returns a paginated list. Each spec includes _run_count, _latest_run_status, and _latest_run_score.

Get a Behaviour Spec

GET /api/v1/behavior-specs/:id

curl https://api.tunedtensor.com/v1/behavior-specs/cafd8799-... \
  -H "Authorization: Bearer tt_your_api_key"

Returns the full spec plus _runs array and _run_count.

Update a Behaviour Spec

PUT /api/v1/behavior-specs/:id

curl -X PUT https://api.tunedtensor.com/v1/behavior-specs/cafd8799-... \
  -H "Authorization: Bearer tt_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "examples": [
      ...existing examples...,
      {"input": "New question", "output": "New answer"}
    ]
  }'

All fields are optional. Only included fields are updated. When updating examples, send the full array.

Delete a Behaviour Spec

DELETE /api/v1/behavior-specs/:id

curl -X DELETE https://api.tunedtensor.com/v1/behavior-specs/cafd8799-... \
  -H "Authorization: Bearer tt_your_api_key"

Cascade-deletes all associated runs and eval results.