Agents

Submit Agent Domain Response

Answer the agent's "is this your company domain?" card.

domain is REQUIRED when confirmed is false and ignored when it is true. The app enforces that with a 422 of its own, and this mirrors the model rather than the check, so a missing domain is refused by the handler with its own message rather than by a copy here that could drift.

A corrected domain is persisted immediately, so a late edit is not orphaned once the polling activity has already exited.

post/agent/onboarding/domain-response

Request

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

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

session_idstring required

The proactive-setup canvas session id.

card_idstring required

The domain_confirmation card id.

confirmedboolean required

True = the pre-filled domain is correct as it stands.

domainstring nullable

The corrected company domain. REQUIRED when confirmed is false; ignored when it is true.

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 3 revisions of this API.