API · POST
POST /v1/workflows/{id}/replay
Replay a historical workflow against a current or proposed agent version.
Overview
POST /v1/workflows/{id}/replay
Replays a historical workflow against a target agent version. Useful for validating bug fixes, regression testing, and analyzing the effect of policy changes.
All xyner API calls require an OAuth2 bearer token with the appropriate scope. Every request is identity-bound and audit-captured.
Request
Example request
{
"workflow_id": "wf_01H8Z",
"target_agent_version": "[email protected]",
"dry_run": true
}
Response
Example response
A successful response has shape:
{
"replay_id": "rpl_01H9A",
"original_outcome": "routed",
"replay_outcome": "routed",
"delta": {
"steps_added": 0,
"steps_changed": 1,
"steps_removed": 0,
"tool_calls_changed": 0
},
"viewer_url": "https://app.xyner.ai/replays/rpl_01H9A"
}
Notes
Things worth knowing
Useful behavioural details for this endpoint.
- All endpoints support OpenTelemetry trace-context propagation via standard W3C headers.
- Idempotency keys are honoured for 24 hours (or longer for endpoints that explicitly support extended idempotency).
- Errors follow RFC 7807 problem+json with a stable error code in
type. - Every successful action produces one or more audit records, queryable via /v1/audit/query.
- Rate limits apply per-tenant; current limits are returned in
X-RateLimit-*response headers.
See also
Related endpoints and concepts
This endpoint is part of the broader xyner platform API. For an end-to-end view, see the platform overview and the documentation hub.
Get started
Ready to put autonomous agents to work?
See xyner in your environment with a guided executive demo.