{ "info": { "_postman_id": "5eb92165-7aec-4648-bbc1-e33c7cd28a0a", "name": "Chroma Cloud Collections Records API", "description": "Chroma Cloud is a managed, serverless vector database service that provides fast and scalable vector, full-text, and metadata search across terabytes of data. It is backed by Chroma's Apache 2.0 distributed database and offers usage-based pricing with starter and team plans. The Cloud API extends the Chroma Server API with additional search capabilities including hybrid search with reciprocal rank fusion, custom ranking expressions, and batch search operations.\n\nContact Support:\n Name: Chroma Support", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T01:20:39.000Z", "updatedAt": "2026-07-28T01:20:39.000Z", "lastUpdatedBy": "35240", "uid": "35240-5eb92165-7aec-4648-bbc1-e33c7cd28a0a" }, "item": [ { "name": "api", "item": [ { "name": "v2", "item": [ { "name": "tenants", "item": [ { "name": "{tenantName}", "item": [ { "name": "databases", "item": [ { "name": "{databaseName}", "item": [ { "name": "collections", "item": [ { "name": "{collectionId}", "item": [ { "name": "count", "item": [ { "name": "Count records in a collection", "id": "c922aa33-90ed-46a3-94d0-bf680bee42c1", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/api/v2/tenants/:tenantName/databases/:databaseName/collections/:collectionId/count", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "tenants", ":tenantName", "databases", ":databaseName", "collections", ":collectionId", "count" ], "variable": [ { "id": "c1e05f1e-f7f2-4498-98f3-704455dde628", "key": "tenantName", "value": "", "description": "(Required) The name of the tenant" }, { "id": "ad7fdbf8-01b2-4b62-8042-9d4c14401668", "key": "databaseName", "value": "", "description": "(Required) The name of the database" }, { "id": "c574c023-f067-404d-8e76-c5f1147352d6", "key": "collectionId", "value": "", "description": "(Required) The unique identifier of the collection" } ] }, "description": "Returns the number of records stored in the specified collection." }, "response": [ { "id": "8ff871ae-d7c4-43f1-8937-cf44a2fb21d7", "name": "Record count", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "url": { "raw": "{{baseUrl}}/api/v2/tenants/:tenantName/databases/:databaseName/collections/:collectionId/count", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "tenants", ":tenantName", "databases", ":databaseName", "collections", ":collectionId", "count" ], "variable": [ { "key": "tenantName" }, { "key": "databaseName" }, { "key": "collectionId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-8ff871ae-d7c4-43f1-8937-cf44a2fb21d7" } ], "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-c922aa33-90ed-46a3-94d0-bf680bee42c1" } ], "id": "dc365dc6-891b-42bc-b4a2-39a4906f8789", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-dc365dc6-891b-42bc-b4a2-39a4906f8789" }, { "name": "add", "item": [ { "name": "Add records to a collection", "id": "c1026e35-2836-44fc-8bfd-4e9c63bd629b", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"embeddings\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"documents\": [\n \"\",\n \"\"\n ],\n \"metadatas\": [\n {\n \"sint_1\": true\n },\n {\n \"mollit___b\": false,\n \"suntc\": true\n }\n ],\n \"uris\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/tenants/:tenantName/databases/:databaseName/collections/:collectionId/add", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "tenants", ":tenantName", "databases", ":databaseName", "collections", ":collectionId", "add" ], "variable": [ { "id": "191a5fb6-0897-454a-9f91-707d0d8a8e6e", "key": "tenantName", "value": "", "description": "(Required) The name of the tenant" }, { "id": "975d70b1-9e6e-4b3b-9cc7-06cd1c095409", "key": "databaseName", "value": "", "description": "(Required) The name of the database" }, { "id": "8565d475-635e-427f-9591-a208535b331e", "key": "collectionId", "value": "", "description": "(Required) The unique identifier of the collection" } ] }, "description": "Adds new records to the specified collection. Supports batch operations of up to 100,000 or more items at once." }, "response": [ { "id": "84a0f5f6-69d9-4756-82d4-640bfe5aae42", "name": "Records added successfully", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"embeddings\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"documents\": [\n \"\",\n \"\"\n ],\n \"metadatas\": [\n {\n \"sint_1\": true\n },\n {\n \"mollit___b\": false,\n \"suntc\": true\n }\n ],\n \"uris\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/tenants/:tenantName/databases/:databaseName/collections/:collectionId/add", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "tenants", ":tenantName", "databases", ":databaseName", "collections", ":collectionId", "add" ], "variable": [ { "key": "tenantName" }, { "key": "databaseName" }, { "key": "collectionId" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-84a0f5f6-69d9-4756-82d4-640bfe5aae42" }, { "id": "613ea519-a437-40b2-8012-4815f6eb9f94", "name": "Invalid request or duplicate IDs", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"embeddings\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"documents\": [\n \"\",\n \"\"\n ],\n \"metadatas\": [\n {\n \"sint_1\": true\n },\n {\n \"mollit___b\": false,\n \"suntc\": true\n }\n ],\n \"uris\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/tenants/:tenantName/databases/:databaseName/collections/:collectionId/add", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "tenants", ":tenantName", "databases", ":databaseName", "collections", ":collectionId", "add" ], "variable": [ { "key": "tenantName" }, { "key": "databaseName" }, { "key": "collectionId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-613ea519-a437-40b2-8012-4815f6eb9f94" } ], "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-c1026e35-2836-44fc-8bfd-4e9c63bd629b" } ], "id": "d510cc2e-7929-4865-b6b1-23fffbb79bde", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-d510cc2e-7929-4865-b6b1-23fffbb79bde" }, { "name": "get", "item": [ { "name": "Get records from a collection", "id": "bcbc5332-d026-4cd7-91c1-4beeb2145b64", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"where\": {\n \"nostrud_3\": 5817435,\n \"cupidatat8a\": \"consectetur nisi\",\n \"Lorem_477\": true\n },\n \"where_document\": {\n \"quisd4\": -26238082.102693334,\n \"aliqua_ce\": \"ad veniam id irur\"\n },\n \"include\": [\n \"uris\",\n \"uris\"\n ],\n \"limit\": \"\",\n \"offset\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/tenants/:tenantName/databases/:databaseName/collections/:collectionId/get", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "tenants", ":tenantName", "databases", ":databaseName", "collections", ":collectionId", "get" ], "variable": [ { "id": "e58c8e25-43b6-4af7-9419-39fe2c8061c4", "key": "tenantName", "value": "", "description": "(Required) The name of the tenant" }, { "id": "6d9b8063-9696-42c9-a4f6-1f6b556b194b", "key": "databaseName", "value": "", "description": "(Required) The name of the database" }, { "id": "39d0a7d2-f028-4dda-9346-f3efa1d72fe0", "key": "collectionId", "value": "", "description": "(Required) The unique identifier of the collection" } ] }, "description": "Retrieves records from the specified collection by their IDs or by a metadata filter." }, "response": [ { "id": "555a153f-ca01-4885-89b0-4d5409affdaa", "name": "Records retrieved successfully", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"where\": {\n \"nostrud_3\": 5817435,\n \"cupidatat8a\": \"consectetur nisi\",\n \"Lorem_477\": true\n },\n \"where_document\": {\n \"quisd4\": -26238082.102693334,\n \"aliqua_ce\": \"ad veniam id irur\"\n },\n \"include\": [\n \"uris\",\n \"uris\"\n ],\n \"limit\": \"\",\n \"offset\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/tenants/:tenantName/databases/:databaseName/collections/:collectionId/get", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "tenants", ":tenantName", "databases", ":databaseName", "collections", ":collectionId", "get" ], "variable": [ { "key": "tenantName" }, { "key": "databaseName" }, { "key": "collectionId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"embeddings\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"documents\": [\n \"\",\n \"\"\n ],\n \"metadatas\": [\n {\n \"enim_34b\": false,\n \"estfa\": true\n },\n {\n \"nisi_8_\": -52252089.61575025\n }\n ],\n \"uris\": [\n \"\",\n \"\"\n ]\n}", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-555a153f-ca01-4885-89b0-4d5409affdaa" } ], "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-bcbc5332-d026-4cd7-91c1-4beeb2145b64" } ], "id": "f59b4e2f-81d5-4838-a38d-0480d48c78b3", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-f59b4e2f-81d5-4838-a38d-0480d48c78b3" }, { "name": "update", "item": [ { "name": "Update records in a collection", "id": "b69c654d-2059-430d-bb13-0aec1f97648c", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"embeddings\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"documents\": [\n \"\",\n \"\"\n ],\n \"metadatas\": [\n {\n \"aliqua_d52\": \"officia in proident\",\n \"estc\": true\n },\n {\n \"dolore_7\": \"laboris enim sed aliqui\"\n }\n ],\n \"uris\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/tenants/:tenantName/databases/:databaseName/collections/:collectionId/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "tenants", ":tenantName", "databases", ":databaseName", "collections", ":collectionId", "update" ], "variable": [ { "id": "23e54e39-0522-46cc-865e-6cde79167b79", "key": "tenantName", "value": "", "description": "(Required) The name of the tenant" }, { "id": "3f5f0dfe-7533-4676-8028-e04b9e2db6a8", "key": "databaseName", "value": "", "description": "(Required) The name of the database" }, { "id": "205fd7e5-ffef-4135-8393-7188c4692d17", "key": "collectionId", "value": "", "description": "(Required) The unique identifier of the collection" } ] }, "description": "Updates existing records in the specified collection." }, "response": [ { "id": "a1fb3ae8-d306-4870-8ad3-be6397ca10e8", "name": "Records updated successfully", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"embeddings\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"documents\": [\n \"\",\n \"\"\n ],\n \"metadatas\": [\n {\n \"aliqua_d52\": \"officia in proident\",\n \"estc\": true\n },\n {\n \"dolore_7\": \"laboris enim sed aliqui\"\n }\n ],\n \"uris\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/tenants/:tenantName/databases/:databaseName/collections/:collectionId/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "tenants", ":tenantName", "databases", ":databaseName", "collections", ":collectionId", "update" ], "variable": [ { "key": "tenantName" }, { "key": "databaseName" }, { "key": "collectionId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-a1fb3ae8-d306-4870-8ad3-be6397ca10e8" }, { "id": "91d4d479-a365-4e48-8f87-5bbc9108bbb8", "name": "Records not found", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"embeddings\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"documents\": [\n \"\",\n \"\"\n ],\n \"metadatas\": [\n {\n \"aliqua_d52\": \"officia in proident\",\n \"estc\": true\n },\n {\n \"dolore_7\": \"laboris enim sed aliqui\"\n }\n ],\n \"uris\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/tenants/:tenantName/databases/:databaseName/collections/:collectionId/update", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "tenants", ":tenantName", "databases", ":databaseName", "collections", ":collectionId", "update" ], "variable": [ { "key": "tenantName" }, { "key": "databaseName" }, { "key": "collectionId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-91d4d479-a365-4e48-8f87-5bbc9108bbb8" } ], "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-b69c654d-2059-430d-bb13-0aec1f97648c" } ], "id": "7e61f597-92cd-4f14-9a02-dd5d90eeb4da", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-7e61f597-92cd-4f14-9a02-dd5d90eeb4da" }, { "name": "upsert", "item": [ { "name": "Upsert records in a collection", "id": "0cccd757-d5f5-4132-8d63-de3d88135003", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"embeddings\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"documents\": [\n \"\",\n \"\"\n ],\n \"metadatas\": [\n {\n \"sint_1\": true\n },\n {\n \"mollit___b\": false,\n \"suntc\": true\n }\n ],\n \"uris\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/tenants/:tenantName/databases/:databaseName/collections/:collectionId/upsert", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "tenants", ":tenantName", "databases", ":databaseName", "collections", ":collectionId", "upsert" ], "variable": [ { "id": "e590fd2e-37bb-4f89-a317-217045f2018e", "key": "tenantName", "value": "", "description": "(Required) The name of the tenant" }, { "id": "16f80bb1-ce19-4a7d-bef9-fe82b64ae8a9", "key": "databaseName", "value": "", "description": "(Required) The name of the database" }, { "id": "92827598-ec16-476f-8ad3-5678ce2c0a85", "key": "collectionId", "value": "", "description": "(Required) The unique identifier of the collection" } ] }, "description": "Upserts records in the specified collection. If a record with the given ID already exists, it will be updated. If it does not exist, it will be created." }, "response": [ { "id": "13947b3d-b526-472b-8b34-0f591ca93b00", "name": "Records upserted successfully", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"embeddings\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"documents\": [\n \"\",\n \"\"\n ],\n \"metadatas\": [\n {\n \"sint_1\": true\n },\n {\n \"mollit___b\": false,\n \"suntc\": true\n }\n ],\n \"uris\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/tenants/:tenantName/databases/:databaseName/collections/:collectionId/upsert", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "tenants", ":tenantName", "databases", ":databaseName", "collections", ":collectionId", "upsert" ], "variable": [ { "key": "tenantName" }, { "key": "databaseName" }, { "key": "collectionId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-13947b3d-b526-472b-8b34-0f591ca93b00" }, { "id": "9f1bbf61-b384-4edb-9de1-ed6a606598aa", "name": "Invalid request", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"embeddings\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"documents\": [\n \"\",\n \"\"\n ],\n \"metadatas\": [\n {\n \"sint_1\": true\n },\n {\n \"mollit___b\": false,\n \"suntc\": true\n }\n ],\n \"uris\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/tenants/:tenantName/databases/:databaseName/collections/:collectionId/upsert", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "tenants", ":tenantName", "databases", ":databaseName", "collections", ":collectionId", "upsert" ], "variable": [ { "key": "tenantName" }, { "key": "databaseName" }, { "key": "collectionId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": \"\",\n \"message\": \"\"\n}", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-9f1bbf61-b384-4edb-9de1-ed6a606598aa" } ], "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-0cccd757-d5f5-4132-8d63-de3d88135003" } ], "id": "8eead4f0-5ae6-4eba-800e-20dab7dafbf0", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-8eead4f0-5ae6-4eba-800e-20dab7dafbf0" }, { "name": "delete", "item": [ { "name": "Delete records from a collection", "id": "0fc9aa64-dcdc-4368-9063-3a721eb89fbf", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"where\": {\n \"reprehenderit_dc\": -44858814.49025162\n },\n \"where_document\": {\n \"qui_2ad\": false,\n \"culpa_7\": \"in p\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/tenants/:tenantName/databases/:databaseName/collections/:collectionId/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "tenants", ":tenantName", "databases", ":databaseName", "collections", ":collectionId", "delete" ], "variable": [ { "id": "d0599b8e-3d4f-4ff6-8f7a-2ee34b16daa8", "key": "tenantName", "value": "", "description": "(Required) The name of the tenant" }, { "id": "74655611-5e37-404b-a104-cc0c6782eeb0", "key": "databaseName", "value": "", "description": "(Required) The name of the database" }, { "id": "f7a5735a-a3fe-4261-b4a1-02268b60701f", "key": "collectionId", "value": "", "description": "(Required) The unique identifier of the collection" } ] }, "description": "Deletes records from the specified collection by IDs or metadata filter." }, "response": [ { "id": "fb352c11-5568-4d65-9730-768dd40cbbfd", "name": "Records deleted successfully", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"ids\": [\n \"\",\n \"\"\n ],\n \"where\": {\n \"reprehenderit_dc\": -44858814.49025162\n },\n \"where_document\": {\n \"qui_2ad\": false,\n \"culpa_7\": \"in p\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/tenants/:tenantName/databases/:databaseName/collections/:collectionId/delete", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "tenants", ":tenantName", "databases", ":databaseName", "collections", ":collectionId", "delete" ], "variable": [ { "key": "tenantName" }, { "key": "databaseName" }, { "key": "collectionId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "[\n \"\",\n \"\"\n]", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-fb352c11-5568-4d65-9730-768dd40cbbfd" } ], "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-0fc9aa64-dcdc-4368-9063-3a721eb89fbf" } ], "id": "798f0b86-aea3-43c9-92c5-a816dd97c782", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-798f0b86-aea3-43c9-92c5-a816dd97c782" }, { "name": "query", "item": [ { "name": "Query records in a collection", "id": "6dbc35cd-f67d-4e2e-9fd3-8ebdbbdb3c73", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"query_embeddings\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"query_texts\": [\n \"\",\n \"\"\n ],\n \"n_results\": 10,\n \"where\": {\n \"commodo6\": 95491394.1810737\n },\n \"where_document\": {\n \"doloreb\": 8908695,\n \"fugiat9\": -785953.0849610716\n },\n \"include\": [\n \"metadatas\",\n \"metadatas\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/tenants/:tenantName/databases/:databaseName/collections/:collectionId/query", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "tenants", ":tenantName", "databases", ":databaseName", "collections", ":collectionId", "query" ], "variable": [ { "id": "9e774c25-fbc7-48bf-bad3-7b4ccae61f59", "key": "tenantName", "value": "", "description": "(Required) The name of the tenant" }, { "id": "977599c9-18cb-4340-ae32-83ecb4a43edc", "key": "databaseName", "value": "", "description": "(Required) The name of the database" }, { "id": "ee19d4b2-2b93-4e49-9f2f-8ab559be0ad5", "key": "collectionId", "value": "", "description": "(Required) The unique identifier of the collection" } ] }, "description": "Performs a vector similarity search on the specified collection. Returns the nearest neighbors to the provided query embeddings or query texts." }, "response": [ { "id": "3fcfda22-c2fe-4a82-884f-c425b035d53d", "name": "Query results", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: bearer", "key": "Authorization", "value": "Bearer " } ], "body": { "mode": "raw", "raw": "{\n \"query_embeddings\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"query_texts\": [\n \"\",\n \"\"\n ],\n \"n_results\": 10,\n \"where\": {\n \"commodo6\": 95491394.1810737\n },\n \"where_document\": {\n \"doloreb\": 8908695,\n \"fugiat9\": -785953.0849610716\n },\n \"include\": [\n \"metadatas\",\n \"metadatas\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/v2/tenants/:tenantName/databases/:databaseName/collections/:collectionId/query", "host": [ "{{baseUrl}}" ], "path": [ "api", "v2", "tenants", ":tenantName", "databases", ":databaseName", "collections", ":collectionId", "query" ], "variable": [ { "key": "tenantName" }, { "key": "databaseName" }, { "key": "collectionId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"ids\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"embeddings\": [\n [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ]\n ],\n \"documents\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"metadatas\": [\n [\n {\n \"esse3\": -67572990,\n \"laborumb\": true\n },\n {\n \"adipisicing__8\": \"anim ut elit\",\n \"sit_e\": -13891540\n }\n ],\n [\n {\n \"ex_e\": true\n },\n {\n \"exercitation_1\": 82214375.94901082,\n \"ina\": \"laborum pariatur laboris eiusmod cul\"\n }\n ]\n ],\n \"distances\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ],\n \"uris\": [\n [\n \"\",\n \"\"\n ],\n [\n \"\",\n \"\"\n ]\n ]\n}", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-3fcfda22-c2fe-4a82-884f-c425b035d53d" } ], "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-6dbc35cd-f67d-4e2e-9fd3-8ebdbbdb3c73" } ], "id": "13f87972-b90b-4908-8046-a1d5857b97f5", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-13f87972-b90b-4908-8046-a1d5857b97f5" } ], "id": "0dda4a29-ed31-4c0f-bcfa-9996cb4ac6c5", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-0dda4a29-ed31-4c0f-bcfa-9996cb4ac6c5" } ], "id": "3cf8208d-f491-4ed9-b864-4ff51a6402e5", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-3cf8208d-f491-4ed9-b864-4ff51a6402e5" } ], "id": "d6340d3a-372b-4a23-b656-2ff27b18501b", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-d6340d3a-372b-4a23-b656-2ff27b18501b" } ], "id": "0d07c95a-ddbb-421b-b3d0-6a182455acc5", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-0d07c95a-ddbb-421b-b3d0-6a182455acc5" } ], "id": "6b0b9010-ce9c-444c-a2f2-efd0606408f7", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-6b0b9010-ce9c-444c-a2f2-efd0606408f7" } ], "id": "9a5359ee-0340-42eb-bedc-afaaf4ce6320", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-9a5359ee-0340-42eb-bedc-afaaf4ce6320" } ], "id": "e63ae5ac-3e09-404d-bafc-b1bdb5b52512", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-e63ae5ac-3e09-404d-bafc-b1bdb5b52512" } ], "id": "37fff764-a7a0-4656-90e9-3a87f1b932f5", "createdAt": "2026-07-28T01:20:40.000Z", "updatedAt": "2026-07-28T01:20:40.000Z", "uid": "35240-37fff764-a7a0-4656-90e9-3a87f1b932f5" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{bearerToken}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://api.trychroma.com" } ] }