الانتقال إلى المحتوى الرئيسي
POST
Open a snapshot run

التفويضات

Authorization
string
header
مطلوب

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

الترويسات

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

معلمات المسار

id
string
مطلوب

The source id, src_….

الجسم

application/json
mode
string
مطلوب
Allowed value: "snapshot"
expected
integer<int64>
النطاق المطلوب: x >= 0
idle_timeout_s
integer
افتراضي:3600
النطاق المطلوب: 60 <= x <= 86400

الاستجابة

The run, receiving.

id
string
مطلوب
مثال:

"run_8c1e0f3a2b4d5c6e7f8a9b0c"

source_id
string | null
مطلوب
kind
enum<string>
مطلوب
الخيارات المتاحة:
snapshot,
import,
delete,
purge
trigger
enum<string>
مطلوب
الخيارات المتاحة:
api,
schedule,
janitor,
purge,
connect
state
enum<string>
مطلوب
الخيارات المتاحة:
queued,
running,
succeeded,
failed,
canceled
phase
string | null
مطلوب
أمثلة:

"receiving"

"sweeping"

"draining"

"deleting"

"waiting"

"verifying"

"reverifying"

attempt
integer
مطلوب
sweep
enum<string>
مطلوب

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

الخيارات المتاحة:
none,
applied,
held,
blocked
sweep_reason
string | null
مطلوب
expected
integer<int64> | null
مطلوب
counts
object
مطلوب

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

error
object | null
مطلوب

{code, message} of a failed run.

created_at
string<date-time>
مطلوب
started_at
string<date-time> | null
مطلوب
finished_at
string<date-time> | null
مطلوب
progress
object

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