Lexicon Garden

network.bsky.jetstream.getImportStatus

Report the status of a timestamp-import job: lifecycle state, current phase, per-phase progress, and (on completion) the parse/mutation totals. With no job parameter, reports the current or most recent job. Bearer-token gated: without a configured token the endpoint always returns 401.

Repository @bsky-lexicons.bsky.social did:plc:4v4y5r3lwsbtmsxhile2ljac namespace authority
Details · query
Kindquery
Authorityjetstream.bsky.network
Indexed
Compare Edit in builder → Fork →

Query

query · GET

Parameters

query string

job

string

Job id returned by importTimestamps. When omitted, the current or most recent job is reported.

Output

application/json

bucketed

boolean

Whether Phase A+B completed (the offset files are durable).

error

string

Failure detail; present only when state is failed.

finishedAt

string · datetime

Present only for a terminal job.

job

requiredstring

Job id.

phase

string

Current phase: parse_bucket (Phase A+B) or apply (Phase C).

  • knownValues: parse_bucket | apply

rowsCorruptOffset

integer
  • minimum: 0

rowsMatchedAllVersions

integer
  • minimum: 0

rowsMatchedSpecific

integer
  • minimum: 0

rowsMutated

integer
  • minimum: 0

rowsRejected

integer
  • minimum: 0

rowsTotal

integer
  • minimum: 0

rowsValid

integer
  • minimum: 0

segmentsApplied

integer

Segments processed so far in Phase C.

  • minimum: 0

segmentsExamined

integer
  • minimum: 0

segmentsPatched

integer
  • minimum: 0

segmentsToApply

integer

Segments Phase C will process (after resume-skips).

  • minimum: 0

specificCidsUnmatched

integer
  • minimum: 0

state

requiredstring

Lifecycle state.

  • knownValues: running | complete | failed

submittedAt

string · datetime

Errors

JobNotFound

No import job matches the supplied id, or no job has ever run when the id is omitted.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • network.bsky.jetstream.importTimestamps

    procedure

    Submit a timestamp-import job. The referenced CSV is staged server-local out-of-band and named by a path confined to the server's configured import directory (paths escaping it via .. or a symlink are rejected). The job runs asynchronously and shares the segment-rewrite lock with delete-compaction, so only one import runs at a time; a concurrent submit is rejected. Bearer-token gated: without a configured token the endpoint always returns 401.

  • town.delve.video.getUploadStatus

    query not from the namespace authority

    Get the authoritative status of the upload phase. Terminal states remain readable. completedJobId and jobStatus are present only for completed sessions; failureReason is present only for failed sessions.