Agents

Capture Agent Entry Point

Record which product the customer signed up for. FIRST WRITER WINS.

The entry point maps 1:1 to a plan template, so it chooses what the agent proposes doing first. It is a one-shot ATTRIBUTION, not a settable preference: if the org already has one, this call changes nothing and reports the existing value.

Read captured rather than the status code - a 200 with captured: false means someone else got there first, which is a normal outcome and not an error.

post/agent/onboarding/entry-point

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/agent/onboarding/entry-point
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

entry_point'dialer' | 'sequencer' | 'marketplace' | 'dev' | 'calendar' | 'email_inbox' | 'full' required

The signup entry point. Maps 1:1 to a plan template, so this chooses what the agent will propose doing first. FIRST WRITER WINS: if the org already has one captured, this call reports the existing value and changes nothing.

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.