Jobs
Jobs

Create a v2 parsing job

Create a v2 parsing job.

post/v2/jobs

Request

  • Base URL: https://api.knowhereto.ai/api
  • URL: https://api.knowhereto.ai/api/v2/jobs
  • Auth: none declared

Headers

authorizationstring nullable

Bearer <token> OR internal signature auth

Request body

namespacestring nullable

Retrieval namespace; defaults to default

document_idstring nullable

Existing document ID for update flows

source_type'file' | 'url' required

Document source type

source_urlstring nullable

Source URL; required when source_type=url

file_namestring nullable

File name; required when source_type=file and must include the extension

data_idstring nullable

User-defined ID

document_metadataobject nullable

Display metadata copied to the published document, such as created_by_client and client_version.

Response

Successful Response

job_idstring required

Job ID

namespacestring nullable

Effective namespace

document_idstring nullable

Linked document ID

status'pending' | 'waiting-file' | 'running' | 'converting' | 'done' | 'failed' required

Job status

source_typestring required

Document source type

data_idstring nullable

User-defined ID

created_atstring date-time required

Creation time

upload_urlstring nullable

Upload URL

upload_headersobject nullable

Upload request headers

expires_ininteger nullable

URL expiration in seconds

Changes

No recorded changes to this operation across all 1 revision of this API.