Skip to main content
POST
Request JSON

Authorizations

Authorization
string
header
required

A run-bound Veryfront runtime event-writer token in the Authorization header.

Headers

Idempotency-Key
string

Stable retry key required for Task and Workflow appends; optional for Agent appends.

Required string length: 1 - 128

Path Parameters

run_id
string<uuid>
required

Body

application/json
events
object[]
required
Required array length: 1 - 100 elements
expected_previous_event_id
integer | null
Required range: x >= 0
expected_previous_external_event_sequence
integer | null
Required range: x >= 0
external_sequence_scope
enum<string>
Available options:
agent,
publish_only
runtime_observations
object

Response

Persisted event cursor

latest_event_id
integer
required
Required range: x >= 0
appended_count
integer
required
Required range: x >= 0
run_id
string<uuid>
required
latest_external_event_sequence
integer
Required range: x >= 0
model_call_captures
object[]