One agent by id.
Needs scope agents:read.
bearerAuthorizationBearer <token>An access token from the identity provider: a person's, or a customer's from the client credentials grant with an API key (docs.inorbit.hr). The gateway verifies it; the audience is iohr-api.
org_id*stringThe account's id: org in GET /v1/me.
agent_id*stringThe agent's id (agt_…), from List agents.
iohr.agents.v1.GetAgentResponse
application/json- response
iohr.agents.v1.GetAgentResponse
agent?iohr.agents.v1.Agent
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.agents.getAgent("<org_id>", "<agent_id>"); console.log(value);} catch (e) { if (!(e instanceof ApiError)) throw e; console.error(`${e.code}: ${e.problem} (request id ${e.raw.requestId})`);}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.
{ "agent": { "agent_id": "string", "arch": "string", "capabilities": [ "string" ], "checks": { "accepted": 0, "checks_hash": "string", "reconciled_at": "string", "rejected": [ { "key": "string", "reason": "string" } ] }, "clock_skew_ms": "string", "domains": [ "string" ], "enrolled_at": "string", "environment": "string", "last_seen_at": "string", "name": "string", "os": "string", "policy_hash": "string", "revoked_at": "string", "rtt_last_ms": 0, "rtt_p95_ms": 0, "status": "string", "version": "string" }}List agents GET
The account's agents, newest first: each one's environment, the verified domains it is bound to, whether it is online, offline or revoked, the version it reported and when it was last heard from. Paged with `page_size` (0 means 50, at most 200) and `next_page_token`. Needs scope `agents:read`.
Create an agent enrollment POST
A one-time token (`ioe_…`) that enrolls one agent for an environment and the account's verified domains, within the hour. The token is in this answer only; the platform keeps its hash. Every domain must be verified for the account. Needs scope `agents:write`.