Agent Runtime

Create a persisted agent run

Creates a deterministic persisted agent run. The run can complete immediately, pause before execution, or wait for approval before executing its selected tool.

post/v1/agent/runs

Request

  • Base URL: https://api.algenta.ai
  • URL: https://api.algenta.ai/v1/agent/runs
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

taskstring required

What should the agent do?

contextobject nullable

Additional context or data

toolsstring[] nullable

Tools to make available: search, simulate, optimize, calculate, summarize

max_stepsinteger

Maximum execution steps

output_formatstring

Output format: text, json, markdown

approval_mode'auto' | 'manual'

Execution mode: auto executes immediately, manual waits for approval.

start_pausedboolean

If true, persist the run in paused state until /resume is called.

Response

Successful Response

run_idstring required
status'running' | 'paused' | 'requires_approval' | 'completed' | 'cancelled' required
taskstring required
output_formatstring required
approval_mode'auto' | 'manual' required
pending_action'resume' | 'approve' nullable
selected_toolstring nullable
tools_availablestring[]
tools_usedstring[]
request_hashstring nullable
decision_hashstring nullable
policy_snapshot_idstring nullable
schema_snapshot_idstring nullable
manifest_versionstring nullable
replayableboolean
artifact_refsstring[]
latest_checkpoint_idstring nullable
checkpoint_countinteger
source_run_idstring nullable
source_checkpoint_idstring nullable
created_atstring date-time required
updated_atstring date-time required
latency_msnumber nullable

Changes

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