List corpora

GET 
/v2/corpora

List corpora in the account. The corpus objects that are returned are less detailed than the direct corpus retrieval operation.

Request

Query Parameters

limit int32

Possible values: >= 1 and <= 100

Default value: 10

The maximum number of corpora to return at one time.

filter string

A regular expression to filter the corpora by their name or summary.

page_key string

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

Responses

200

List of corpora.

application/json

Schema

Schema

corpora object[]
Array [
id string
Possible values: Value must match regular expression crp_[0-9]+$
Vectara ID of the corpus.
key CorpusKey
Possible values: <= 50 characters, Value must match regular expression [a-zA-Z0-9_\=\-]+$
A user-provided key for a corpus.
name string
Name for the corpus. This value defaults to the key.
description string
Corpus description.
enabled boolean
Specifies whether the corpus is enabled or not.
chat_history_corpus boolean
Indicates that this corpus does not store documents amd stores chats instead.
queries_are_answers boolean
Default value: false
Queries made to this corpus are considered answers, and not questions. This swaps the semantics of the encoder used at query time.
documents_are_questions boolean
Default value: false
Documents inside this corpus are considered questions, and not answers. This swaps the semantics of the encoder used at indexing.
encoder_id string
Possible values: Value must match regular expression enc_[0-9]+$
The encoder used by the corpus.
filter_attributes object[]
The new filter attributes of the corpus.
Array [
name stringrequired
The JSON path of the filter attribute in a document or document part metadata.
level stringrequired
Possible values: [document, part]
Indicates whether this a document or document part metadata filter.
description string
Description of the filter. May be omitted.
indexed boolean
Default value: true
Whether an index is created for the filter. Creating an index will improve query latency when using the filter.
type stringrequired
Possible values: [integer, real_number, text, boolean, list[integer], list[real_number], list[text]]
The value type of the filter.
]
custom_dimensions object[]
The custom dimensions of all document parts inside the corpus.
Array [
name stringrequired
The name of the custom dimension.
indexing_default double
Default value of a custom dimension on a document part if the custom dimension value is not specified when the document part is indexed.
A value of 0 means that custom dimension is not considered.
querying_default double
Default value of a custom dimension for a query if the value of the custom dimension is not specified when querying the corpus.
A value of 0 means that custom dimension is not considered.
]
limits object
used_bytes int64
The number of bytes contained in the corpus.
max_bytes int64
The maximum number of bytes the corpus can be.
max_metadata_bytes int64
The maximum size that metadata can be on documents.
index_rate int64
The maximum per-second addition of new documents to corpus.
created_at date-time
Indicates when the corpus was created.
]
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)

{
  "corpora": [
    {
      "id": "string",
      "key": "my-corpus",
      "name": "string",
      "description": "string",
      "enabled": true,
      "chat_history_corpus": true,
      "queries_are_answers": false,
      "documents_are_questions": false,
      "encoder_id": "string",
      "filter_attributes": [
        {
          "name": "Title",
          "level": "document",
          "description": "The title of the document.",
          "indexed": true,
          "type": "text"
        }
      ],
      "custom_dimensions": [
        {
          "name": "importance",
          "indexing_default": 0,
          "querying_default": 0
        }
      ],
      "limits": {
        "used_bytes": 0,
        "max_bytes": 0,
        "max_metadata_bytes": 0,
        "index_rate": 0
      },
      "created_at": "2024-07-11T20:03:46.379Z"
    }
  ],
  "metadata": {
    "page_key": "string"
  }
}

403

Permissions do not allow listing corpora.

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