List jobs

GET 
/v2/jobs

List jobs for the account. Jobs are background processes like replacing the filterable metadata attributes.

Request

Query Parameters

corpus_key CorpusKey[]

Possible values: <= 50 characters, Value must match regular expression [a-zA-Z0-9_\=\-]+$

The unique key identifying the corpus with the job.

after date-time

Get jobs after a date time.

state JobState[]

Possible values: [unknown, queued, started, completed, failed, failed_will_retry, aborted]

Indicates the states the jobs can be in.

limit int32

Possible values: >= 1 and <= 100

Default value: 10

The maximum number of documents to return at one time.

page_key string

Used to the retrieve the next page of documents after the limit has been reached.

Responses

200

List of jobs.

application/json

Schema

Schema

jobs object[]
An array of jobs.
Array [
id string
Possible values: Value must match regular expression job_.+$
The ID of the job.
type string
Possible values: [rebuild_vector_index, replace_filter_attributes, unknown]
The type of job.
corpus_keys CorpusKey[]
Possible values: <= 50 characters, Value must match regular expression [a-zA-Z0-9_\=\-]+$
The corpora that this job belongs to. It may not belong to any corpora.
state JobState
Possible values: [unknown, queued, started, completed, failed, failed_will_retry, aborted]
created_at date-time
Specifies when the job was created.
started_at date-time
Specifies when the job was started.
completed_at date-time
Specifies when the job was completed.
]
metadata object

The standard metadata in the response of a list operation.

page_key string

When requesting the next page of this list, this is needed as a query parameter.

Example (from schema)

{
  "jobs": [
    {
      "id": "string",
      "type": "rebuild_vector_index",
      "corpus_keys": [
        "my-corpus"
      ],
      "state": "unknown",
      "created_at": "2024-07-11T20:03:46.408Z",
      "started_at": "2024-07-11T20:03:46.408Z",
      "completed_at": "2024-07-11T20:03:46.408Z"
    }
  ],
  "metadata": {
    "page_key": "string"
  }
}

403

Permissions do not allow listing jobs.

application/json

Schema

Schema

messages message[]

The messages describing why the error occurred.

request_id string

The ID of the request that can be used to help Vectara support debug what went wrong .

Example (from schema)

{
  "messages": [
    "Internal server error."
  ],
  "request_id": "string"
}

Loading...