API reference
Add or change a plan item
Create the item or change it. Send expected_version from the last read to refuse a write over a newer one (the answer is aborted); 0 writes whatever is there.
Needs scope coordinator:write.
bearerAuthorizationBearer <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.
plan_id*stringThe plan's id, from List plans.
item_id*stringThe item's id: a name you pick, unique in the plan.
iohr.coordinator.v1.UpsertPlanItemRequest; path variables override their fields
application/json- body
iohr.coordinator.v1.UpsertPlanItemRequest
account_id?stringexpected_version?integerint32holder?stringitem?iohr.coordinator.v1.PlanItem
item_id?stringplan_id?stringiohr.coordinator.v1.UpsertPlanItemResponse
application/json- response
iohr.coordinator.v1.UpsertPlanItemResponse
created*booleanitem?iohr.coordinator.v1.PlanItem
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.upsertPlanItem("<plan_id>", "<item_id>", { holder: "<holder>" }); 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.
{ "created": true, "item": { "ask_id": "string", "body": "string", "claim_fence": "string", "diagram": "string", "doc": "string", "held_until": "string", "holder": "string", "item_id": "string", "kind": "string", "parent": "string", "position": 0, "preview": "string", "prs": [ "string" ], "size": "string", "status": "string", "title": "string", "updated_at": "string", "updated_by": "string", "version": 0 }}