The account's connections, newest first: kind, executor (cloud or an agent), configuration, what kind of credential it holds (never the credential), status, last test and live grants.
Needs scope connections: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.
page_size?integerAt most this many; 0 means 50, above 200 means 200.
int32page_token?stringFrom the previous page's next_page_token.
iohr.connections.v1.ListConnectionsResponse
application/json- response
iohr.connections.v1.ListConnectionsResponse
connections*array<>next_page_token*stringimport { ApiError, Public } from "@inorbithr/sdk";// Reads INORBIT_TOKEN, or INORBIT_KEY_ID and INORBIT_KEY_SECRET.const api = Public.fromEnv();try { for await (const connection of api.connections.allListConnections("<org_id>")) { console.log(connection); }} 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.
{ "connections": [ { "account_id": "string", "auth_mode": "string", "config": { "property1": "string", "property2": "string" }, "connector": "string", "created_at": "string", "credential": { "kind": "string", "reference": "string", "set_at": "string" }, "description": "string", "executor": { "agent_id": "string", "kind": "string" }, "external_id": "string", "grants": 0, "id": "string", "kind": "string", "label": "string", "last_test_at": "string", "last_test_error": "string", "last_test_ok": true, "name": "string", "owner": "string", "receive_url": "string", "scopes": [ "string" ], "status": "string", "token_expires_at": "string", "updated_at": "string", "used_by": [ "string" ] } ], "next_page_token": "string"}Get a connector GET
One connector of the catalogue, by its id (`incident-io`, `pagerduty`, `datadog`, `grafana`, `discord`, ...). Needs scope `connections:read`.
Create a connection POST
Add a connection. An `endpoint` on our cloud takes its key in `secret`, sealed in the vault and never answered; on an agent it takes `secret_ref` (`vault:`, `k8s:`, `env:` or `file:`), which we never resolve. A `webhook-in` answers its signing secret once, in `webhook_secret`, and its `receive_url`. Our cloud calls only hosts inside a verified domain of the account. A connector's id as `kind` (List connectors) takes `auth_mode`, `credentials` (its fields, sealed, never answered) and `config`; its test request runs first, a refused key stores nothing, and `label` names the account at the provider. Needs scope `connections:write`.