Skip to main content
POST
/
sessions
/
{id}
/
knowledge
Generate structured session knowledge
curl --request POST \
  --url https://app.harmonica.chat/api/v1/sessions/{id}/knowledge \
  --header 'Authorization: Bearer <token>'
{
  "knowledge": {
    "decisions": [
      {
        "label": "<string>",
        "summary": "<string>",
        "evidence": [
          "<string>"
        ],
        "phase": "<string>"
      }
    ],
    "actions": [
      {
        "description": "<string>",
        "evidence": [
          "<string>"
        ],
        "owner": "<string>",
        "due": "<string>"
      }
    ],
    "tensions": [
      {
        "summary": "<string>",
        "sides": [
          "<string>"
        ],
        "evidence": [
          "<string>"
        ]
      }
    ],
    "claims": [
      {
        "text": "<string>",
        "evidence": [
          "<string>"
        ],
        "phase": "<string>",
        "strength": 0.5
      }
    ],
    "metadata": {
      "generatedAt": 123,
      "model": "<string>"
    },
    "gaps": [
      "<string>"
    ]
  },
  "reason": "<string>"
}

Authorizations

Authorization
string
header
required

API key authentication. Pass your key as a Bearer token. Keys use the format hm_live_<32 hex chars>. Generate keys from your Harmonica dashboard settings.

Path Parameters

id
string<uuid>
required

Session ID

Response

Generated (or skipped) session knowledge

status
enum<string>
required

generated when knowledge was produced; skipped on a no-op.

Available options:
generated,
skipped
knowledge
object
required

The generated knowledge, or null when skipped.

reason
string

Present when status is skipped.