Saltar al contenido principal
POST
Open a snapshot run

Autorizaciones

Authorization
string
header
requerido

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

Encabezados

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]+$

Parámetros de ruta

id
string
requerido

The source id, src_….

Cuerpo

application/json
mode
string
requerido
Allowed value: "snapshot"
expected
integer<int64>
Rango requerido: x >= 0
idle_timeout_s
integer
predeterminado:3600
Rango requerido: 60 <= x <= 86400

Respuesta

The run, receiving.

id
string
requerido
Ejemplo:

"run_8c1e0f3a2b4d5c6e7f8a9b0c"

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

"receiving"

"sweeping"

"draining"

"deleting"

"waiting"

"verifying"

"reverifying"

attempt
integer
requerido
sweep
enum<string>
requerido

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

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

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

error
object | null
requerido

{code, message} of a failed run.

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

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