putty
API ReferenceEngine

Build and typecheck a project without a run

Runs the project's build and typecheck commands in its sandbox and returns `{ ok, errors[] }` with every failure's output verbatim, so the free layer can check a project before any credits are spent. No agent run is started, no model is called, and nothing is written to the project. The exec timeout is enforced server-side: the body may ask for less than the 300 s `exec` ceiling but not more, and each command's output is capped at 16 KB as head plus tail.

POST
/projects/{projectId}/verify

Runs the project's build and typecheck commands in its sandbox and returns { ok, errors[] } with every failure's output verbatim, so the free layer can check a project before any credits are spent. No agent run is started, no model is called, and nothing is written to the project. The exec timeout is enforced server-side: the body may ask for less than the 300 s exec ceiling but not more, and each command's output is capped at 16 KB as head plus tail.

Path Parameters

projectId*string

The project the operation is about.

Request Body

application/json

The exec timeout to allow. Omit for the 120 s default.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/projects/string/verify" \  -H "Content-Type: application/json" \  -d '{}'
{  "ok": true,  "build": {    "ok": true,    "exitCode": 0,    "output": "string"  },  "typecheck": {    "ok": true,    "exitCode": 0,    "output": "string"  },  "timedOut": true,  "errors": [    {      "step": "build",      "exitCode": 0,      "output": "string"    }  ]}