---
title: "Project Agent Discovery"
method: POST
path: "/agent/onboarding/discovery/project"
tags: ["Agents"]
---

# Project Agent Discovery

`POST /agent/onboarding/discovery/project`

## Request

- Base URL: `https://be.graph8.com/api/v1`
- URL: `https://be.graph8.com/api/v1/agent/onboarding/discovery/project`
- Auth: HTTP bearer

Turn the interview into real objects: an ICP, a persona, AND A CAMPAIGN.

Takes no body. The campaign is the part that surprises people, so it is
said plainly: this CREATES a campaign and provisions its Work channel. It
does not SEND anything - the campaign sits there for a human to launch -
which is why this is a `write` and not an `external` operation.

IDEMPOTENT: the projection is idempotent by object name, and the build is
claim-fenced, so calling twice updates the same ICP and returns the same
campaign rather than minting a second one.

PARTIAL SUCCESS IS A REAL OUTCOME. A refused build does not fail the
projection, because the ICP and persona are committed by the time the build
runs and reporting the whole call as failed would send someone to re-run a
projection that worked. Read `campaign.ok` in the body; a blocked build
names what is still open rather than counting it.

## Headers

- `Authorization` string, nullable
- `X-Target-Org-Id` string, nullable

## Response `200`

Successful Response

- ApiResponseOnboardingPayload
  - `data` OnboardingPayload, 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.
  - `pagination` PaginationMeta
    - `page` integer, required: Current page number (1-indexed)
    - `limit` integer, required: Items per page
    - `total` integer, required: Total number of items
    - `has_next` boolean, required: Whether there are more pages
    - `next_cursor` string, nullable: Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers.
    - `total_available` integer, nullable: Search endpoints only: how many records really match, when known. Can be larger than `total`, which is capped at the 10,000 results that can be paged. For company search this is a distinct-company estimate. Null when unknown; absent outside search.
    - `total_is_lower_bound` boolean, nullable: Search endpoints only: true when more records match than `total` shows (the result set is larger than the 10,000 results that can be paged). Absent outside search.
    - `notes` string[], nullable: Search endpoints only: plain-language notes about the result, e.g. that more records match than can be paged, or that a reversed `between` range was put in order.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/graph8/apis/graph8-developer-api.md) · [All operations](https://skmtc.dev/graph8/apis/graph8-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/graph8/apis/graph8-developer-api/revisions/89fc11143b70?raw)