API reference

API: Knowledge base

Method	Path	What it does	Scope
GET	`/v1/kb`	The company knowledge base: sections (positioning, products, proof points, voice, ICP, exclusions, playbooks…) and the suggested ones not written yet	`knowledge:read`
GET	`/v1/kb-proposals`	Text offered to knowledge base sections from proof points and interview syntheses	`knowledge:read`
POST	`/v1/kb-proposals/:id/accept`	Accept a proposal: its text is added to the section as a new version (owners, from the app) (web app only)	`settings:write`
POST	`/v1/kb-proposals/:id/dismiss`	Dismiss a proposal (nothing is written) (web app only)	`settings:write`
DELETE	`/v1/kb/:key`	Archive a section (its revisions stay)	`settings:write`
GET	`/v1/kb/:key`	One section with its revisions	`knowledge:read`
PUT	`/v1/kb/:key`	Write a section (owners: every agent reads it; each save is a new version; send the version you edited)	`settings:write`

Examples

GET /v1/kb

The company knowledge base: sections (positioning, products, proof points, voice, ICP, exclusions, playbooks…) and the suggested ones not written yet

curl -s "https://api.closefinch.com/v1/kb" \
  -H "Authorization: Bearer $RA_API_KEY"

const res = await fetch(`https://api.closefinch.com/v1/kb`, {
  method: "GET",
  headers: { authorization: `Bearer ${process.env.RA_API_KEY}` },
});
const data = await res.json();

GET /v1/kb-proposals

Text offered to knowledge base sections from proof points and interview syntheses

curl -s "https://api.closefinch.com/v1/kb-proposals" \
  -H "Authorization: Bearer $RA_API_KEY"

const res = await fetch(`https://api.closefinch.com/v1/kb-proposals`, {
  method: "GET",
  headers: { authorization: `Bearer ${process.env.RA_API_KEY}` },
});
const data = await res.json();

DELETE /v1/kb/$KEY

Archive a section (its revisions stay)

curl -s -X DELETE "https://api.closefinch.com/v1/kb/$KEY" \
  -H "Authorization: Bearer $RA_API_KEY"

const res = await fetch(`https://api.closefinch.com/v1/kb/${key}`, {
  method: "DELETE",
  headers: { authorization: `Bearer ${process.env.RA_API_KEY}` },
});
const data = await res.json();

GET /v1/kb/$KEY

One section with its revisions

curl -s "https://api.closefinch.com/v1/kb/$KEY" \
  -H "Authorization: Bearer $RA_API_KEY"

const res = await fetch(`https://api.closefinch.com/v1/kb/${key}`, {
  method: "GET",
  headers: { authorization: `Bearer ${process.env.RA_API_KEY}` },
});
const data = await res.json();

PUT /v1/kb/$KEY

Write a section (owners: every agent reads it; each save is a new version; send the version you edited)

curl -s -X PUT "https://api.closefinch.com/v1/kb/$KEY" \
  -H "Authorization: Bearer $RA_API_KEY" \
  -H "content-type: application/json" \
  -d '{}'

const res = await fetch(`https://api.closefinch.com/v1/kb/${key}`, {
  method: "PUT",
  headers: { authorization: `Bearer ${process.env.RA_API_KEY}`, "content-type": "application/json" },
  body: JSON.stringify({}), // fields: see the OpenAPI schema
});
const data = await res.json();

Request and response schemas: https://www.closefinch.com/openapi.json. All resources: API reference.