API ReferenceKnowledge Bases

Get Import Job

Beta

Retrieve a single import job by ID. Poll this endpoint until status reaches a terminal state (completed / failed / cancelled).

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Path parameters

kb_idstringRequired
import_idstringRequired

Headers

Speechify-VersionstringOptional

Response

The import job.
idstring
kb_idstring
kindenum
statusenum

The one lifecycle vocabulary shared by every async job (batch calls, knowledge-base imports, agent-test runs, suite runs): pending → running → a terminal state.

  • pending - accepted but not yet executing (queued for a worker, or deferred to a future scheduled time).
  • running - actively executing.
  • completed - ran to conclusion. The single terminal-success verb. For a job that produces a pass/fail judgment (an agent-test run), this means it produced a verdict - read the separate verdict field for the judgment, not this status.
  • failed - could not complete (an infrastructure or input failure), distinct from a completed job whose verdict is failed.
  • cancelled - cancelled before reaching a natural terminal state.
totalinteger

Total URLs to process (the progress denominator).

completedinteger
URLs imported successfully.
failedinteger
URLs that failed to import.
paramsmap from strings to any

JSON blob whose shape depends on kind — typically url, max_pages, max_depth. The console reads it for display only.

created_by_uidstring
created_atdatetime
updated_atdatetime
started_atdatetime or null
ended_atdatetime or null
errorstring
upstream_job_idstring

Errors

401
Unauthorized Error
404
Not Found Error