Operations API
Poll long-running Ardent work to completion
?wait=10 to long-poll: the server holds the request up to that many seconds (max 10) and answers early if the operation finishes. This cuts most polling loops to a single line.
Add ?wait=10 to long-poll: the server holds the request up to that many seconds (max 10) and answers early if the operation finishes. This cuts most polling loops to a single line.
Representative response:
stage is a machine token; stage_label is the human-readable version for progress displays.
Status values
Results
When an operation completes,result holds the outcome. For branch_create operations, result contains the full branch details, including branch_url — that’s where automation picks up the connection string. See Branches for the shape.
Polling loop
error, fix the cause, and start a new supported action rather than assuming the old operation will recover.Authorizations
Ardent API key (sk-ard_live_… / sk-ard_test_…) or a dashboard session token.
Path Parameters
Query Parameters
Optionally wait up to this many seconds for a terminal operation state. Omit for the existing immediate poll response.
0 <= x <= 10Response
Current operation state. On completed, result holds the outcome — for branch_create, the full branch details.
When the operation was created.
Operation ID.
Organization the operation belongs to.
ID of the resource the operation acts on (the branch ID for branch create).
Current status. completed and failed are terminal.
pending, running, completed, failed The kind of work this operation tracks, for example branch_create.
connector_engine_setup, connector_reset, connector_deep_reset, connector_discovery, connector_delete, connector_secret_purge, connector_rollout, connector_replication_rollback, connector_debezium_cutover, connector_debezium_shadow_cleanup, environment_deploy, environment_destroy, branch_create, branch_delete When the operation was last updated.
When the operation finished. Null until then.
Error message when the operation failed.
Best-effort completion percentage. Null when no estimate is available.
0 <= x <= 100Result payload on completion; for branch create, includes branch_url.
Connector setup progress detail. Present only for connector engine setup.
Raw progress token, kept for released CLIs. Read stage_label instead.
Human-readable stage; null means the operation has not started yet.
When work started. Null until then.