{"record":{"id":"873a5d286422946b","repo":"chroma-core/chroma","slug":"modify-is-not-supported-on-a-collection-obtained","errorCode":null,"errorMessage":"modify() is not supported on a collection obtained via client.collection(id). Use client.getCollection() to get a full collection instance.","messagePattern":"modify\\(\\) is not supported on a collection obtained via client\\.collection\\(id\\)\\. Use client\\.getCollection\\(\\) to get a full collection instance\\.","errorType":"validation","errorClass":"ChromaValueError","httpStatus":null,"severity":"error","filePath":"clients/new-js/packages/chromadb/src/collection.ts","lineNumber":1872,"sourceCode":"    searches: SearchLike | SearchLike[],\n    options?: { readLevel?: ReadLevel },\n  ): Promise<SearchResult> {\n    const items = Array.isArray(searches) ? searches : [searches];\n    for (const search of items) {\n      const payload = toSearch(search).toPayload();\n      if (this.hasStringKnnQuery(payload.rank)) {\n        throw new ChromaValueError(HANDLE_EMBEDDING_ERROR);\n      }\n    }\n    return super.search(searches, options);\n  }\n\n  public override async modify(_args: {\n    name?: string;\n    metadata?: CollectionMetadata;\n    configuration?: UpdateCollectionConfiguration;\n  }): Promise<void> {\n    throw new ChromaValueError(`modify() ${HANDLE_NOT_SUPPORTED_ERROR}`);\n  }\n\n  public override async fork(_args: { name: string }): Promise<Collection> {\n    throw new ChromaValueError(`fork() ${HANDLE_NOT_SUPPORTED_ERROR}`);\n  }\n\n  private hasStringKnnQuery(obj: unknown): boolean {\n    if (!obj || typeof obj !== \"object\") return false;\n    if (Array.isArray(obj)) {\n      return obj.some((item) => this.hasStringKnnQuery(item));\n    }\n    const record = obj as Record<string, unknown>;\n    if (\"$knn\" in record && isPlainObject(record.$knn)) {\n      const knn = record.$knn as Record<string, unknown>;\n      if (typeof knn.query === \"string\") return true;\n    }\n    return Object.values(record).some((value) => this.hasStringKnnQuery(value));\n  }","sourceCodeStart":1854,"sourceCodeEnd":1890,"githubUrl":"https://github.com/chroma-core/chroma/blob/aecdd12c8a891610db8653630b066b32ceb678b5/clients/new-js/packages/chromadb/src/collection.ts#L1854-L1890","documentation":"Error \"modify() is not supported on a collection obtained via client.collection(id). Use client.getCollection() to get a full collection instance.\" thrown in chroma-core/chroma.","triggerScenarios":"Thrown at clients/new-js/packages/chromadb/src/collection.ts:1872 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"aecdd12c8a891610db8653630b066b32ceb678b5","analyzedAt":"2026-08-16T21:53:27.228Z","schemaVersion":2},"datasetVersion":"2026-08-16T23:17:17.608Z"}