Skip to main content
POST
Grade a run of this task and propose a more efficient prompt.

Authorizations

X-API-Key
string
header
required

Company API key - scoped to a specific company. Generate from the Integrations page in your dashboard.

Path Parameters

task_id
string
required

Body

application/json

What to evaluate and how to steer the rewrite

Request body for evaluating a scheduled task

companyId
string

Company ID. Optional when the API key is a company key.

executionId
string

Grade this past run instead of triggering a fresh one

notes
string

Free-text guidance for the prompt rewrite, e.g. "stop it posting twice"

Response

Evaluation started; poll the GET endpoint

A run of the task graded 0-100, plus a proposed more efficient prompt

id
string
scheduledTaskId
string
status
string

running, completed, or failed

executionId
string

The run that was graded

score
integer
scoreReason
string
suggestedPrompt
string
suggestionReason
string
notes
string
errorMessage
string
createdDate
string
updatedDate
string