Evaluator methods: update, delete
The Evaluator Verbs update, delete as typed SDK methods, with inputs, result, refusals and an example.
Reference for Evaluator, one group of Evaluator methods.
Evaluator.update
Changes the given properties of an Evaluator. Verb page.
interface EvaluatorVerbs {
update(input: EvaluatorUpdateInput, options?: SB.CallOptions): SB.Call<Evaluator>
}Emits Evaluator.updated.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
id | string | required | The id of the Evaluator. |
kind | string | One of code, generative, agentic, or human. | |
cascade | string[] | Kinds tried in order when one declines, such as code, then a Human. | |
instructions | text | For a generative or agentic Function, what it does and how. | |
model | string | For a generative or agentic Function, the model it runs on. | |
tools | list of Verb | For an agentic Function, the Verbs it may call; Permissions and Limits apply to each. | |
maxSteps | integer | For an agentic Function, the most steps one Action may take. | |
budget | money | The most one Action may spend; the Mandate’s Limits apply as well. | |
role | Role | For a human Function, the Role its Tasks go to. | |
form | json | For a human Function, the form; generated from the Verb’s inputs and outputs when absent. | |
sla | string | For a human Function, how long a Task may wait, as an ISO 8601 duration. | |
escalateTo | Role | For a human Function, the Role a Task moves to when the service level passes. | |
rubric | text | What it grades against. An agent never varies its own Evaluators. Never randomized. | |
integration | Integration | The Integration whose outside run returns the verdict, such as a CI job; empty when the platform runs it. | |
required | boolean | True when Change.merge refuses until this Evaluator passes on the Change’s head. Never randomized. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
evaluator | Evaluator | required | The Evaluator. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation. | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
Example
import { $ } from 'startup-builder'
const evaluator = await $.Evaluator.update({ id: 'evaluator_cYmeRK4Drs', integration: 'integration_lnFrC1nUGY' })Evaluator.delete
Deletes an Evaluator: a soft delete that keeps its history, undone by Thing.restore. Verb page.
interface EvaluatorVerbs {
delete(input: EvaluatorDeleteInput, options?: SB.CallOptions): SB.Call<Evaluator>
}Emits Evaluator.deleted.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
id | string | required | The id of the Evaluator. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
evaluator | Evaluator | required | The Evaluator. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation. | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
Example
import { $ } from 'startup-builder'
const evaluator = await $.Evaluator.delete({ id: 'evaluator_cYmeRK4Drs' })