{"record":{"id":"b6cac3300283c7b9","repo":"chroma-core/chroma","slug":"missing-api-key-please-provide-it-to-the-cloudcli","errorCode":null,"errorMessage":"Missing API key. Please provide it to the CloudClient constructor or set your CHROMA_API_KEY environment variable","messagePattern":"Missing API key\\. Please provide it to the CloudClient constructor or set your CHROMA_API_KEY environment variable","errorType":"validation","errorClass":"ChromaValueError","httpStatus":null,"severity":"error","filePath":"clients/new-js/packages/chromadb/src/cloud-client.ts","lineNumber":33,"sourceCode":"  constructor(\n    args: Partial<{\n      /** API key for authentication (or set CHROMA_API_KEY env var) */\n      apiKey?: string;\n      /** Host address of the Chroma cloud server. Defaults to 'api.trychroma.com' */\n      host?: string;\n      /** Port number of the Chroma cloud server. Defaults to 443 */\n      port?: number;\n      /** Tenant name for multi-tenant deployments */\n      tenant?: string;\n      /** Database name to connect to */\n      database?: string;\n      /** Additional fetch options for HTTP requests */\n      fetchOptions?: RequestInit;\n    }> = {},\n  ) {\n    const apiKey = args.apiKey || process.env.CHROMA_API_KEY;\n    if (!apiKey) {\n      throw new ChromaValueError(\n        \"Missing API key. Please provide it to the CloudClient constructor or set your CHROMA_API_KEY environment variable\",\n      );\n    }\n\n    const tenant = args.tenant || process.env.CHROMA_TENANT;\n    const database = args.database || process.env.CHROMA_DATABASE;\n\n    super({\n      host: args.host || \"api.trychroma.com\",\n      port: args.port || 443,\n      ssl: true,\n      tenant,\n      database,\n      headers: { \"x-chroma-token\": apiKey },\n      fetchOptions: args.fetchOptions,\n    });\n\n    // Override from ChromaClient construction in case undefined. This will trigger auto-resolution in the \"path\" function","sourceCodeStart":15,"sourceCodeEnd":51,"githubUrl":"https://github.com/chroma-core/chroma/blob/aecdd12c8a891610db8653630b066b32ceb678b5/clients/new-js/packages/chromadb/src/cloud-client.ts#L15-L51","documentation":"Error \"Missing API key. Please provide it to the CloudClient constructor or set your CHROMA_API_KEY environment variable\" thrown in chroma-core/chroma.","triggerScenarios":"Thrown at clients/new-js/packages/chromadb/src/cloud-client.ts:33 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"}