BuildBetter.ai

Associate one uploaded ZeroShot session with one or more companies, Projects V2 projects, or signals using their public ids. context attaches the whole session; reference records that a resource, such as a signal, was used during the session. Requires explicit user approval and OAuth user context.

associate-agent-session

Associate an uploaded ZeroShot agent session with one or more BuildBetter company/account ids so future account work can discover and reuse that session. Use search-accounts first when the user supplies a name such as Brex. Requires explicit user approval and OAuth user context.

associate-agent-session-with-account

Associate an authorized organization skill with a managed Knowledge page.

associate-knowledge-page-skill

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

attach-knowledge-gap-to-project

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

begin-knowledge-page-edit

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

build-query

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

bulk-create-personas-from-generated-concepts

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

bulk-create-personas-from-person-types

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

bulk-create-personas-from-recommendations

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.

cancel-job

Request cancellation of a queued or running Knowledge file import.

cancel-knowledge-file-import-operation

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-persona-generation-operation

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-smart-tag-backfill

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.

cancel-smart-tag-operation

Cancel an unapplied taxonomy proposal. To revise it, use propose-taxonomy-changes with replacesProposalId. This does not change live taxonomy.

cancel-taxonomy-proposal

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.

claim-agent-session

Bind an intercept-capable survey to one existing feedback widget. Only recipients with a verified widget identity can receive it.

configure-survey-intercept

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

connect-survey-to-view

Count recordings exactly, with no result cap, optionally per person, company, or calendar period (day, week, month, quarter, year in timeZone). The phrase is read the same way as search-calls, including its name widening and `discovery`. Groups come 100 at a time; pass `cursor` back alone for the next groups. To list the recordings, use search-calls.

count-recordings

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

create-blank-prototype

Create an authorized Knowledge publication destination.

create-knowledge-destination

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

create-knowledge-export

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

create-knowledge-file-import

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

create-knowledge-page

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

create-persona

Create a chat thread for a synthetic persona.

create-persona-chat

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

create-persona-company

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-persona-panel

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-persona-study

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.

create-persona-test-run

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.

create-project

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-prototype-share-link

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

create-prototype-variant-project

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

create-skill

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

create-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-smart-tag-draft

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

create-smart-tag-revision

Create a native survey with questions, delivery copy, branding, optional workspace-person recipients and View connections. Activation can queue real invitations; default activate is false.

create-survey

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.

create-tag-group

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

customize-survey