API Reference

Knowledge base

The company context that powers signal detection and outreach drafting. Manage its sections and read the workspace company profile.

List sections

GET/knowledge-base

Returns knowledge base sections ordered by position.

Response

{
  "data": [
    {
      "id": "...",
      "type": "value_prop",
      "title": "Why teams switch to us",
      "content_md": "We cut ramp time by...",
      "source_url": null,
      "is_ai_generated": true,
      "position": 3,
      "created_at": "2026-06-01T..."
    }
  ]
}

Add a section

POST/knowledge-base

Body fields

titlestringrequired

Section heading.

content_mdstringrequired

Section body, Markdown.

typestringoptional

Section type, e.g. overview, product, value_prop, icp, pricing, competitor, custom. Defaults to custom.

positionintegeroptional

Sort position. Defaults to the end.

Request

curl -X POST https://usehunch.co/api/v1/knowledge-base \
  -H "Authorization: Bearer hunch_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "product", "title": "Core product", "content_md": "Hunch is..." }'

Update a section

PATCH/knowledge-base/:id

Patchable fields:

titlestringoptional

Section heading.

content_mdstringoptional

Section body, Markdown.

typestringoptional

Section type.

positionintegeroptional

Sort position.

Delete a section

DELETE/knowledge-base/:id

Response

{ "data": { "id": "...", "deleted": true } }

Get the company profile

GET/company-profile

Returns the workspace company profile that seeds the knowledge base.

Response

{
  "data": {
    "name": "Hunch",
    "domain": "usehunch.co",
    "logo_url": "...",
    "business_context": "Hunch surfaces buying signals for B2B sales teams...",
    "scraped_meta": { "...": "..." },
    "updated_at": "2026-06-20T..."
  }
}