chroma-core/chroma · error · ChromaValueError

transactional write request contains duplicate id "${id}"

Error message

transactional write request contains duplicate id "${id}"

What it means

Error "transactional write request contains duplicate id "${id}"" thrown in chroma-core/chroma.

Source

Thrown at clients/new-js/packages/chromadb/src/collection.ts:1700

    this.ensureOpen();
    this.validateBufferedWrite(operation, ids);
    for (const id of ids) {
      this.bufferedWriteIds.add(id);
    }
    this.operations.push({
      operation,
      payload,
    } as ConditionalTransactionOperationPayload);
  }

  private validateBufferedWrite(
    operation: ConditionalTransactionOperationPayload["operation"],
    ids: string[],
  ): void {
    const callIds = new Set<string>();
    for (const id of ids) {
      if (callIds.has(id)) {
        throw new ChromaValueError(
          `transactional write request contains duplicate id "${id}"`,
        );
      }
      callIds.add(id);
      if (this.bufferedWriteIds.has(id)) {
        throw new ChromaValueError(
          `transaction already has a buffered write for id "${id}"`,
        );
      }
      this.validateWritePrecondition(operation, id);
    }
  }

  private validateWritePrecondition(
    operation: ConditionalTransactionOperationPayload["operation"],
    id: string,
  ): void {
    if (operation === "add" && !this.knownAbsent.has(id)) {

View on GitHub (pinned to aecdd12c8a)

When it happens

Trigger: Thrown at clients/new-js/packages/chromadb/src/collection.ts:1700 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of chroma-core/chroma@aecdd12c8a (2026-08-16). Data as JSON: /api/errors/66c3e0d0ac16e5b5. Report an issue: GitHub.