Actions
| Action | Description |
|---|---|
list | List all criteria for a task |
create | Create a new criterion |
get | Get a criterion by ID |
update | Update a criterion |
delete | Delete a criterion |
Parameters
list
| Parameter | Type | Required | Description |
|---|---|---|---|
taskId | string | yes | Task ID to list criteria for |
create
| Parameter | Type | Required | Description |
|---|---|---|---|
taskId | string | yes | Task ID to attach the criterion to |
label | string | yes | Short human-readable label |
assertion | object | yes | Typed assertion spec. See Criteria API |
weight | number | no | Relative weight (default 1) |
axis | string | no | Optional scoring axis |
inputEntityId | string | no | Optional DatasetEntity ID the criterion is scoped to |
get
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Criterion ID |
update
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Criterion ID |
label | string | no | Updated label |
assertion | object | no | Updated assertion spec |
weight | number | no | Updated weight |
axis | string | no | Updated axis |
inputEntityId | string | no | Updated scoped DatasetEntity ID |
delete
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Criterion ID |
Examples
Create a FHIR criterion
{
"action": "create",
"taskId": "task_xyz789",
"label": "Appointment booked with correct provider",
"weight": 1,
"axis": "correctness",
"assertion": {
"assert": "fhir-resource-state",
"resource_type": "Appointment",
"search": { "patient": "Patient/john-smith", "status": "booked" },
"fields": [
{ "path": "participant.0.actor.display", "expected": "Dr. Rivera" }
]
}
}
Create a voice transcript criterion
{
"action": "create",
"taskId": "task_xyz789",
"label": "Required disclosures",
"weight": 0.5,
"assertion": {
"assert": "voice-transcript",
"speaker": "agent",
"contains": ["member ID", "date of birth"]
}
}
List criteria for a task
{
"action": "list",
"taskId": "task_xyz789"
}