Lexicon Garden

network.bsky.jetstream.importTimestamps

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.

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

Procedure

procedure · POST

Input

application/json

path

requiredstring

Server-local path to the plain (uncompressed) import CSV, resolved within the configured import directory. May be relative to that directory or an absolute path inside it.

Output

application/json

job

requiredstring

Opaque job id. Poll getImportStatus with this id to observe progress and the terminal result.

Errors

ImportInProgress

Another import job is already running; only one runs at a time.

ImportNotReady

Timestamp import requires the server to be in steady state with the live writer running.

InvalidPath

The path is empty, escapes the import directory, does not exist, or is not a regular file.

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.getImportStatus

    query

    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.