InOrbitdocs
Sign in
Docs
Have a token? Manage tokens in the console
POST
/v1/rfcs/spaces/{space_id}/documents/{document_id}/versions

Save new text as the next version with a message. Send the version you started from: if someone saved after it, the answer is 409 and nothing is overwritten. The checks run on every save and their findings come back.

Needs scope rfc:write.

Authorization

bearer
headerAuthorizationBearer <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.

Path Parameters

space_id*string

The space's id, lab_ and a ULID, from List spaces.

document_id*string

The document's id, ldoc_ and a ULID, from List documents.

Request Body

iohr.rfcs.v1.SaveDocumentRequest; path variables override their fields

application/json
  1. body

iohr.rfcs.v1.SaveDocumentRequest

base_version?integer
Formatint32
document_id?string
message?string
space_id?string
text?string

Response Body

iohr.rfcs.v1.SaveDocumentResponse

application/json
  1. response

iohr.rfcs.v1.SaveDocumentResponse

document?

iohr.rfcs.v1.Document

findings*array<>
version*integer
Formatint32
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.rfcs.saveDocument("<space_id>", "<document_id>", {    message: "<message>",    text: "<text>",  });  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.

{  "document": {    "access": "string",    "child_index": 0,    "children": 0,    "created_at": "string",    "created_by": "string",    "current_version": 0,    "display_number": "string",    "document_id": "string",    "headline": "string",    "headline_note": "string",    "kind": "string",    "measures_id": "string",    "number": 0,    "parent_id": "string",    "path": "string",    "public": true,    "slug": "string",    "source": "string",    "space_id": "string",    "stage": "string",    "status": "string",    "summary": "string",    "superseded_by": "string",    "supersedes_id": "string",    "title": "string",    "updated_at": "string"  },  "findings": [    {      "line": 0,      "message": "string",      "rule": "string"    }  ],  "version": 0}

Create a document POST

A new RFC, study, PRD (product intent) or ADR (one decision record) from a template, with the next free number of its kind in the account. Sub-RFCs name their parent and get the next part number under it. Needs scope `rfc:write`.

List versions GET

Every version of a document, newest first: who saved it, when, the message and the lines added and removed. Needs scope `rfc:read`.