Skip to navigation

Complete a claimed protocol author job

Feature gated lab extension. Send the exact attempt with either one result protocol, a result.protocols list of 1 to max_protocols protocols, or a failure with held. Band compiles every protocol. If one fails, the whole result returns for another attempt (three in total): the job input gets compiler_feedback (with the failing 0-based protocol_index for a list) and previous_protocols, or source for a single result. When the full previous_protocols would exceed the 262,144-byte input bound, it holds only the failing protocol’s source and previous_protocols_truncated is true. On success the job keeps the first protocol and each further one becomes a sibling job with a group. A well-formed result the room cannot hold whole (job capacity) is answered with the job failed and a diagnostics code; it is never retried. A valid, resolved result graded below A whose lint warns about its guidance (PL602, PL603) is queued once more within the same three attempts, with quality_pass true in the job input. The job keeps the valid result; the revision replaces it only when every protocol compiles to the same definition digest in the same order and the lint scores rise for at least one protocol and fall for none. Any other outcome of that attempt, a failure or a timeout included, ends the job with the kept result and a diagnostics notice. Pending guidance passes reserve the job slots their additional protocols will need. A result that cannot fit is refused before another attempt is queued; deleting the job releases its reservation. An exact retry of a completion returns the same job.

Authentication

X-API-Keystring
Enter your API key for programmatic access

Path parameters

job_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.
objectRequired
OR
objectRequired

Response

The job after this completion.
attemptinteger0-2
author_idstringformat: "uuid"
baselineobject or map from strings to any
claimed_atstring or nullformat: "date-time"
definitionobject or map from strings to any
descriptionstring or null

What the draft is for. When goal is null this is the purpose inferred from the room history, and the panel uses it as the draft’s name. Null before a draft compiles.

diagnosticsstring or object or map from strings to any
goalstring or null
Null when the job has no goal.
groupobject or map from strings to any
history_countinteger0-1024
idstringformat: "uuid"
inserted_atstringformat: "date-time"
namestring or null
The draft protocol's name. Null before a draft compiles.
operationenum
Allowed values:
profileenum
Allowed values:
rangeobject
resultobject or map from strings to any
roomstringformat: "uuid"
skillobject or map from strings to any
sourceobject or map from strings to any
statusenum

needs_input is a compiled draft whose unresolved questions need a person.

lintobject or map from strings to anyOptional

The band-contract/lint/1 report of the job’s draft: the kept protocol, or the blocked draft while the author retries. Null without a compiled draft. Optional: servers before lint omit it.