BuildBetter.ai

Attach a Success knowledge gap recommendation to a project and mark it attached.

Begin a server-held BBCM edit session. Apply the returned session with apply-knowledge-page-edit.

Build a starter Hasura-style list query for a specific type. Uses `limit` and discovered query root fields.

Start durable persona creation from generated concepts. The confirmed call returns a jobId; poll get-job after pollAfterSeconds.

Start durable persona creation from person-type template IDs. The confirmed call returns a jobId; poll get-job after pollAfterSeconds.

Start durable persona creation from recommendations. The confirmed call returns a jobId; poll get-job after pollAfterSeconds.

Cancel a pending durable BuildBetter job before its worker claims it. Running jobs cannot be reported as cancelled when their external work may already commit.

Request cancellation of a queued or running Knowledge file import.

Cancel a pending synthetic-persona generation operation before a worker claims it. Running work cannot be reported as cancelled because its provider call or durable writes may already be committing.

Cancel work that has not yet started for a durable Smart Tag backfill. Work already running may finish and remains visible in the operation totals.

Cancel a pending or running Smart Tag evaluation or auto-improvement operation after explicit user approval. Cancellation stops new model work and preserves credits already committed before the cancellation won the operation lock.

Claim an unattributed workspace-visible agent session so you can manage its visibility and associations. Organization admins may also recover a private session whose prior owner is no longer active. Requires explicit user approval.

Connect a survey to a BuildBetter View so completed responses enter the existing analysis and signal-extraction flow.

Create a new blank prototype canvas the agent can build up with append-prototype-version.

Create an authorized Knowledge publication destination.

Queue a governed Knowledge export and return its durable operation identifier instead of a large archive payload.

Stage a bounded set of file bytes and queue a governed Knowledge import. Returns a durable operation identifier instead of importing inline.

Create a governed Knowledge page from empty content or canonical BBCM Markdown.

Create an authorized GitHub, Mintlify, or Notion Knowledge source using existing provider capability rules. Mintlify is not a standalone integration: a Mintlify source syncs a Mintlify docs repository through the GitHub connection.

Create a synthetic persona from an already-supplied profile. This does not generate AI output and does not require credit confirmation.

Create a chat thread for a synthetic persona.

Create a synthetic persona company from an already-supplied profile. This does not generate AI output and does not require credit confirmation.

Create a persona panel immediately when it contains only direct members. replica_set members require a client-generated idempotencyKey and credit confirmation, then return an operationId to poll with get-persona-generation-operation every 15 seconds.

Create one named study to hold related persona test runs. Reuse its ID as studyId in create-persona-test-run for every version or repeat. Optionally group existing runIds without rerunning them. This only organizes research and spends no research credits; it does not start any runs.

Create one run inside a study using studyId, with a short name for the tested version. For a related batch, create-persona-study once and reuse its ID for every run; do not create a study per variant. For one pick-one comparison, use studyType=single_choice with choiceOptions in a single run. Supports personaIds or panelId, prompt images, and choice option images. First call returns a credit estimate and confirmation token; rerun with confirmationToken to execute.

Mutating OAuth-only action: create a Projects V2 project. The returned id works with get-project. Use the returned publicId for associate-agent-session and other resource associations. Use only after explicit user approval.

Mint a share link for a prototype's rendered screen. The link is private: only signed-in members of the owning organization can open it, and anonymous visitors get a 404. Public, login-free sharing is not enabled yet, so do not forward this URL to anyone outside the organization.

Create a persona variant project for a prototype screen (audience: personaIds XOR panelId).

Publish a skill immediately in a skillset that the OAuth user can write. The content must contain the complete Markdown skill.

Create an organization-readable skillset. This OAuth-only action requires organization administrator access and returns the published skillset.

Start the product wizard workflow for an existing tag-group member selected from list-tag-groups and list-tag-group-tags. Preserve the user's intended category breadth: generic feature mentions must stay generic unless the user explicitly asks for requests, complaints, praise, or another narrower intent. This does not create another tag or group and does not activate live tagging.

Create an editable candidate revision from the current live Smart Tag. The live version remains active until the candidate is tested and published.

Create a complete native survey in one operation. When activate is true, persisted survey/recipient data is returned immediately and email invitation fan-out continues asynchronously in bounded pages; poll get-survey about every 15 seconds.

Create a visible tag group only when the user explicitly asks for a new group after reviewing list-tag-groups. Do not use this as an incidental step in creating a tag. The creator receives write access and the organization receives read access by default.

Customize the respondent page with logo/background URLs, intro and thank-you copy, light or dark theme, primary hex color, and alignment.

Soft-delete a changelog entry.

Permanently delete a tag by canonical member ID. This removes its Smart Tag workflow and every existing call and signal association while retaining immutable billing audit history.

Delete a never-published Smart Tag draft or candidate revision. Live and historical published versions cannot be deleted.

Destructive OAuth-only action: permanently delete a native survey after explicit user confirmation.

Delete an empty tag group. Remove its tags first.