agents

Run the agent graph

Executes the Cadencz agent graph for one request and returns the run with its full per-agent trace. Phase A route is 'answer' (a strict one-line assistant).

post/api/v1/agents/run

Request

  • Base URL: https://api.cadencz.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.cadencz.com/api/v1/agents/run
  • Auth: HTTP bearer

Request body

inputstring required

What the user is asking the agent graph to do.

tagsstring[]

Strict allow-list tags that steer the graph (e.g. #reddit, #hook, #shorten).

platformstring nullable

Optional target platform for this run.

brain_idstring nullable

Optional Brain id/slug to ground the run in saved product knowledge.

routestring

Graph route: 'answer' (strict one-line) or 'generate_post'.

read_sourcestring

Reader source: 'paste' | 'rss' | 'x' (x is flagged off in v1).

read_inputstring nullable

Optional material for the Reader agent — pasted text or an RSS URL.

Example request

{
  "input": "Write a launch post about our new Google sign-in.",
  "tags": [
    "#hook"
  ],
  "platform": "twitter"
}

Response

Successful Response

idstring required
workspace_idstring required
routestring required

The graph route (stored as the run 'stage').

statusstring required
tagsstring[] required
input_textstring nullable required
output_jsonobject required
errorstring nullable required
tokens_usedinteger required
model_providerstring nullable required
model_namestring nullable required
created_atstring date-time required
updated_atstring date-time required

Example response

{
  "created_at": "2026-07-13T10:00:00Z",
  "id": "run_123",
  "input_text": "Write a launch post about Google sign-in.",
  "model_name": "deepseek-chat",
  "model_provider": "deepseek",
  "output_json": {
    "text": "Google sign-in is live — one tap in, zero password resets."
  },
  "route": "answer",
  "status": "succeeded",
  "steps": [],
  "tags": [
    "#hook"
  ],
  "tokens_used": 56,
  "updated_at": "2026-07-13T10:00:01Z",
  "workspace_id": "wks_123"
}

Changes

No recorded changes to this operation across all 1 revision of this API.