API reference
Skill runs
Run one skill on demand, follow the run, and upload two versions of an artefact to compare.
Paths are relative to the address of your Nullgap console. Authentication, errors, paging and rate limits are the same for every call and are described in the API overview.
| Operation | Method and path | Who may call it |
|---|---|---|
| List uploads | GET /api/orgs/{org}/skill-uploads | read |
| Upload a version to compare | POST /api/orgs/{org}/skill-uploads | write |
| Remove an upload | DELETE /api/orgs/{org}/skill-uploads/{id} | write |
| Run a skill | POST /api/orgs/{org}/skill-runs | write |
| List skill runs | GET /api/orgs/{org}/skill-runs | read |
| Get a skill run | GET /api/orgs/{org}/skill-runs/{id} | read |
| Get a skill run's log | GET /api/orgs/{org}/skill-runs/{id}/logs | read |
| Cancel a skill run | POST /api/orgs/{org}/skill-runs/{id}/cancel | write |
#List uploads
GET /api/orgs/{org}/skill-uploads
Returns the files uploaded for a comparison that are still stored, newest first, as a plain list. An upload is deleted 7 days after it arrived and then no longer appears.
Who may call it: An API key with the read scope or higher.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
org | string | yes | The organisation slug. |
Example request
curl -s -H "Authorization: Bearer $NULLGAP_API_KEY" \
"$NULLGAP_URL/api/orgs/$NULLGAP_ORG/skill-uploads"
Answer (200, application/json)
The uploads, newest first.
An array of SkillUpload.
[
{
"id": "sku_5c1e8a3f7b2d",
"name": "billing-service-2.4.0.jar",
"bytes": 18350211,
"kind": "java",
"createdBy": "dana@acme.example",
"createdAt": "2026-11-16T09:30:00.000Z",
"expiresAt": "2026-11-23T09:30:00.000Z"
}
]
#Upload a version to compare
POST /api/orgs/{org}/skill-uploads
Uploads one version of a built artefact or a source archive so that a skill can compare it with another version. The request body is the file itself, not JSON, up to 200 MB: a .zip, .tar.gz, .jar, .war, .ear, .nupkg, .dll or .exe. Upload the older and the newer version with two calls, then start a run with both ids as artifacts. The file is unpacked once on arrival to check it can be read, under the same limits as an uploaded source archive. It is kept for 7 days. An organisation can keep 20 uploads at a time.
Who may call it: An API key with the write scope or higher.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
org | string | yes | The organisation slug. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
name | string | no | The file name, which decides how it is read (.jar as Java, .dll as .NET and so on). Up to 120 characters: letters, digits, spaces, dots, dashes, plus signs and underscores, starting with a letter or digit. Default artefact. |
Request body (application/octet-stream)
The bytes of the file.
Example request
curl -s -X POST -H "Authorization: Bearer $NULLGAP_API_KEY" \
-H "Content-Type: application/octet-stream" \
--data-binary @code.zip \
"$NULLGAP_URL/api/orgs/$NULLGAP_ORG/skill-uploads"
Answer (200, application/json)
A SkillUpload object.
{
"id": "sku_5c1e8a3f7b2d",
"name": "billing-service-2.4.0.jar",
"bytes": 18350211,
"kind": "java",
"createdBy": "dana@acme.example",
"createdAt": "2026-11-16T09:30:00.000Z",
"expiresAt": "2026-11-23T09:30:00.000Z"
}
Errors specific to this call
| Status | Code | When |
|---|---|---|
| 400 | not_configured | Uploading files is not available on this server. |
| 400 | bad_request | name contains characters that are not allowed or is too long, or the upload is empty. |
| 400 | bad_archive | The file could not be unpacked: damaged, cut short, or not one of the formats listed. |
| 409 | too_many | The organisation already keeps 20 uploads. Remove one first. |
| 413 | too_large | The file is larger than 200 MB. |
#Remove an upload
DELETE /api/orgs/{org}/skill-uploads/{id}
Deletes an uploaded file now instead of after 7 days. A run that has already finished keeps its output.
Who may call it: An API key with the write scope or higher.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
org | string | yes | The organisation slug. |
id | string | yes | The upload id. |
Example request
curl -s -X DELETE -H "Authorization: Bearer $NULLGAP_API_KEY" \
"$NULLGAP_URL/api/orgs/$NULLGAP_ORG/skill-uploads/ID"
Answer (200, application/json)
| Field | Type | Always present | Description |
|---|---|---|---|
ok | boolean | yes | Always true. |
{
"ok": true
}
Errors specific to this call
| Status | Code | When |
|---|---|---|
| 404 | not_found | No upload of this organisation has that id. |
#Run a skill
POST /api/orgs/{org}/skill-runs
Starts one run of one skill and returns as soon as it is queued; read the run to follow it and to get its output. The skill must list on-demand among its pipelines and be switched on. What the run works on is decided by the fields sent, in this order: artifacts (two uploads, compared; no repository), else findingId (one finding, on its repository's default branch), else repoId with prNumber (one pull request at its head), else repoId with baseRef and ref (two versions of the repository, compared), else repoId alone (the repository at ref). Every input the skill marks as required must be supplied. The output of an on-demand run is not sent through the independent check and nothing in it is reproduced: leads stay candidates and are not added to the organisation's findings, and every run says so in assurance. A triage skill run on a finding records its verdict on that finding and changes neither its state nor its status. The run counts towards the workspace's monthly usage.
Who may call it: An API key with the write scope or higher.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
org | string | yes | The organisation slug. |
Request body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
skillId | string | yes | The skill to run. Up to 64 characters. |
repoId | string | no | The repository to run on. Not needed with artifacts or findingId. |
ref | string | no | The branch, tag or commit to run on, or the newer version when baseRef is sent. Default: the repository's default branch. Not used for a pull request or a finding. Up to 200 characters: letters, digits and . _ / ~ ^ -, starting with a letter or digit. |
baseRef | string | no | The older version, for a skill that compares two versions of a repository. Must differ from ref. Up to 200 characters: letters, digits and . _ / ~ ^ -, starting with a letter or digit. |
prNumber | integer | no | A pull request of the repository, for a skill that takes one. |
findingId | string | no | A finding, for a skill that takes one. Its repository is used; repoId is ignored. |
artifacts | object | no | Two uploads to compare, for a skill that takes two versions. |
artifacts.before | string | yes | The upload id of the older version. |
artifacts.after | string | yes | The upload id of the newer version. |
text | string | no | Text for the skill to work on: logs, a feature description, an issue. Up to 200,000 characters. Kept for the run and never returned. |
Example request
curl -s -X POST -H "Authorization: Bearer $NULLGAP_API_KEY" \
-H "Content-Type: application/json" \
-d '{"skillId":"threat-model","repoId":"repo_a41c09be77d3","ref":"main","baseRef":"main","prNumber":128,"findingId":"fnd_8f3a2c9d1b4e","artifacts":{"before":"sku_5c1e8a3f7b2d","after":"sku_9b4d2e6a1c8f"},"text":"We are adding a webhook that lets partners push order updates."}' \
"$NULLGAP_URL/api/orgs/$NULLGAP_ORG/skill-runs"
Answer (200, application/json)
A SkillRun object.
{
"id": "skr_3e7a1c9f5b2d",
"orgId": "org_1d4c7b9a2e5f",
"skillId": "injection-review",
"skillTitle": "Injection review",
"skillVersion": "1.2.0",
"origin": "built-in",
"repoId": "repo_a41c09be77d3",
"repoFullName": "acme/shop",
"target": {
"kind": "repository",
"ref": "main"
},
"hasText": false,
"status": "completed",
"error": "The run reached its usage limit before the skill finished. Nothing was produced.",
"assurance": "Produced by one skill run on request. It was not sent through the independent check or reproduced in the sandbox, so nothing in it is a verified or proven finding.",
"output": {
"kind": "findings",
"leads": [
{
"id": "f_3c9e1a7b2d4f",
"module": "code",
"ruleId": "sql-injection",
"title": "SQL injection in order lookup",
"description": "The order id from the query string is placed into the SQL text, so a caller can read any order.",
"severity": "high",
"confidence": 0.9,
"cwe": [
"CWE-89"
],
"cve": [
"CVE-2021-23337"
],
"location": {
"file": "src/orders.js",
"startLine": 42,
"endLine": 44,
"snippet": "db.query(`SELECT * FROM orders WHERE id = ${req.query.id}`)"
},
"package": {
"ecosystem": "npm",
"name": "lodash",
"version": "4.17.20",
"fixedVersion": "4.17.21",
"manifest": "package-lock.json",
"direct": true
},
"source": "builtin",
"status": "proven",
"evidence": [
{
"kind": "probe",
"summary": "The probe read another customer’s order by changing the id in the query string.",
"detail": "probe.js sends GET /orders?id=1 OR 1=1 and prints the rows returned.",
"command": "node probe.js",
"exitCode": 0,
"output": "REPRODUCED: 3 rows returned for a single order id",
"proof": {
"outcome": "reproduced",
"attempts": 1,
"missing": "A running PostgreSQL database",
"dependencies": "installed",
"controlHeld": true,
"repeatable": true,
"audited": true,
"variantHeld": true,
"modelsAsked": 2,
"declined": 1
}
}
],
"remediation": "Pass the id as a bound parameter instead of building the SQL text.",
"patch": {
"diff": "--- a/src/orders.js\n+++ b/src/orders.js\n@@ -42 +42 @@\n- db.query(`SELECT * FROM orders WHERE id = ${req.query.id}`)\n+ db.query('SELECT * FROM orders WHERE id = ?', [req.query.id])\n",
"description": "Pass the order id as a bound parameter.",
"verified": true,
"verification": {
"probePassed": true,
"testsPassed": true,
"log": "probe: exit 1 (safe)\ntests: 48 passed",
"checks": [
{
"name": "probe",
"status": "passed",
"detail": "The probe no longer reproduces on the patched code.",
"place": "src/orders.js:42"
}
],
"refused": [
"The patch removes the endpoint instead of fixing it."
]
},
"attempts": [
{
"attempt": 1,
"verified": true,
"reason": "The second input still reproduced the flaw.",
"proposed": true,
"files": [
"src/orders.js"
]
}
],
"unproven": {
"reason": "Nullgap AI declined to write a probe for this finding",
"proof": "no_probe",
"accepted": true,
"independentReviewer": true
}
},
"fingerprint": "5b1f0c9a7e2d4a61",
"triage": {
"shape": {
"v": 1,
"families": [
"sql-injection"
],
"file": "src/orders.js",
"fn": "getOrder",
"indexed": true,
"anchor": "db . query ( `…` )",
"sink": "db . query ( `…` )",
"ordinal": 0,
"source": "const id = req . query . id",
"entry": "app . get ( \"\" , getOrder )",
"near": "9c41f0a7d2b3",
"wide": [
"03af19c2"
],
"callers": [
"listOrders:5e7a01bc"
],
"family": "b7d2e94a10c6"
},
"exposure": {
"reachable": "yes",
"entryPoint": {
"kind": "http",
"name": "getOrder",
"file": "src/routes.js",
"line": 18,
"method": "GET",
"route": "/orders"
},
"authentication": "none",
"surface": "internet",
"attackerControlled": "yes",
"basis": [
"GET /orders is registered in src/routes.js:18 with no sign-in check."
]
}
},
"triageVerdict": {
"verdict": "true_positive",
"confidence": "high",
"severity": "high",
"severityBefore": "critical",
"severityReasons": [
"Needs a signed-in account, which any customer can create."
],
"mitigations": [
"The id is parsed as an integer in the router, which does not stop the injection in the sort column."
],
"weaknessFits": true,
"reasoning": "The sort column is taken from the query string and concatenated into the ORDER BY clause.",
"confirmedPath": [
"src/orders/list.ts:22 reads req.query.sort"
],
"at": "2026-11-16T09:30:00.000Z"
}
}
],
"limits": [
"Only the files changed by the pull request were read."
]
},
"tools": [
{
"id": "static-rules",
"status": "ran",
"note": "14 leads on 9 files"
}
],
"createdBy": "dana@acme.example",
"privacy": {
"zeroRetention": true,
"identifiersMasked": 14
},
"createdAt": "2026-11-16T09:30:00.000Z",
"startedAt": "2026-11-16T09:30:00.000Z",
"finishedAt": "2026-11-16T09:34:00.000Z"
}
Errors specific to this call
| Status | Code | When |
|---|---|---|
| 400 | bad_request | A required input of the skill was not sent, an input was sent that the skill does not take, ref or baseRef is not a valid name, the two versions are the same, or repoId is missing. The message says which. |
| 400 | not_on_demand | The skill only runs inside reviews and pentests. |
| 400 | skill_disabled | The skill is switched off for the organisation or for this repository. |
| 402 | plan_inactive | The workspace has no active plan. |
| 402 | usage_limit | The workspace has reached its monthly usage limit. |
| 404 | not_found | The skill, the repository, the finding or one of the uploads does not exist in this organisation, or an upload is past its 7 days. |
#List skill runs
GET /api/orgs/{org}/skill-runs
Returns the organisation's on-demand skill runs, newest first. output is null on every entry: read one run to get its output.
Who may call it: An API key with the read scope or higher.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
org | string | yes | The organisation slug. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
skillId | string | no | Only runs of this skill. |
limit | integer | no | How many to return, 1 to 200. Default 50. |
offset | integer | no | How many to skip from the start. Default 0. |
Example request
curl -s -H "Authorization: Bearer $NULLGAP_API_KEY" \
"$NULLGAP_URL/api/orgs/$NULLGAP_ORG/skill-runs?limit=20"
Answer (200, application/json)
| Field | Type | Always present | Description |
|---|---|---|---|
items | array of SkillRun | yes | Skill runs, at most limit of them. |
total | integer | yes | How many match in all, before limit and offset. |
{
"items": [
{
"id": "skr_3e7a1c9f5b2d",
"orgId": "org_1d4c7b9a2e5f",
"skillId": "injection-review",
"skillTitle": "Injection review",
"skillVersion": "1.2.0",
"origin": "built-in",
"repoId": "repo_a41c09be77d3",
"repoFullName": "acme/shop",
"target": {
"kind": "repository",
"ref": "main"
},
"hasText": false,
"status": "completed",
"error": "The run reached its usage limit before the skill finished. Nothing was produced.",
"assurance": "Produced by one skill run on request. It was not sent through the independent check or reproduced in the sandbox, so nothing in it is a verified or proven finding.",
"output": {
"kind": "findings",
"leads": [
{
"id": "f_3c9e1a7b2d4f",
"module": "code",
"ruleId": "sql-injection",
"title": "SQL injection in order lookup",
"description": "The order id from the query string is placed into the SQL text, so a caller can read any order.",
"severity": "high",
"confidence": 0.9,
"cwe": [
"CWE-89"
],
"cve": [
"CVE-2021-23337"
],
"location": {
"file": "src/orders.js",
"startLine": 42,
"endLine": 44,
"snippet": "db.query(`SELECT * FROM orders WHERE id = ${req.query.id}`)"
},
"package": {
"ecosystem": "npm",
"name": "lodash",
"version": "4.17.20",
"fixedVersion": "4.17.21",
"manifest": "package-lock.json",
"direct": true
},
"source": "builtin",
"status": "proven",
"evidence": [
{
"kind": "probe",
"summary": "The probe read another customer’s order by changing the id in the query string.",
"detail": "probe.js sends GET /orders?id=1 OR 1=1 and prints the rows returned.",
"command": "node probe.js",
"exitCode": 0,
"output": "REPRODUCED: 3 rows returned for a single order id",
"proof": {
"outcome": "reproduced",
"attempts": 1,
"missing": "A running PostgreSQL database",
"dependencies": "installed",
"controlHeld": true,
"repeatable": true,
"audited": true,
"variantHeld": true,
"modelsAsked": 2,
"declined": 1
}
}
],
"remediation": "Pass the id as a bound parameter instead of building the SQL text.",
"patch": {
"diff": "--- a/src/orders.js\n+++ b/src/orders.js\n@@ -42 +42 @@\n- db.query(`SELECT * FROM orders WHERE id = ${req.query.id}`)\n+ db.query('SELECT * FROM orders WHERE id = ?', [req.query.id])\n",
"description": "Pass the order id as a bound parameter.",
"verified": true,
"verification": {
"probePassed": true,
"testsPassed": true,
"log": "probe: exit 1 (safe)\ntests: 48 passed",
"checks": [
{
"name": "probe",
"status": "passed",
"detail": "The probe no longer reproduces on the patched code.",
"place": "src/orders.js:42"
}
],
"refused": [
"The patch removes the endpoint instead of fixing it."
]
},
"attempts": [
{
"attempt": 1,
"verified": true,
"reason": "The second input still reproduced the flaw.",
"proposed": true,
"files": [
"src/orders.js"
]
}
],
"unproven": {
"reason": "Nullgap AI declined to write a probe for this finding",
"proof": "no_probe",
"accepted": true,
"independentReviewer": true
}
},
"fingerprint": "5b1f0c9a7e2d4a61",
"triage": {
"shape": {
"v": 1,
"families": [
"sql-injection"
],
"file": "src/orders.js",
"fn": "getOrder",
"indexed": true,
"anchor": "db . query ( `…` )",
"sink": "db . query ( `…` )",
"ordinal": 0,
"source": "const id = req . query . id",
"entry": "app . get ( \"\" , getOrder )",
"near": "9c41f0a7d2b3",
"wide": [
"03af19c2"
],
"callers": [
"listOrders:5e7a01bc"
],
"family": "b7d2e94a10c6"
},
"exposure": {
"reachable": "yes",
"entryPoint": {
"kind": "http",
"name": "getOrder",
"file": "src/routes.js",
"line": 18,
"method": "GET",
"route": "/orders"
},
"authentication": "none",
"surface": "internet",
"attackerControlled": "yes",
"basis": [
"GET /orders is registered in src/routes.js:18 with no sign-in check."
]
}
},
"triageVerdict": {
"verdict": "true_positive",
"confidence": "high",
"severity": "high",
"severityBefore": "critical",
"severityReasons": [
"Needs a signed-in account, which any customer can create."
],
"mitigations": [
"The id is parsed as an integer in the router, which does not stop the injection in the sort column."
],
"weaknessFits": true,
"reasoning": "The sort column is taken from the query string and concatenated into the ORDER BY clause.",
"confirmedPath": [
"src/orders/list.ts:22 reads req.query.sort"
],
"at": "2026-11-16T09:30:00.000Z"
}
}
],
"limits": [
"Only the files changed by the pull request were read."
]
},
"tools": [
{
"id": "static-rules",
"status": "ran",
"note": "14 leads on 9 files"
}
],
"createdBy": "dana@acme.example",
"privacy": {
"zeroRetention": true,
"identifiersMasked": 14
},
"createdAt": "2026-11-16T09:30:00.000Z",
"startedAt": "2026-11-16T09:30:00.000Z",
"finishedAt": "2026-11-16T09:34:00.000Z"
}
],
"total": 42
}
#Get a skill run
GET /api/orgs/{org}/skill-runs/{id}
Returns one run with its output once it has completed. Poll this to follow a run: status goes from queued to running to completed, failed or cancelled. A failed run says why in error.
Who may call it: An API key with the read scope or higher.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
org | string | yes | The organisation slug. |
id | string | yes | The skill run id. |
Example request
curl -s -H "Authorization: Bearer $NULLGAP_API_KEY" \
"$NULLGAP_URL/api/orgs/$NULLGAP_ORG/skill-runs/ID"
Answer (200, application/json)
A SkillRun object.
{
"id": "skr_3e7a1c9f5b2d",
"orgId": "org_1d4c7b9a2e5f",
"skillId": "injection-review",
"skillTitle": "Injection review",
"skillVersion": "1.2.0",
"origin": "built-in",
"repoId": "repo_a41c09be77d3",
"repoFullName": "acme/shop",
"target": {
"kind": "repository",
"ref": "main"
},
"hasText": false,
"status": "completed",
"error": "The run reached its usage limit before the skill finished. Nothing was produced.",
"assurance": "Produced by one skill run on request. It was not sent through the independent check or reproduced in the sandbox, so nothing in it is a verified or proven finding.",
"output": {
"kind": "findings",
"leads": [
{
"id": "f_3c9e1a7b2d4f",
"module": "code",
"ruleId": "sql-injection",
"title": "SQL injection in order lookup",
"description": "The order id from the query string is placed into the SQL text, so a caller can read any order.",
"severity": "high",
"confidence": 0.9,
"cwe": [
"CWE-89"
],
"cve": [
"CVE-2021-23337"
],
"location": {
"file": "src/orders.js",
"startLine": 42,
"endLine": 44,
"snippet": "db.query(`SELECT * FROM orders WHERE id = ${req.query.id}`)"
},
"package": {
"ecosystem": "npm",
"name": "lodash",
"version": "4.17.20",
"fixedVersion": "4.17.21",
"manifest": "package-lock.json",
"direct": true
},
"source": "builtin",
"status": "proven",
"evidence": [
{
"kind": "probe",
"summary": "The probe read another customer’s order by changing the id in the query string.",
"detail": "probe.js sends GET /orders?id=1 OR 1=1 and prints the rows returned.",
"command": "node probe.js",
"exitCode": 0,
"output": "REPRODUCED: 3 rows returned for a single order id",
"proof": {
"outcome": "reproduced",
"attempts": 1,
"missing": "A running PostgreSQL database",
"dependencies": "installed",
"controlHeld": true,
"repeatable": true,
"audited": true,
"variantHeld": true,
"modelsAsked": 2,
"declined": 1
}
}
],
"remediation": "Pass the id as a bound parameter instead of building the SQL text.",
"patch": {
"diff": "--- a/src/orders.js\n+++ b/src/orders.js\n@@ -42 +42 @@\n- db.query(`SELECT * FROM orders WHERE id = ${req.query.id}`)\n+ db.query('SELECT * FROM orders WHERE id = ?', [req.query.id])\n",
"description": "Pass the order id as a bound parameter.",
"verified": true,
"verification": {
"probePassed": true,
"testsPassed": true,
"log": "probe: exit 1 (safe)\ntests: 48 passed",
"checks": [
{
"name": "probe",
"status": "passed",
"detail": "The probe no longer reproduces on the patched code.",
"place": "src/orders.js:42"
}
],
"refused": [
"The patch removes the endpoint instead of fixing it."
]
},
"attempts": [
{
"attempt": 1,
"verified": true,
"reason": "The second input still reproduced the flaw.",
"proposed": true,
"files": [
"src/orders.js"
]
}
],
"unproven": {
"reason": "Nullgap AI declined to write a probe for this finding",
"proof": "no_probe",
"accepted": true,
"independentReviewer": true
}
},
"fingerprint": "5b1f0c9a7e2d4a61",
"triage": {
"shape": {
"v": 1,
"families": [
"sql-injection"
],
"file": "src/orders.js",
"fn": "getOrder",
"indexed": true,
"anchor": "db . query ( `…` )",
"sink": "db . query ( `…` )",
"ordinal": 0,
"source": "const id = req . query . id",
"entry": "app . get ( \"\" , getOrder )",
"near": "9c41f0a7d2b3",
"wide": [
"03af19c2"
],
"callers": [
"listOrders:5e7a01bc"
],
"family": "b7d2e94a10c6"
},
"exposure": {
"reachable": "yes",
"entryPoint": {
"kind": "http",
"name": "getOrder",
"file": "src/routes.js",
"line": 18,
"method": "GET",
"route": "/orders"
},
"authentication": "none",
"surface": "internet",
"attackerControlled": "yes",
"basis": [
"GET /orders is registered in src/routes.js:18 with no sign-in check."
]
}
},
"triageVerdict": {
"verdict": "true_positive",
"confidence": "high",
"severity": "high",
"severityBefore": "critical",
"severityReasons": [
"Needs a signed-in account, which any customer can create."
],
"mitigations": [
"The id is parsed as an integer in the router, which does not stop the injection in the sort column."
],
"weaknessFits": true,
"reasoning": "The sort column is taken from the query string and concatenated into the ORDER BY clause.",
"confirmedPath": [
"src/orders/list.ts:22 reads req.query.sort"
],
"at": "2026-11-16T09:30:00.000Z"
}
}
],
"limits": [
"Only the files changed by the pull request were read."
]
},
"tools": [
{
"id": "static-rules",
"status": "ran",
"note": "14 leads on 9 files"
}
],
"createdBy": "dana@acme.example",
"privacy": {
"zeroRetention": true,
"identifiersMasked": 14
},
"createdAt": "2026-11-16T09:30:00.000Z",
"startedAt": "2026-11-16T09:30:00.000Z",
"finishedAt": "2026-11-16T09:34:00.000Z"
}
Errors specific to this call
| Status | Code | When |
|---|---|---|
| 404 | not_found | No skill run of this organisation has that id. |
#Get a skill run's log
GET /api/orgs/{org}/skill-runs/{id}/logs
Returns the progress log of one run, oldest line first, as a plain list. The list is empty when the run has not written anything yet.
Who may call it: An API key with the read scope or higher.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
org | string | yes | The organisation slug. |
id | string | yes | The skill run id. |
Example request
curl -s -H "Authorization: Bearer $NULLGAP_API_KEY" \
"$NULLGAP_URL/api/orgs/$NULLGAP_ORG/skill-runs/ID/logs"
Answer (200, application/json)
The log lines, oldest first.
An array of LogLine.
[
{
"at": "2026-11-16T09:30:00.000Z",
"level": "info",
"message": "Mapping the attack surface: 42 entry points"
}
]
Errors specific to this call
| Status | Code | When |
|---|---|---|
| 404 | not_found | No skill run of this organisation has that id. |
#Cancel a skill run
POST /api/orgs/{org}/skill-runs/{id}/cancel
Stops a queued or running skill run. Its status becomes cancelled and nothing it had produced is kept. Takes no body.
Who may call it: An API key with the write scope or higher.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
org | string | yes | The organisation slug. |
id | string | yes | The skill run id. |
Example request
curl -s -X POST -H "Authorization: Bearer $NULLGAP_API_KEY" \
"$NULLGAP_URL/api/orgs/$NULLGAP_ORG/skill-runs/ID/cancel"
Answer (200, application/json)
A SkillRun object.
{
"id": "skr_3e7a1c9f5b2d",
"orgId": "org_1d4c7b9a2e5f",
"skillId": "injection-review",
"skillTitle": "Injection review",
"skillVersion": "1.2.0",
"origin": "built-in",
"repoId": "repo_a41c09be77d3",
"repoFullName": "acme/shop",
"target": {
"kind": "repository",
"ref": "main"
},
"hasText": false,
"status": "completed",
"error": "The run reached its usage limit before the skill finished. Nothing was produced.",
"assurance": "Produced by one skill run on request. It was not sent through the independent check or reproduced in the sandbox, so nothing in it is a verified or proven finding.",
"output": {
"kind": "findings",
"leads": [
{
"id": "f_3c9e1a7b2d4f",
"module": "code",
"ruleId": "sql-injection",
"title": "SQL injection in order lookup",
"description": "The order id from the query string is placed into the SQL text, so a caller can read any order.",
"severity": "high",
"confidence": 0.9,
"cwe": [
"CWE-89"
],
"cve": [
"CVE-2021-23337"
],
"location": {
"file": "src/orders.js",
"startLine": 42,
"endLine": 44,
"snippet": "db.query(`SELECT * FROM orders WHERE id = ${req.query.id}`)"
},
"package": {
"ecosystem": "npm",
"name": "lodash",
"version": "4.17.20",
"fixedVersion": "4.17.21",
"manifest": "package-lock.json",
"direct": true
},
"source": "builtin",
"status": "proven",
"evidence": [
{
"kind": "probe",
"summary": "The probe read another customer’s order by changing the id in the query string.",
"detail": "probe.js sends GET /orders?id=1 OR 1=1 and prints the rows returned.",
"command": "node probe.js",
"exitCode": 0,
"output": "REPRODUCED: 3 rows returned for a single order id",
"proof": {
"outcome": "reproduced",
"attempts": 1,
"missing": "A running PostgreSQL database",
"dependencies": "installed",
"controlHeld": true,
"repeatable": true,
"audited": true,
"variantHeld": true,
"modelsAsked": 2,
"declined": 1
}
}
],
"remediation": "Pass the id as a bound parameter instead of building the SQL text.",
"patch": {
"diff": "--- a/src/orders.js\n+++ b/src/orders.js\n@@ -42 +42 @@\n- db.query(`SELECT * FROM orders WHERE id = ${req.query.id}`)\n+ db.query('SELECT * FROM orders WHERE id = ?', [req.query.id])\n",
"description": "Pass the order id as a bound parameter.",
"verified": true,
"verification": {
"probePassed": true,
"testsPassed": true,
"log": "probe: exit 1 (safe)\ntests: 48 passed",
"checks": [
{
"name": "probe",
"status": "passed",
"detail": "The probe no longer reproduces on the patched code.",
"place": "src/orders.js:42"
}
],
"refused": [
"The patch removes the endpoint instead of fixing it."
]
},
"attempts": [
{
"attempt": 1,
"verified": true,
"reason": "The second input still reproduced the flaw.",
"proposed": true,
"files": [
"src/orders.js"
]
}
],
"unproven": {
"reason": "Nullgap AI declined to write a probe for this finding",
"proof": "no_probe",
"accepted": true,
"independentReviewer": true
}
},
"fingerprint": "5b1f0c9a7e2d4a61",
"triage": {
"shape": {
"v": 1,
"families": [
"sql-injection"
],
"file": "src/orders.js",
"fn": "getOrder",
"indexed": true,
"anchor": "db . query ( `…` )",
"sink": "db . query ( `…` )",
"ordinal": 0,
"source": "const id = req . query . id",
"entry": "app . get ( \"\" , getOrder )",
"near": "9c41f0a7d2b3",
"wide": [
"03af19c2"
],
"callers": [
"listOrders:5e7a01bc"
],
"family": "b7d2e94a10c6"
},
"exposure": {
"reachable": "yes",
"entryPoint": {
"kind": "http",
"name": "getOrder",
"file": "src/routes.js",
"line": 18,
"method": "GET",
"route": "/orders"
},
"authentication": "none",
"surface": "internet",
"attackerControlled": "yes",
"basis": [
"GET /orders is registered in src/routes.js:18 with no sign-in check."
]
}
},
"triageVerdict": {
"verdict": "true_positive",
"confidence": "high",
"severity": "high",
"severityBefore": "critical",
"severityReasons": [
"Needs a signed-in account, which any customer can create."
],
"mitigations": [
"The id is parsed as an integer in the router, which does not stop the injection in the sort column."
],
"weaknessFits": true,
"reasoning": "The sort column is taken from the query string and concatenated into the ORDER BY clause.",
"confirmedPath": [
"src/orders/list.ts:22 reads req.query.sort"
],
"at": "2026-11-16T09:30:00.000Z"
}
}
],
"limits": [
"Only the files changed by the pull request were read."
]
},
"tools": [
{
"id": "static-rules",
"status": "ran",
"note": "14 leads on 9 files"
}
],
"createdBy": "dana@acme.example",
"privacy": {
"zeroRetention": true,
"identifiersMasked": 14
},
"createdAt": "2026-11-16T09:30:00.000Z",
"startedAt": "2026-11-16T09:30:00.000Z",
"finishedAt": "2026-11-16T09:34:00.000Z"
}
Errors specific to this call
| Status | Code | When |
|---|---|---|
| 404 | not_found | No skill run of this organisation has that id. |
| 400 | not_running | The run is neither queued nor running: it has already finished, failed or been cancelled. |
#Objects
The objects the operations above take and return.
#SkillUpload
One version of a built artefact or source archive, uploaded so a skill can compare it with another.
| Field | Type | Always present | Description |
|---|---|---|---|
id | string | yes | The upload id. Send it as artifacts.before or artifacts.after when starting a run. |
name | string | yes | The name it was uploaded under. |
bytes | integer | yes | Its size in bytes. |
kind | string | yes | What it was recognised as from its name. archive: a source archive (.zip, .tar.gz). java: a .jar, .war or .ear. dotnet: a .dll, .exe or .nupkg. |
createdBy | string | yes | Who uploaded it. |
createdAt | string | yes | When it was uploaded. |
expiresAt | string | yes | When it is deleted: 7 days after the upload. |
#SkillRun
One run of one skill, started on request.
| Field | Type | Always present | Description |
|---|---|---|---|
id | string | yes | The run id. |
orgId | string | yes | The organisation it belongs to. |
skillId | string | yes | The skill's name, which is also its id: lowercase letters, digits and hyphens. |
skillTitle | string | yes | The skill's display name when the run started. |
skillVersion | string | yes | The skill's version when the run started. |
origin | string | yes | Whether the skill is built in or the organisation's own. One of: built-in, custom. |
repoId | string | yes | The repository it ran on. Empty for a run on two uploads. |
repoFullName | string | yes | The name of that repository. Empty for a run on two uploads. |
target | SkillRunTarget | yes | |
hasText | boolean | yes | Whether text was supplied with the run. The text itself is never returned. |
status | string | yes | Where the run stands. skipped is not used for skill runs. |
error | string or null | yes | Why it failed, in words fit to show. |
assurance | string | yes | How far the output was checked. The same sentence on every run, written by the server and not by the skill. |
output | SkillLeads or SkillDocument or SkillTriage or null | yes | What the skill produced. Null until the run has completed, and always null in lists and in the answers to starting and cancelling: read the run to get it. |
tools | array of SkillToolUse | yes | What happened with each tool the skill named. Empty until the run has finished. |
createdBy | string | yes | Who started it. |
privacy | RunPrivacy or null | yes | |
createdAt | string | yes | When it was asked for. |
startedAt | string or null | yes | When work began. |
finishedAt | string or null | yes | When it ended. |
#LogLine
One line of a run's progress log.
| Field | Type | Always present | Description |
|---|---|---|---|
at | string | yes | When the line was written. |
level | string | yes | How serious the line is. One of: info, warn, error. |
message | string | yes | What happened, in plain words. |
#SkillRunTarget
What the run works on. kind says which of the other fields are present.
#SkillLeads
Candidate leads from a skill run.
| Field | Type | Always present | Description |
|---|---|---|---|
kind | string | yes | The output is a list of leads. |
leads | array of Finding | yes | Candidates only. An on-demand run does not send them through the independent check or reproduce them, so their status is always candidate and they are not added to the organisation's findings. |
limits | array of string | yes | What was not examined and what cannot be concluded from the output. Written by the server as well as by the skill; a skill cannot remove an entry. |
#SkillDocument
A document written by a skill. It records what the skill read and observed; it is not an audit result and makes no statement that a standard is met.
| Field | Type | Always present | Description |
|---|---|---|---|
kind | string | yes | The output is a document. |
document | string | yes | Which document it is. One of: threat-model, security-requirements, design-review, test-plan, control-mapping, policy-evaluation, evidence-pack, incident-runbook, incident-timeline, patch-analysis, report. |
title | string | yes | The document's title. |
summary | string | yes | A short summary. |
sections | array of object | yes | The text of the document, in order. |
sections[].heading | string | yes | The section heading. |
sections[].body | string | yes | The section text, as Markdown. |
items | array of object | yes | Rows of the document: a control, a requirement, a policy check, a timeline entry. |
items[].ref | string | yes | A short reference for the row. |
items[].title | string | yes | What the row is about. |
items[].status | string | yes | One of a fixed, neutral set. evidence-found: the code read shows it is handled. gap-observed: it shows it is not. not-examined: not looked at. not-applicable: does not apply here. info: a row with nothing to judge. |
items[].detail | string | yes | What was seen. |
items[].location | string | no | Where, as file:line, when the row is about a place in the code. |
limits | array of string | yes | What was not examined and what cannot be concluded from the output. Written by the server as well as by the skill; a skill cannot remove an entry. |
#SkillTriage
A verdict on one existing finding. It is recorded on the finding and never changes the finding's state or status by itself: that stays a person's decision.
| Field | Type | Always present | Description |
|---|---|---|---|
kind | string | yes | The output is a verdict on one finding. |
findingId | string | yes | The finding the verdict is about. |
triage | TriageVerdict | yes | |
limits | array of string | yes | What was not examined and what cannot be concluded from the output. Written by the server as well as by the skill; a skill cannot remove an entry. |
#SkillToolUse
What happened with one tool a skill named.
| Field | Type | Always present | Description |
|---|---|---|---|
id | string | yes | A tool id. One of: static-rules, code-index, dependency-audit, package-check, sandbox-run, live-request, browser-check, git-history, static-analysis, secret-detection, dependency-scan, container-scan, iac-check, dockerfile-check, kubernetes-check, ci-workflow-check, api-description-check, policy-check, sbom, decompile, web-scan. |
status | string | yes | ran: it ran. unavailable: not installed on this server. not-permitted: the organisation does not allow it. failed: it started and did not finish. offered: the skill could have called it and did not. |
note | string | yes | What happened, in a sentence. Up to 400 characters. |
#RunPrivacy
How the AI processing of one run was protected. Null on a run until it has made its first Nullgap AI call.
| Field | Type | Always present | Description |
|---|---|---|---|
zeroRetention | boolean | yes | True when every Nullgap AI call in the run was confirmed as keeping no data afterwards. |
identifiersMasked | integer | yes | How many identifiers (names, e-mail addresses, numbers) were replaced with made-up values before Nullgap AI saw them. |
#Finding
A flaw as the engine reported it: what it is, where, how serious, and what backs it. Text in evidence[].summary never names the AI behind it other than as Nullgap AI.
| Field | Type | Always present | Description |
|---|---|---|---|
id | string | yes | The id the engine gave this finding. To address a finding in the API use the id of the record that carries it (fnd_…), not this one. |
module | string | yes | The part of Nullgap that produced it: code, deps (dependencies), redteam or another. |
ruleId | string | yes | The rule or check that raised it. |
title | string | yes | A one-line name for the flaw. |
description | string | yes | What is wrong and why it matters. |
severity | string | yes | How serious the flaw is if exploited. One of: critical, high, medium, low, info. |
confidence | number | yes | How confident the engine is that the finding is real, from 0 to 1. |
cwe | array of string | no | The weakness classes it belongs to. |
cve | array of string | no | Published vulnerabilities it corresponds to, mostly on dependency findings. |
location | Location | no | Where in the code it is. Absent on findings that are not about a line of code. |
package | PackageRef | no | The package concerned, on dependency findings. |
source | string | yes | A label for the check that raised it. Findings that are another place of an already proven flaw carry variant; a finding raised by a skill carries llm-skill: followed by the skill id. |
status | string | yes | How far the finding was checked. The product shows this as one of three assurance levels: proven and fixed are proven (a probe reproduced the flaw; fixed adds that a patch exists and passed verification on a fresh checkout), verified is verified (an independent review of the code could not refute it, but it was not reproduced), and candidate is unverified (flagged, the independent review did not complete, not reproduced: a lead to confirm). rejected (an independent check called it a false positive) is never stored, so it does not appear in answers. |
evidence | array of Evidence | yes | The reasoning and checks recorded for the finding, in order. |
remediation | string | no | How to fix it, in words. |
patch | Patch | no | The fix written for it, when one has been. |
fingerprint | string | yes | A value that stays the same for this flaw across runs. |
triage | FindingTriage | no | The shape of the flagged code and how exposed it is. |
triageVerdict | TriageVerdict | no | The independent check's verdict in a fixed shape: true or false positive, how sure, the severity it settled on and why. Absent on findings raised before verdicts were kept and on those the check did not reach. |
#TriageVerdict
The independent check's verdict on a finding, in a fixed shape.
| Field | Type | Always present | Description |
|---|---|---|---|
verdict | string | yes | What the independent check concluded. One of: true_positive, false_positive. |
confidence | string | yes | How sure it is. A low verdict is left for a person: nothing is rejected or downgraded on it. |
severity | string | yes | The severity after weighing prerequisites, impact and difficulty. One of: critical, high, medium, low, info. |
severityBefore | string | no | The severity first claimed, present only when the check changed it. One of: critical, high, medium, low, info. |
severityReasons | array of string | yes | Why the severity is what it is. |
mitigations | array of string | yes | Controls found on the path (validation, authorisation, safe APIs, limits), whether or not they stop the flaw. |
weaknessFits | boolean or null | yes | Whether the weakness class named on the finding fits what the code does. Null when the check did not say. |
reasoning | string | yes | The check's reasoning, in plain words. |
confirmedPath | array of string | yes | The hops of the reported path that the check confirmed in the code. |
at | string | no | When the verdict was given. |
#Location
Where in the code a finding is.
| Field | Type | Always present | Description |
|---|---|---|---|
file | string | yes | Path of the file, relative to the repository root, with forward slashes. |
startLine | integer | yes | The first flagged line, counted from 1. |
endLine | integer | no | The last flagged line, when the finding spans several. |
snippet | string | no | The flagged code. Keys, tokens and passwords in it are masked. |
#PackageRef
The package a dependency finding is about.
| Field | Type | Always present | Description |
|---|---|---|---|
ecosystem | string | yes | The package registry: npm, PyPI, crates.io or another. |
name | string | yes | The package name. |
version | string | yes | The version in use. |
fixedVersion | string | no | The first version without the problem, when one is known. |
manifest | string | no | The manifest or lockfile the package was found in, relative to the repository root. |
direct | boolean | no | True when the project depends on it directly, false when it comes in through another package. |
#Evidence
One step in the chain that backs a finding. The steps are listed in the order they happened.
| Field | Type | Always present | Description |
|---|---|---|---|
kind | string | yes | What sort of evidence this is. engine: a static rule matched. reasoning: the written analysis of the code. probe: a reproduction attempt in the sandbox. transcript: a recorded exchange. verification: the independent check of the finding. dynamic: a test against the running application. |
summary | string | yes | One or two sentences saying what this step showed. |
detail | string | no | The longer text of the step. On probe evidence these are the probe files. |
command | string | no | The command that was run, on evidence that ran one. |
exitCode | integer | no | What the command exited with. |
output | string | no | What the command printed. |
proof | ProofRecord | no | On probe evidence written by the proof step: how the reproduction went. |
#Patch
A fix written for a finding.
| Field | Type | Always present | Description |
|---|---|---|---|
diff | string | yes | A unified diff, applicable with git apply from the repository root. |
description | string | yes | What the patch changes, in plain words. |
verified | boolean | yes | True when the patch passed its checks on a fresh checkout. |
verification | PatchVerification | no | How it was checked, when it was. |
attempts | array of PatchAttempt | no | Every attempt made, oldest first. diff is the last one. |
unproven | object | no | Present only on a patch written without reproducing the flaw. Such a patch is never verified. |
unproven.reason | string | yes | Why the flaw was not reproduced. |
unproven.proof | string | yes | What the reproduction attempt recorded. Never reproduced, and never not_reproduced: when the code behaved safely no patch is written. |
unproven.accepted | boolean | yes | True when every check that needs no probe ran without failing and the independent review accepted the change. Only then was it offered, as a proposal. |
unproven.independentReviewer | boolean | yes | True when the review was done by a different Nullgap AI model from the one that wrote the change. |
#FindingTriage
Facts for triage, worked out from the code: the shape of the flagged code and how exposed it is. Absent on findings from before this existed and on package advisories.
| Field | Type | Always present | Description |
|---|---|---|---|
shape | FlawShape | no | What the flagged code looks like. Absent when the finding is not about code. |
exposure | Exposure | no | How the code can be reached, and by whom. |
#ProofRecord
The record of one attempt to reproduce a finding. It lets a reader tell "it was run and did not reproduce" from "it could not be run here".
| Field | Type | Always present | Description |
|---|---|---|---|
outcome | string | yes | What happened when the finding was sent for reproduction. reproduced: the probe showed the flaw and its harmless control behaved safely. not_reproduced: the probe ran correctly and the code behaved safely. probe_broken: no trustworthy probe (it errored, timed out, or its control did not hold). no_probe: no probe was produced. environment_missing: the code cannot run in the sandbox as it is (see missing). budget_exhausted: the limit for one proof ran out first. |
attempts | integer | yes | How many probe attempts were made, 1 or 2. |
missing | string | no | For environment_missing: what the sandbox lacked, in a few words. |
dependencies | string | yes | Whether the project's dependencies were in place before the probe ran. One of: installed, present, not_installed, not_needed. |
controlHeld | boolean | no | The harmless control run behaved safely. Absent when no control was run. |
repeatable | boolean | no | The probe gave the same result when run a second time. Set when the outcome is reproduced. |
audited | boolean | no | An independent reviewer read the probe and accepted that it exercises the project's own code and observes the unsafe effect. False when the run had no such reviewer. |
variantHeld | boolean | no | A second, different input for the same flaw also reproduced on the unpatched code. False: one was supplied and did not reproduce. Absent: none was supplied. |
modelsAsked | integer | no | Present only when writing the probe was declined at least once: how many Nullgap AI models were asked to write it. Each was sent the same request, unchanged. |
declined | integer | no | Present only when writing the probe was declined at least once: how many of the models asked declined. |
#PatchVerification
How a patch was checked.
| Field | Type | Always present | Description |
|---|---|---|---|
probePassed | boolean | yes | The probe no longer reproduces the flaw on a fresh, patched checkout. |
testsPassed | boolean or null | yes | Whether the project’s own tests pass with the patch. null when the project has no test command. |
log | string | yes | The output of the verification run. |
checks | array of FixCheck | no | Every check, in the order it ran. Absent on patches recorded before checks were itemised. |
refused | array of string | no | Why the patch was refused, one sentence per reason. Empty or absent when it was not refused. |
#PatchAttempt
One try at writing a fix. A run makes a bounded number of them, each told why the previous one failed.
| Field | Type | Always present | Description |
|---|---|---|---|
attempt | integer | yes | Which try this was, counted from 1. |
verified | boolean | yes | Whether this attempt passed every check. |
reason | string | no | Why this attempt was not accepted. Absent when it was. |
proposed | boolean | no | Only on a fix written without reproducing the flaw: this attempt passed every check that needs no probe and was accepted as a proposal. verified is still false. |
files | array of string | yes | The files this attempt changed. |
#FlawShape
What the flagged code looks like, in a form that survives renames and moved lines. Nullgap uses it to recognise code the team has already decided about. Treat the hashes as opaque; family is the one value worth comparing.
| Field | Type | Always present | Description |
|---|---|---|---|
v | integer | yes | The version of this description. Always 1. |
families | array of string | yes | The weakness families of the finding, sorted. |
file | string | yes | The file of the flagged line. |
fn | string or null | yes | The function that encloses the flagged line. null for code outside any named function. |
indexed | boolean | yes | True when the code index covered the file, so fn and callers are facts and not gaps. |
anchor | string | yes | The flagged statement, normalised. Empty when it carries too little to identify anything. |
sink | string | yes | The statement where the dangerous operation happens, normalised. Equal to anchor when the evidence names no other. |
ordinal | integer | yes | Which of several identical statements in the enclosing function this is. 0 is the first. |
source | string or null | yes | The line where the data comes in, normalised, when the evidence names it. |
entry | string or null | yes | The registration line of the entry point the code is reached from, normalised. |
near | string | yes | A hash of the code within a few lines of the flagged statement. |
wide | array of string | yes | A sketch of the whole enclosing function, used to score how alike two functions are. |
callers | array of string or null | yes | One entry per caller of the enclosing function. null when not known. |
family | string | yes | Findings with the same weakness family and the same sink statement share this key. It is what "findings like this one" means. |
#Exposure
What is known about how the flawed code can be reached. It is worked out from the code alone. A fact that could not be established is not_determined and never moves the priority in either direction.
| Field | Type | Always present | Description |
|---|---|---|---|
reachable | string | yes | Whether the flawed code is called from an entry point. One of: yes, no, not_determined. |
entryPoint | object or null | yes | The entry point, when the code is reachable from one. |
entryPoint.kind | string | yes | What sort of entry point it is. |
entryPoint.name | string | yes | Its name in the code. |
entryPoint.file | string | yes | The file it is registered in. |
entryPoint.line | integer | yes | The line it is registered on. |
entryPoint.method | string | no | For an HTTP entry point: the method. |
entryPoint.route | string | no | For an HTTP entry point: the route. |
authentication | string | yes | Whether that entry point asks for a signed-in caller. One of: required, none, not_determined. |
surface | string | yes | Who can get to the entry point. One of: internet, internal, admin, cli, test, not_determined. |
attackerControlled | string | yes | Whether the value that reaches the flaw comes from the caller. One of: yes, no, not_determined. |
basis | array of string | yes | How each fact above was established, one line each. |
#FixCheck
One named check a fix went through.
| Field | Type | Always present | Description |
|---|---|---|---|
name | string | yes | Which check. applies: the patch applies to a fresh checkout. scope: the patch widens no risk and stays on files related to the finding. probe: the probe that reproduced the flaw no longer does. variant: a second input for the same flaw no longer reproduces either. control: ordinary use still works. tests: the project’s own tests pass. For a fix proposed without reproducing the flaw (outcome unverified), the three probe runs are not_run and two more checks are made: build (the changed files still parse) and review (an independent review of the change accepted that it closes the flaw without changing other behaviour). For a dependency fix, in place of the three probe runs: lockfile (the lockfile was regenerated from the edited manifest in the sandbox, with install scripts off) and resolved (the affected version is no longer in the manifest or the lockfile). |
status | string | yes | not_run is never a pass: the check could not be made, and detail says why. |
detail | string | yes | One plain sentence: what was seen, or why the check could not run. |
place | string | no | For a fix that covers several places: the one this check belongs to, as file:line. |
Nullgap documentation