Retrieve metadata about a corpus

GET 
/v2/corpora/:corpus_key

Get metadata about a corpus. This operation is not a method of searching a corpus.

Request

Path Parameters

corpus_key CorpusKeyrequired

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

The unique key identifying the corpus to retrieve.

Responses

200

A corpus.

application/json

Schema

Schema

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 stringdeprecated

Possible values: Value must match regular expression enc_[0-9]+$

The encoder used by the corpus. Deprecated: use encoder_name instead

encoder_name string

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
Indicates whether an index should be 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. This includes the document metadata, document part metadata, and document contents.

used_characters int64

The number of characters contained in the corpus. This includes the document metadata, document part metadata, and document contents.

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.

Example (from schema)

{
  "id": "string",
  "key": "my-corpus",
  "name": "string",
  "description": "string",
  "enabled": true,
  "chat_history_corpus": true,
  "queries_are_answers": false,
  "documents_are_questions": false,
  "encoder_name": "boomerang",
  "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,
    "used_characters": 0,
    "max_bytes": 0,
    "max_metadata_bytes": 0,
    "index_rate": 0
  },
  "created_at": "2024-09-05T02:15:29.461Z"
}

403

Permissions do not allow retrieving the corpus.

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"
}

404

Corpus not found.

application/json

Schema

Schema

id string

The ID cannot found.

messages message[]
request_id string

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

Example (from schema)

{
  "id": "string",
  "messages": [
    "string"
  ],
  "request_id": "string"
}

Loading...