Agents

Answer Agent Discovery

Record ONE graded answer.

grade is not decoration. A red grade stores NO VALUE and burns a rung of the probe ladder - the agent asks again a different way rather than keeping a guess. Storing an unusable answer as data is how a confident, wrong ICP gets built.

field_key must be a real framework field; anything else is refused by the handler by name rather than being written as a stray key.

post/agent/onboarding/discovery/answer

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/agent/onboarding/discovery/answer
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

field_keystring required

Which discovery field this answers.

valueunknown
gradestring required

Confidence in the answer: green (certain), amber (a working assumption) or red (a guess). Amber and red answers come back in coverage.amber_fields so they can be revisited.

sourcestring

Who supplied it. Defaults to user.

move_numberinteger nullable

Interview move this answers.

session_idstring nullable

Canvas session to report into.

Response

Successful Response

dataOnboardingPayload required

An open envelope for an onboarding or discovery result.

Open on purpose. Discovery state carries a per-field coverage matrix whose field set is the product's own onboarding questionnaire - it changes as the questionnaire does, and a pinned mirror would silently DROP a field the customer had answered. On a surface whose whole job is "what do we still not know about you", a dropped field reads as an answered question.

Changes

No recorded changes to this operation across all 2 revisions of this API.