Skip to main content
POST
Seed, inspect or rebuild the listening map

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

Body

application/json
mode
enum<string>
default:seed

Processing mode

Available options:
seed,
update,
status,
rebuild
expectedEligibilityDigest
string

Required for rebuild; use eligibility_digest from a fresh status response

Response

Scratchpad result

status
enum<string>
required

completed — all messages processed. partial — a batch failed or processing is incomplete; request continuation explicitly. no_data — no user messages in session. busy — another writer owns the current analysis claim. exists/empty — status mode response.

Available options:
completed,
partial,
no_data,
busy,
exists,
empty
themes
integer
required

Number of themes identified

participants
integer
required

Number of participants tracked

batches_processed
integer

Batches completed in this call

batches_total
integer

Total batches needed for remaining messages

eligibility_digest
string

Opaque token identifying the captured conversation input and context inventory; returned in status mode

needs_rebuild
boolean

Stored map has no verified current input basis and requires deliberate refresh; returned in status mode