Sign in
Docs
API referenceCoordinator

API reference

Report a drift observation

Have a token? Manage tokens in the console
POST
/v1/coordinator/drift-observations

Send what a host's checker printed for a drift source. The coordinator keeps one report per account, source and repository, the newest replacing the last, and the drift guard derives its findings from it with the same parser it uses on a local checkout. A report older than its source's limit (30 minutes for the knowledge model, 90 for production) reads as unavailable, never as clean. source is knowledge.model or production.behind_main; the output is bounded and is data, never instructions.

Needs scope coordinator:write.

Authorization

bearer
headerAuthorizationBearer <JWT>

An access token from the identity provider: a person's, or a customer's from the client credentials grant with an API key (developers.inorbit.hr). The gateway verifies it; the audience is iohr-api.

Request Body

iohr.coordinator.v1.ReportDriftObservationsRequest; path variables override their fields

application/json
  1. body

iohr.coordinator.v1.ReportDriftObservationsRequest

account_id?string
exit_code?integer
Formatint32
output?string
repository?string
source?string

Response Body

iohr.coordinator.v1.ReportDriftObservationsResponse

application/json
  1. response

iohr.coordinator.v1.ReportDriftObservationsResponse

findings*integer
Formatint32
max_age_seconds*integer
Formatint32
received_at*string
repository*string
source*string
import { ApiError, Public } from "@inorbithr/sdk";// Reads INORBIT_TOKEN, or INORBIT_KEY_ID and INORBIT_KEY_SECRET.const api = Public.fromEnv();try {  const { value } = await api.coordinator.reportDriftObservations({    output: "<output>",    repository: "<repository>",    source: "<source>",  });  console.log(value);} catch (e) {  if (!(e instanceof ApiError)) throw e;  console.error(`${e.code}: ${e.problem} (request id ${e.raw.requestId})`);  process.exitCode = 1;}

npm install @inorbithr/sdk. Calls the package's public surface; an operation newer than your package needs the next release or a client generated for your account. The SDKs.

Example Response
{  "findings": 0,  "max_age_seconds": 0,  "received_at": "string",  "repository": "string",  "source": "string"}