Sign in
Docs
API referenceDecisions

API reference

List what Atlas knows

Have a token? Manage tokens in the console
GET
/v1/atlas/spaces/{space_id}/facts

The facts Atlas currently believes about a space's system, derived and observed: what runs, what depends on what, which decision governs it. Each says its support, its validity (stale is not false) and whether evidence contradicts it. Off until Atlas is switched on for the account.

Needs scope decisions:read.

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.

Path Parameters

space_id*string

The Decisions space whose system the facts describe.

Query Parameters

derived?boolean

Only facts a rule derived from other facts.

validity?string

current, stale or expired; empty for any.

contradicted?boolean

Only facts that evidence contradicts.

subject?string

Only facts about this subject.

page_size?integer

At most this many; 0 means 100, above 500 means 500.

Formatint32
page_token?string

From the previous page's next_page_token.

Response Body

iohr.atlas.v1.ListFactsResponse

application/json
  1. response

iohr.atlas.v1.ListFactsResponse

facts*array<>
next_page_token*string
import { ApiError, Public } from "@inorbithr/sdk";// Reads INORBIT_TOKEN, or INORBIT_KEY_ID and INORBIT_KEY_SECRET.const api = Public.fromEnv();try {  for await (const fact of api.atlas.allListFacts("<space_id>")) {    console.log(fact);  }} 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
{  "facts": [    {      "class": "string",      "conflict": "string",      "contradicted_by": [        {          "id": "string",          "type": "string"        }      ],      "derived": true,      "evidence": [        {          "id": "string",          "type": "string"        }      ],      "id": "string",      "inputs": [        "string"      ],      "polarity": "string",      "predicate": "string",      "rule": "string",      "stale_change": "string",      "stale_since": "string",      "subject": "string",      "support": "string",      "validity": "string",      "value": "string"    }  ],  "next_page_token": "string"}