Check fitness for action

Is a subject fit to act on for a purpose? Returns a decision-quality verdict: a disposition plus findings, never a score. Read-only.

POST /v1/preflight/check

Check fitness for action

cURL

curl --request POST \
  --url https://pnbr.io/v1/preflight/check \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "subject": {
    "id": "d32ad102-9aa7-4fce-b148-ab3dcb3b3d47"
  },
  "purpose": "send a renewal proposal"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    subject: {id: 'd32ad102-9aa7-4fce-b148-ab3dcb3b3d47'},
    purpose: 'send a renewal proposal'
  })
};

fetch('https://pnbr.io/v1/preflight/check', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://pnbr.io/v1/preflight/check"

payload = {
    "subject": { "id": "d32ad102-9aa7-4fce-b148-ab3dcb3b3d47" },
    "purpose": "send a renewal proposal"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

200

{
  "disposition": "SafeToAct",
  "purpose": "send a renewal proposal",
  "findings": [],
  "packet_id": "graph:d32ad102-9aa7-4fce-b148-ab3dcb3b3d47:graph_reader_agent:send a renewal proposal",
  "request_id": "53a72893-f7af-442e-8ec6-fc3975870e95"
}

Authorizations

Authorization · string · header · required

A pnbr- API key. Project-scoped keys make project_id implicit; org-scoped keys require it.

Body

application/json

subject · object

Show child attributes

purpose · string

required · string[]

optional · string[]

Response

200 - application/json

A Verdict (disposition + findings).