Passer au contenu principal
POST
Open a snapshot run

Autorisations

Authorization
string
header
requis

A key from conare.ai/dashboard/keys with full access, some namespaces, or models only (/embed, /rerank, /v1, /v2/rerank, /parse).

En-têtes

Idempotency-Key
string

One key (a UUID) per logical write, sent again on each retry: a repeat within 24 hours replays the first successful answer.

Required string length: 1 - 255
Pattern: ^[\x21-\x7e]+$

Paramètres de chemin

id
string
requis

The source id, src_….

Corps

application/json
mode
string
requis
Allowed value: "snapshot"
expected
integer<int64>
Plage requise: x >= 0
idle_timeout_s
integer
défaut:3600
Plage requise: 60 <= x <= 86400

Réponse

The run, receiving.

id
string
requis
Exemple:

"run_8c1e0f3a2b4d5c6e7f8a9b0c"

source_id
string | null
requis
kind
enum<string>
requis
Options disponibles:
snapshot,
import,
delete,
purge
trigger
enum<string>
requis
Options disponibles:
api,
schedule,
janitor,
purge,
connect
state
enum<string>
requis
Options disponibles:
queued,
running,
succeeded,
failed,
canceled
phase
string | null
requis
Exemples:

"receiving"

"sweeping"

"draining"

"deleting"

"waiting"

"verifying"

"reverifying"

attempt
integer
requis
sweep
enum<string>
requis

A snapshot's deletes: applied, held (over 10% and 1,000 at once, until a run 24 h later agrees) or blocked (none).

Options disponibles:
none,
applied,
held,
blocked
sweep_reason
string | null
requis
expected
integer<int64> | null
requis
counts
object
requis

What the run did, e.g. seen, planned, deleted; an import's lines, created, updated, rejected.

error
object | null
requis

{code, message} of a failed run.

created_at
string<date-time>
requis
started_at
string<date-time> | null
requis
finished_at
string<date-time> | null
requis
progress
object

A running import's progress, measured over the last minute.