H2h2o
Collections

List collections.

List collections for a given user. If sort_column is not specified, the output is sorted by by last update time in descending order.

get/collections

Request

Query parameters

offsetinteger

How many collections to skip before returning.

limitinteger

How many collections to return.

sort_column'name' | 'document_count' | 'document_size' | 'updated_at' | 'sessions_count'

Sort column.

ascendingboolean

When true, returns sorted by sort_column in ascending order.

metadata_filterstring

Only returns collections with metadata matching this filter.

name_filterstring

Only returns collections with names matching this filter.

current_user_onlyboolean

When true, will only return the user owned collections.

Response

Successful operation

idstring required

A unique identifier of the collection

namestring required

Name of the collection

descriptionstring required

Description of the collection

description_auto_generatedboolean

Whether the collection description was generated by the system.

description_generated_atstring date-time

Time when the auto-generated description was last generated.

description_dirty_atstring date-time

Time when document changes made the auto-generated description stale.

description_generation_started_atstring date-time

Time when description regeneration last started.

embedding_modelstring required
document_countinteger required

A number of documents in the collection

document_sizeinteger required

Total size in bytes of all documents in the collection

created_atstring date-time required

Time when the collection was created

updated_atstring date-time required

Last time when the collection was modified

user_countinteger required

A number of users having access to the collection

is_publicboolean required

Is publicly accessible

usernamestring required

Name of the user owning the collection

sessions_countinteger required

A number of chat sessions with the collection

statusstring required

Status of the collection

prompt_template_idstring

A unique identifier of a prompt template associated with the collection.

thumbnailstring

A file name of a thumbnail image.

size_limitinteger

Maximum size of data that could be contained in the collection.

expiry_datestring date-time

An expiry date

inactivity_intervalinteger

The inactivity interval as an integer number of days.

rag_type'auto' | 'llm_only' | 'rag' | 'hyde1' | 'hyde2' | 'rag+' | 'all_data'

RAG type options:

  • auto - Automatically select the best rag_type.
  • llm_only LLM Only - Answer the query without any supporting document contexts. Requires 1 LLM call.
  • rag RAG (Retrieval Augmented Generation) - Use supporting document contexts to answer the query. Requires 1 LLM call.
  • hyde1 LLM Only + RAG composite - HyDE RAG (Hypothetical Document Embedding). Use 'LLM Only' response to find relevant contexts from a collection for generating a response. Requires 2 LLM calls.
  • hyde2 HyDE + RAG composite - Use the 'HyDE RAG' response to find relevant contexts from a collection for generating a response. Requires 3 LLM calls.
  • rag+ Summary RAG - Like RAG, but uses more context and recursive summarization to overcome LLM context limits. Keeps all retrieved chunks, puts them in order, adds neighboring chunks, then uses the summary API to get the answer. Can require several LLM calls.
  • all_data All Data RAG - Like Summary RAG, but includes all document chunks. Uses recursive summarization to overcome LLM context limits. Can require several LLM calls.
metadata_dictMetadata
workspacestring

The workspace associated with the collection.

has_default_guardrailsboolean

Whether this collection was created with default guardrails enabled.

vex_encryption'enabled' | 'disabled' | 'null' nullable

The per-collection vector encryption choice that was set at creation: enabled, disabled, or null when the collection follows the server default. Read-only — cannot be changed after creation.

exempt_from_chat_expiryboolean

Whether chat sessions in this collection are exempt from auto-expiry

Example response

[
  {
    "id": "123e4567-e89b-12d3-a456-426655440000",
    "name": "My sci-fi library",
    "description": "Collection of my favourite sci-fi books",
    "embedding_model": "BAAI/bge-large-en-v1.5",
    "prompt_template_id": "4e400991-c459-455f-995c-dc6f55ffdb90"
  }
]

Changes

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