Agent

Create Agent Run

Start a durable agent run.

"Run" is the public noun; the stored row is a work item and every internal name says so. The same translation app_pages_router makes for dashboards, and for the same reason: the public contract should read the way a builder thinks, not the way the table is named.

workflow_started: false is a NORMAL outcome, not an error. The row is persisted either way; a false means the Temporal worker did not pick it up on this attempt and the reason is carried alongside it.

post/agent/runs

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/agent/runs
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

agent_idstring required

Which agent drives the loop: 'onboarding', 'dialer_setup', 'sequencer_setup', 'campaign_run', 'voice_setup', 'marketplace', 'dev_setup', or a free-form value for an ad-hoc session.

titlestring required
goalstring required

Free text the planner works from.

entry_pointstring nullable
visibilitystring

'private' (default) keeps the run yours. 'shared' lets the organization see it, though only you can cancel it.

subject_account_idstring nullable

Bind the run to a company.

subject_campaign_idstring nullable

Bind the run to a campaign.

session_titlestring nullable
seed_messagestring nullable

An opening user turn, rendered as the first message.

skill_modestring nullable

'web_search' | 'deep_thinking' | 'research'. Unknown values are ignored.

Response

Successful Response

Changes

No recorded changes to this operation across all 2 revisions of this API.