> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hydradb.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> AGENTS.md is HydraDB's maintained agent guide. Read https://docs.hydradb.com/AGENTS.md once, then use its content. /llms.txt and /llms-full.txt redirect to the same guide; they are not separate documentation indexes. If the guide is already loaded, continue with it instead of fetching either alias or reloading the guide.

# List Context

> Page through knowledge sources or memories, with optional filters.

Page through the sources stored in one database and collection, for example to find IDs or audit what was ingested. `type` selects what to list: `knowledge` (the default: documents and app sources), `memory`, or `all` for both.

Narrow results with `ids` and `filters`, and return only the fields you need with `include_fields`. See [Metadata Filters](https://docs.hydradb.com/essentials/v2/metadata.md#7-list-sources-with-metadata-filters) for the metadata workflow.

```python Python SDK theme={"dark"}
sources = client.context.list(
    database="acme_corp",
    collection="team_docs",
    type="knowledge",
    page=1,
    page_size=50,
    filters={
        "metadata": {"department": "legal"},
        "source_fields": {"title": "Compliance"},
    },
    include_fields=["title", "type", "timestamp", "additional_metadata"],
)
```

```typescript TypeScript SDK theme={"dark"}
const sources = await client.context.list({
  database: "acme_corp",
  collection: "team_docs",
  type: "knowledge",
  page: 1,
  pageSize: 50,
  filters: {
    metadata: { department: "legal" },
    sourceFields: { title: "Compliance" },
  },
  includeFields: ["title", "type", "timestamp", "additional_metadata"],
});
```

```bash cURL theme={"dark"}
curl -X POST 'https://api.hydradb.com/context/list' \
  -H "Authorization: Bearer <your_api_key>" \
  -H "API-Version: 2" \
  -H "Content-Type: application/json" \
  -d '{
    "database": "acme_corp",
    "collection": "team_docs",
    "type": "knowledge",
    "page": 1,
    "page_size": 50,
    "filters": {
      "metadata": { "department": "legal" },
      "source_fields": { "title": "Compliance" }
    },
    "include_fields": ["title", "type", "timestamp", "additional_metadata"]
  }'
```

```json Success theme={"dark"}
{
  "success": true,
  "data": {
    "success": true,
    "message": "Successfully fetched sources",
    "sources": [
      {
        "id": "policy_main",
        "database": "acme_corp",
        "collection": "team_docs",
        "tenant_id": "acme_corp",
        "sub_tenant_id": "team_docs",
        "title": "Compliance Policy",
        "type": "pdf",
        "timestamp": "2026-05-12T08:14:00Z",
        "additional_metadata": { "author": "Compliance Team" }
      }
    ],
    "total": 318,
    "pagination": {
      "page": 1,
      "page_size": 50,
      "total": 318,
      "total_pages": 7,
      "has_next": true,
      "has_previous": false
    }
  },
  "error": null,
  "meta": {
    "request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
    "latency_ms": 12.3
  }
}
```

```json Memories response theme={"dark"}
{
  "success": true,
  "data": {
    "success": true,
    "message": "Successfully fetched sources",
    "user_memories": [
      {
        "memory_id": "mem_user_alex_tone",
        "database": "acme_corp",
        "collection": "team_docs",
        "tenant_id": "acme_corp",
        "sub_tenant_id": "team_docs",
        "title": "Tone preference",
        "type": "memory",
        "metadata": { "user_id": "alex" }
      }
    ],
    "total": 1,
    "pagination": {
      "page": 1,
      "page_size": 50,
      "total": 1,
      "total_pages": 1,
      "has_next": false,
      "has_previous": false
    }
  },
  "error": null,
  "meta": {
    "request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
    "latency_ms": 12.3
  }
}
```

```json Failure theme={"dark"}
{
  "success": false,
  "data": null,
  "error": {
    "code": "DATABASE_NOT_FOUND",
    "message": "Database not found"
  },
  "meta": {
    "request_id": "9d13aef4-02f4-4e73-8c62-4c2601d04f9d",
    "latency_ms": 4.8
  }
}
```

## Filters

`filters` accepts three categories:

```json theme={"dark"}
{
  "filters": {
    "metadata": { "department": "Finance", "region": "US" },
    "additional_metadata": { "author": "Alice Smith" },
    "source_fields": { "app_provider": "slack", "title": "standup notes" }
  }
}
```

* `metadata`: schema-backed metadata fields.
* `additional_metadata`: free-form metadata. No schema declaration is required.
* `source_fields`: built-in and connector fields. Supported keys are `type`, `title`, `description`, `url`, `timestamp`, `app_provider`, `app_kind`, `app_external_id`, and `app_parent_id`. Unsupported keys return `400`. Pair external IDs with `app_provider`.

Matching rules:

* Values must match exactly, except `source_fields.title`, which matches a case-insensitive prefix.
* All filter pairs combine with AND. When `ids` is non-empty, filters apply only to those IDs, and pagination still applies.
* Range, contains, and OR operators are not supported. For OR behavior, run separate calls and combine the results in your application.
* A `null` filter value returns `400`.

## Field projection

Pass `include_fields` to keep response payloads small. Only the listed fields are populated, plus `id`, `database`, and `collection`, which are always returned. Treat omitted fields as unavailable in that response. Omit `include_fields` or pass `null` to return everything.

* Allowed values are `title`, `type`, `description`, `note`, `timestamp`, `metadata`, `additional_metadata`, and `relations`, plus the deprecated aliases `tenant_metadata` and `document_metadata`.
* `content`, `url`, and `attachments` are not valid values. They are stripped from list responses, and requesting one returns `400`. Fetch them per source with [Inspect Context](https://docs.hydradb.com/api-reference/v2/endpoint/fetch-content.md).
* Projection applies only to `type=knowledge`.

## Behavior notes

* **Memories:** For `type=memory`, read `data.user_memories[]`. Each entry includes a `memory_id`, source details, and metadata. Read the memory text and `inferred_content` with [Inspect Context](https://docs.hydradb.com/api-reference/v2/endpoint/fetch-content.md).
* **Memory listing unavailable:** If the memory store cannot be read, the call still returns `200` with an empty `user_memories` and `message` set to `"Memories temporarily unavailable"`. Check `message` before you treat an empty list as "no memories".
* **Access control:** `acl` lists the principals to list as. Omitting it, or sending `[]` or `["*"]`, disables caller-supplied filtering. It is ignored for `type=memory`. For enforced connectors, the authenticated caller is used instead; see [ACL enforcement](https://docs.hydradb.com/essentials/v2/connectors.md#enforce-acl).
* **Limits:** `ids` accepts at most `100` IDs. `page_size` ranges from `1` to `100` (default `50`), and `page` starts at `1`.

## Related resources

* **Before this:** [Ingest Context](https://docs.hydradb.com/api-reference/v2/endpoint/ingest-context.md): store the sources to list
* **After this:** [Inspect Context](https://docs.hydradb.com/api-reference/v2/endpoint/fetch-content.md): read one source's content
* **After this:** [Delete Context](https://docs.hydradb.com/api-reference/v2/endpoint/delete-source.md): remove sources by ID
* **Related:** [Query](https://docs.hydradb.com/api-reference/v2/endpoint/query.md): retrieve chunks by relevance instead of listing sources
* **Guide:** [Metadata Filters](https://docs.hydradb.com/essentials/v2/metadata.md)


## OpenAPI

````yaml api-reference/v2/openapi.json POST /context/list
openapi: 3.1.0
info:
  contact:
    email: support@hydradb.com
    name: HydraDB Support
  description: >-
    The HydraDB API: ingest context, query it, and manage databases, connectors
    and webhooks.
  license:
    name: Proprietary
  title: HydraDB Application API
  version: 0.1.0
servers:
  - description: Production server
    url: https://api.hydradb.com
security: []
externalDocs:
  description: ''
  url: ''
paths:
  /context/list:
    post:
      tags:
        - context
      summary: List documents
      description: >-
        List the contexts in a database or collection, ingested or synced, one
        page at a time. Fetch a context's content with `GET /context/inspect`.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/list.V2ListContentRequest'
        description: List request
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.Envelope-list_V2ListResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/handler.ErrorResponse'
          description: Bad Request
      security:
        - BearerAuth: []
components:
  schemas:
    list.V2ListContentRequest:
      properties:
        acl:
          description: >-
            Principals to answer as: only context they may see is listed. Omit
            it for no access scoping.
          items:
            type: string
          type: array
          uniqueItems: false
        collection:
          description: >-
            Collection to list. Omit it to use the database's default
            collection.
          example: team_docs
          type: string
        database:
          description: >-
            Database to list. Required. Formerly `tenant_id`; the alias is still
            accepted.
          example: acme_corp
          type: string
        filters:
          allOf:
            - $ref: '#/components/schemas/list.ContentFilter'
          description: >-
            Exact-match filters on `metadata`, `additional_metadata` and
            built-in `source_fields`. All pairs must match.
          example:
            additional_metadata:
              author: ada
            metadata:
              department: finance
            source_fields:
              app_external_id: C0123456789
              app_kind: slack
              app_provider: slack
              description: Internal overview of the Project Phoenix rollout.
              timestamp: '2026-07-02T10:00:00Z'
              title: Project Phoenix Overview
              type: knowledge
              url: https://docs.hydradb.com/phoenix
        group_threads:
          description: >-
            Nest each thread's comments and replies under their parent row as
            `comments`, newest first, instead of listing them as separate rows.
            Default `false`.
          example: true
          type: boolean
        ids:
          description: >-
            List only these context IDs, at most 100. Pagination and `filters`
            still apply.
          example:
            - HydraDoc1234
            - HydraDoc4567
          items:
            type: string
          type: array
          uniqueItems: false
        include_fields:
          description: >-
            Return only these fields plus `id`, `database` and `collection`.
            Supported fields are `title`, `type`, `description`, `note`,
            `timestamp`, `metadata`, `additional_metadata` and `relations`.
          example:
            - id
            - title
            - type
          items:
            type: string
          type: array
          uniqueItems: false
        page:
          description: Page number, starting at 1. Default 1.
          example: 1
          type: integer
        page_size:
          description: Rows per page, from 1 to 100. Default 50.
          example: 50
          type: integer
        sub_tenant_id:
          deprecated: true
          description: 'Deprecated: use `collection`.'
          example: sub_tenant_4567
          type: string
          x-deprecated: 'true'
        tenant_id:
          deprecated: true
          description: 'Deprecated: use `database`.'
          example: tenant_1234
          type: string
          x-deprecated: 'true'
        type:
          description: >-
            Corpus to list, `knowledge`, `memory` or `all` for both. Defaults to
            `knowledge`.
          enum:
            - knowledge
            - memory
            - all
          example: knowledge
          type: string
      title: ListV2ListContentRequest
      type: object
    handler.Envelope-list_V2ListResponse:
      properties:
        data:
          $ref: '#/components/schemas/list.V2ListResponse'
          example:
            message: Success
            pagination:
              has_next: true
              has_previous: false
              page: 1
              page_size: 50
              total: 128
              total_pages: 3
            sources:
              - additional_metadata:
                  author: ada
                  doc_version: 3
                app_external_id: C0123456789
                app_kind: slack
                app_provider: slack
                collection: team_docs
                comments_truncated: true
                database: acme_corp
                description: Internal overview of the Project Phoenix rollout.
                id: HydraDoc1234
                metadata:
                  department: finance
                  priority: 7
                note: Superseded by the Q3 rollout plan.
                sub_tenant_id: sub_tenant_4567
                tenant_id: tenant_1234
                timestamp: '2026-07-02T10:00:00Z'
                title: Project Phoenix Overview
                type: knowledge
            success: true
            total: 128
            user_memories:
              - additional_metadata:
                  author: ada
                  doc_version: 3
                app_external_id: C0123456789
                app_kind: slack
                app_provider: slack
                collection: team_docs
                database: acme_corp
                description: Internal overview of the Project Phoenix rollout.
                memory_id: memory_1234
                metadata:
                  department: finance
                  priority: 7
                note: Superseded by the Q3 rollout plan.
                sub_tenant_id: sub_tenant_4567
                tenant_id: tenant_1234
                timestamp: '2026-07-02T10:00:00Z'
                title: Project Phoenix Overview
                type: knowledge
        error:
          anyOf:
            - $ref: '#/components/schemas/handler.apiError'
              title: HandlerApiError
            - title: No error
              type: 'null'
          description: Error details on failure, or null on success.
          example: null
        meta:
          $ref: '#/components/schemas/handler.responseMeta'
          example:
            collection: team_docs
            database: acme_corp
            latency_ms: 12.3
            request_id: 9d13aef4-02f4-4e73-8c62-4c2601d04f9d
            source_type: file
            sub_tenant_id: sub_tenant_4567
            tenant_id: tenant_1234
            warnings:
              - code: acl_ignored_by_connector_enforcement
                message: This connector enforces ACL, so the request's acl was ignored.
        success:
          description: Whether the request succeeded.
          example: true
          type: boolean
      title: HandlerEnvelopeListV2ListResponse
      type: object
    handler.ErrorResponse:
      properties:
        data:
          description: Always `null` on this error response.
          type: 'null'
        detail:
          $ref: '#/components/schemas/handler.ErrorDetail'
          description: Structured error detail with code, message, and deprecation hints.
          example:
            deprecated: true
            deprecated_field: tenant_id
            deprecated_since: 2.0.1
            error_code: VALIDATION_ERROR
            message: Request validation failed
            preferred_field: database
            retry_after_seconds: 1
            retryable: true
        error:
          $ref: '#/components/schemas/handler.apiError'
          description: Error message, empty string on success.
          example:
            code: DATABASE_NOT_FOUND
            message: Database not found
        meta:
          $ref: '#/components/schemas/handler.ErrorMeta'
          example:
            latency_ms: 12.3
            request_id: 9d13aef4-02f4-4e73-8c62-4c2601d04f9d
        success:
          description: Whether the request succeeded.
          example: false
          type: boolean
      title: HandlerErrorResponse
      type: object
    list.ContentFilter:
      properties:
        additional_metadata:
          additionalProperties:
            not:
              type: 'null'
          description: >-
            Match additional metadata. `document_metadata` is also accepted. Use
            bare values.
          example:
            author: ada
          type: object
        metadata:
          additionalProperties:
            not:
              type: 'null'
          description: >-
            Match context metadata. `tenant_metadata` is also accepted. Use bare
            values, such as `{"department":"finance"}`.
          example:
            department: finance
          type: object
        source_fields:
          allOf:
            - $ref: '#/components/schemas/list.SourceFieldFilters'
          description: >-
            Match on built-in fields: `title` (case-insensitive prefix), `type`,
            `description`, `url`, `timestamp` and `app_*` fields. Pair
            `app_external_id` or `app_parent_id` with `app_provider`.
          example:
            app_external_id: C0123456789
            app_kind: slack
            app_provider: slack
            description: Internal overview of the Project Phoenix rollout.
            timestamp: '2026-07-02T10:00:00Z'
            title: Project Phoenix Overview
            type: knowledge
            url: https://docs.hydradb.com/phoenix
      title: ListContentFilter
      type: object
    list.V2ListResponse:
      properties:
        message:
          description: Human-readable result message.
          example: Success
          type: string
        pagination:
          $ref: '#/components/schemas/dashboard.PaginationMeta'
          example:
            has_next: true
            has_previous: false
            page: 1
            page_size: 50
            total: 128
            total_pages: 3
        sources:
          description: The listed context, one row per context.
          example:
            - additional_metadata:
                author: ada
                doc_version: 3
              app_external_id: C0123456789
              app_kind: slack
              app_provider: slack
              collection: team_docs
              comments_truncated: true
              database: acme_corp
              description: Internal overview of the Project Phoenix rollout.
              id: HydraDoc1234
              metadata:
                department: finance
                priority: 7
              note: Superseded by the Q3 rollout plan.
              sub_tenant_id: sub_tenant_4567
              tenant_id: tenant_1234
              timestamp: '2026-07-02T10:00:00Z'
              title: Project Phoenix Overview
              type: knowledge
          items:
            $ref: '#/components/schemas/list.V2SourceItem'
          type: array
          uniqueItems: false
        success:
          deprecated: true
          description: >-
            Deprecated: check the HTTP status instead. Always equals the
            envelope's top-level `success`.
          example: true
          type: boolean
          x-deprecated: 'true'
        total:
          description: Number of matching rows across all pages.
          example: 128
          type: integer
        user_memories:
          description: Memory rows returned when `type` is `memory`.
          example:
            - additional_metadata:
                author: ada
                doc_version: 3
              app_external_id: C0123456789
              app_kind: slack
              app_provider: slack
              collection: team_docs
              database: acme_corp
              description: Internal overview of the Project Phoenix rollout.
              memory_id: memory_1234
              metadata:
                department: finance
                priority: 7
              note: Superseded by the Q3 rollout plan.
              sub_tenant_id: sub_tenant_4567
              tenant_id: tenant_1234
              timestamp: '2026-07-02T10:00:00Z'
              title: Project Phoenix Overview
              type: knowledge
          items:
            $ref: '#/components/schemas/list.V2MemoryItem'
          type: array
          uniqueItems: false
      title: ListV2ListResponse
      type: object
    handler.apiError:
      properties:
        code:
          description: Machine-readable error code (e.g. `DATABASE_NOT_FOUND`).
          example: DATABASE_NOT_FOUND
          type: string
        details:
          additionalProperties:
            type: string
          description: >-
            Extra facts about the error, as string pairs. Omitted when there are
            none.
          type: object
        message:
          description: Human-readable description of the error.
          example: Database not found
          type: string
        param:
          description: >-
            The request field that caused the error. Omitted when no single
            field is at fault.
          type: string
      title: HandlerApiError
      type: object
    handler.responseMeta:
      properties:
        api_version:
          description: >-
            Version of the API that served the request, for example `2.0.1`.
            Always present.
          type: string
        collection:
          description: >-
            Collection scope. Defaults to the default collection when omitted.
            Formerly `sub_tenant_id`; the `sub_tenant_id` alias is still
            accepted (deprecated).
          example: team_docs
          type: string
        database:
          description: >-
            Owning database. Formerly `tenant_id`; the `tenant_id` alias is
            still accepted (deprecated).
          example: acme_corp
          type: string
        deprecation:
          description: >-
            Migration notices for this request, present only when it used a
            deprecated route, field or selector. The status code is unaffected.
          items:
            $ref: '#/components/schemas/handler.deprecationNotice'
          type: array
          uniqueItems: false
        latency_ms:
          description: Server-side processing time in milliseconds.
          example: 12.3
          type:
            - number
            - 'null'
        request_id:
          description: Unique identifier for this request, useful for support and tracing.
          example: 9d13aef4-02f4-4e73-8c62-4c2601d04f9d
          type: string
        source_type:
          description: Type of the parent source (e.g. `file`, `slack`, `notion`).
          example: file
          type: string
        sub_tenant_id:
          deprecated: true
          description: 'Deprecated: use `collection`.'
          example: sub_tenant_4567
          type: string
          x-deprecated: 'true'
        tenant_id:
          deprecated: true
          description: 'Deprecated: use `database`.'
          example: tenant_1234
          type: string
          x-deprecated: 'true'
        warnings:
          description: >-
            Warnings contains non-fatal notices; enforced reads may include
            acl_ignored_by_connector_enforcement when a request ACL is replaced.
          example:
            - code: acl_ignored_by_connector_enforcement
              message: This connector enforces ACL, so the request's acl was ignored.
          items:
            $ref: '#/components/schemas/handler.ResponseWarning'
          type: array
          uniqueItems: false
      title: HandlerResponseMeta
      type: object
    handler.ErrorDetail:
      properties:
        deprecated:
          description: Whether this response concerns a deprecated field or route.
          example: true
          type: boolean
        deprecated_field:
          description: The deprecated field name.
          example: tenant_id
          type: string
        deprecated_since:
          description: API version that deprecated the conflicting selector.
          example: 2.0.1
          type: string
        error_code:
          description: Machine-readable error classification code.
          example: VALIDATION_ERROR
          type: string
        message:
          description: Human-readable description of the error.
          example: Request validation failed
          type: string
        preferred_field:
          description: The canonical replacement for the deprecated field.
          example: database
          type: string
        retry_after_seconds:
          description: >-
            Seconds to wait before retrying deletion of context that is still
            indexing.
          example: 1
          type: integer
        retryable:
          description: >-
            Whether retrying this failed query can succeed. Present for search
            workflow failures.
          example: true
          type: boolean
        success:
          deprecated: true
          description: >-
            Deprecated: always `false`. Read the HTTP status, then `error.code`
            and `error.message`.
          example: false
          type: boolean
          x-deprecated: 'true'
      title: HandlerErrorDetail
      type: object
    handler.ErrorMeta:
      properties:
        api_version:
          description: Version of the API that served the request, for example `2.0.1`.
          type: string
        latency_ms:
          description: Server-side processing time in milliseconds.
          example: 12.3
          type: number
        request_id:
          description: Unique identifier for this request, useful for support and tracing.
          example: 9d13aef4-02f4-4e73-8c62-4c2601d04f9d
          type: string
      title: HandlerErrorMeta
      type: object
    list.SourceFieldFilters:
      additionalProperties: false
      description: Filters on supported built-in context fields.
      properties:
        app_external_id:
          description: Exact value of this built-in context field.
          example: C0123456789
          type: string
        app_kind:
          description: Exact value of this built-in context field.
          example: slack
          type: string
        app_parent_id:
          description: Exact value of this built-in context field.
          type: string
        app_provider:
          description: Exact value of this built-in context field.
          example: slack
          type: string
        description:
          description: Exact value of this built-in context field.
          example: Internal overview of the Project Phoenix rollout.
          type: string
        timestamp:
          description: Exact value of this built-in context field.
          example: '2026-07-02T10:00:00Z'
          type: string
        title:
          description: Case-insensitive title prefix.
          example: Project Phoenix Overview
          type: string
        type:
          description: Exact value of this built-in context field.
          example: knowledge
          type: string
        url:
          description: Exact value of this built-in context field.
          example: https://docs.hydradb.com/phoenix
          type: string
      title: ListSourceFieldFilters
      type: object
    dashboard.PaginationMeta:
      properties:
        has_next:
          description: Whether a next page exists.
          example: true
          type: boolean
        has_previous:
          description: Whether a previous page exists.
          example: false
          type: boolean
        page:
          description: Current page number (1-indexed).
          example: 1
          type: integer
        page_size:
          description: Number of results per page.
          example: 50
          type: integer
        total:
          description: Total number of results across all pages.
          example: 128
          type: integer
        total_pages:
          description: Total number of pages.
          example: 3
          type: integer
      title: DashboardPaginationMeta
      type: object
    list.V2SourceItem:
      properties:
        additional_metadata:
          additionalProperties: {}
          description: Additional metadata attached to this context.
          example:
            author: ada
            doc_version: 3
          type: object
        app_external_id:
          description: Provider-assigned identifier, for example a Slack channel ID.
          example: C0123456789
          type:
            - string
            - 'null'
        app_kind:
          description: Connector object category.
          example: slack
          type:
            - string
            - 'null'
        app_parent_id:
          description: >-
            Provider ID of the parent in a discussion, for example a Jira
            comment's issue key or a Slack reply's thread root.
          type: string
        app_provider:
          description: >-
            Connector the context came from, for example `slack` or `github`.
            Absent for context that did not come from a connector.
          example: slack
          type:
            - string
            - 'null'
        app_relations:
          description: Relations derived by the connector.
        app_thread_id:
          description: >-
            Discussion grouping key shared by a thread root and its replies or
            comments.
          type: string
        collection:
          description: >-
            Collection the row was listed from; empty string for the database's
            default collection. Always present.
          example: team_docs
          type: string
        comments:
          description: >-
            With `group_threads`, the row's comments and replies as full rows,
            newest first, capped per parent.
          example:
            - additional_metadata:
                author: ada
                doc_version: 3
              app_external_id: C0123456789
              app_kind: slack
              app_provider: slack
              collection: team_docs
              comments_truncated: true
              database: acme_corp
              description: Internal overview of the Project Phoenix rollout.
              id: HydraDoc1234
              metadata:
                department: finance
                priority: 7
              note: Superseded by the Q3 rollout plan.
              sub_tenant_id: sub_tenant_4567
              tenant_id: tenant_1234
              timestamp: '2026-07-02T10:00:00Z'
              title: Project Phoenix Overview
              type: knowledge
          items:
            $ref: '#/components/schemas/list.V2SourceItem'
          type: array
        comments_truncated:
          description: >-
            With `group_threads`, `true` when `comments` hit the per-parent cap
            and more exist.
          example: true
          type: boolean
        database:
          description: Database the row was listed from. Always present.
          example: acme_corp
          type: string
        description:
          description: Human-readable description of the context.
          example: Internal overview of the Project Phoenix rollout.
          type: string
        id:
          description: The context's ID. Always present.
          example: HydraDoc1234
          type: string
        metadata:
          additionalProperties: {}
          description: Metadata attached to this context.
          example:
            department: finance
            priority: 7
          type: object
        note:
          description: Free-form note attached to the context.
          example: Superseded by the Q3 rollout plan.
          type: string
        relations:
          description: >-
            Relations attached to the context. Returned only when requested with
            `include_fields`.
        sub_tenant_id:
          deprecated: true
          description: 'Deprecated: use `collection`, which carries the same value.'
          example: sub_tenant_4567
          type: string
          x-deprecated: 'true'
        tenant_id:
          deprecated: true
          description: 'Deprecated: use `database`, which carries the same value.'
          example: tenant_1234
          type: string
          x-deprecated: 'true'
        timestamp:
          description: RFC3339 timestamp associated with the context.
          example: '2026-07-02T10:00:00Z'
          type: string
        title:
          description: Title of the context.
          example: Project Phoenix Overview
          type: string
        type:
          description: Kind of source the context came from.
          example: knowledge
          type: string
      required:
        - collection
        - database
        - id
        - sub_tenant_id
        - tenant_id
      title: ListV2SourceItem
      type: object
    list.V2MemoryItem:
      properties:
        additional_metadata:
          additionalProperties: {}
          description: Additional metadata attached to this memory.
          example:
            author: ada
            doc_version: 3
          type: object
        app_external_id:
          description: Provider-assigned identifier, for example a Slack channel ID.
          example: C0123456789
          type:
            - string
            - 'null'
        app_kind:
          description: Connector object category.
          example: slack
          type:
            - string
            - 'null'
        app_parent_id:
          description: >-
            Provider ID of the parent in a discussion, for example a Jira
            comment's issue key or a Slack reply's thread root.
          type: string
        app_provider:
          description: >-
            Connector the context came from, for example `slack` or `github`.
            Absent for context that did not come from a connector.
          example: slack
          type:
            - string
            - 'null'
        app_relations:
          description: Relations derived by the connector.
        app_thread_id:
          description: >-
            Discussion grouping key shared by a thread root and its replies or
            comments.
          type: string
        collection:
          description: >-
            Collection the row was listed from; empty string for the database's
            default collection. Always present.
          example: team_docs
          type: string
        database:
          description: Database the row was listed from. Always present.
          example: acme_corp
          type: string
        description:
          description: Human-readable description of the context.
          example: Internal overview of the Project Phoenix rollout.
          type: string
        memory_id:
          description: The context's ID. Always present.
          example: memory_1234
          type: string
        metadata:
          additionalProperties: {}
          description: Metadata attached to this memory.
          example:
            department: finance
            priority: 7
          type: object
        note:
          description: Free-form note attached to the context.
          example: Superseded by the Q3 rollout plan.
          type: string
        relations:
          description: >-
            Relations attached to the context. Returned only when requested with
            `include_fields`.
        sub_tenant_id:
          deprecated: true
          description: 'Deprecated: use `collection`, which carries the same value.'
          example: sub_tenant_4567
          type: string
          x-deprecated: 'true'
        tenant_id:
          deprecated: true
          description: 'Deprecated: use `database`, which carries the same value.'
          example: tenant_1234
          type: string
          x-deprecated: 'true'
        timestamp:
          description: RFC3339 timestamp associated with the context.
          example: '2026-07-02T10:00:00Z'
          type: string
        title:
          description: Title of the context.
          example: Project Phoenix Overview
          type: string
        type:
          description: Kind of source the context came from.
          example: knowledge
          type: string
      required:
        - collection
        - database
        - memory_id
        - sub_tenant_id
        - tenant_id
      title: ListV2MemoryItem
      type: object
    handler.deprecationNotice:
      properties:
        deprecated:
          description: Whether this response concerns a deprecated field or route.
          example: true
          type: boolean
        deprecated_field:
          description: The deprecated field name.
          example: tenant_id
          type: string
        deprecated_since:
          description: API version when the field was deprecated.
          example: 2.0.1
          type: string
        message:
          description: Migration guidance message.
          example: tenant_id is deprecated; use database instead.
          type: string
        preferred_field:
          description: The canonical replacement for the deprecated field.
          example: database
          type: string
      title: HandlerDeprecationNotice
      type: object
    handler.ResponseWarning:
      properties:
        code:
          description: >-
            Code identifies the warning type, such as
            acl_ignored_by_connector_enforcement.
          example: acl_ignored_by_connector_enforcement
          type: string
        message:
          description: Human-readable explanation of the warning.
          example: This connector enforces ACL, so the request's acl was ignored.
          type: string
      title: HandlerResponseWarning
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: API key
      description: 'Send your API key as Authorization: Bearer <your_api_key>.'
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.