{ "info": { "_postman_id": "3b72c0bc-21e7-4291-b83b-a60a182422b2", "name": "Fast Agents Knowledge Files API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "lastUpdatedBy": "35240", "uid": "35240-3b72c0bc-21e7-4291-b83b-a60a182422b2" }, "item": [ { "name": "v1", "item": [ { "name": "knowledge-files", "item": [ { "name": "{id}", "item": [ { "name": "upload", "item": [ { "name": "Upload Knowledge File Chunk", "id": "12870aa7-b615-4813-ab9e-fd9c92023075", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "x-api-key", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/knowledge-files/:id/upload?chunk_number=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "knowledge-files", ":id", "upload" ], "query": [ { "description": "(Required) Chunk number, starting from 0.", "key": "chunk_number", "value": "" } ], "variable": [ { "id": "0af3a067-ae25-40e0-8cfd-8c7d11e4c81c", "key": "id", "value": "", "description": "(Required) Knowledge File ID." } ] }, "description": "Upload a single chunk of a knowledge file." }, "response": [ { "id": "a3ca3b1c-7d4f-42d3-bd5f-b5e69e5b7359", "name": "Successful Response", "originalRequest": { "method": "PUT", "header": [ { "description": "Added as a part of security scheme: apikey", "key": "x-api-key", "value": "" } ], "url": { "raw": "{{baseUrl}}/v1/knowledge-files/:id/upload?chunk_number=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "knowledge-files", ":id", "upload" ], "query": [ { "description": "(Required) Chunk number, starting from 0.", "key": "chunk_number", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-a3ca3b1c-7d4f-42d3-bd5f-b5e69e5b7359" }, { "id": "38b2a42d-3cb1-46d8-96c4-c8204d898d81", "name": "Validation Error", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "x-api-key", "value": "" } ], "url": { "raw": "{{baseUrl}}/v1/knowledge-files/:id/upload?chunk_number=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "knowledge-files", ":id", "upload" ], "query": [ { "description": "(Required) Chunk number, starting from 0.", "key": "chunk_number", "value": "" } ], "variable": [ { "key": "id" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"detail\": [\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\"\n },\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-38b2a42d-3cb1-46d8-96c4-c8204d898d81" } ], "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-12870aa7-b615-4813-ab9e-fd9c92023075" } ], "id": "c6394d58-513b-44af-a46f-3628b3e38bd3", "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-c6394d58-513b-44af-a46f-3628b3e38bd3" }, { "name": "submit", "item": [ { "name": "Submit Knowledge File", "id": "9362922e-0340-49e2-85f5-ed9d198c213d", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "x-api-key", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/knowledge-files/:id/submit", "host": [ "{{baseUrl}}" ], "path": [ "v1", "knowledge-files", ":id", "submit" ], "variable": [ { "id": "441a5d0d-2a07-453b-8b15-e595625ec174", "key": "id", "value": "", "description": "(Required) Knowledge File ID." } ] }, "description": "Submit and finalize a chunked knowledge file upload." }, "response": [ { "id": "6f5a2714-6eca-4187-9987-42852cf4c358", "name": "Processed Knowledge File", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "x-api-key", "value": "" } ], "url": { "raw": "{{baseUrl}}/v1/knowledge-files/:id/submit", "host": [ "{{baseUrl}}" ], "path": [ "v1", "knowledge-files", ":id", "submit" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"format\": \"text\",\n \"status\": \"to-upload\"\n}", "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-6f5a2714-6eca-4187-9987-42852cf4c358" }, { "id": "907d3238-2ec6-4336-bb9b-ccfb3c137444", "name": "Validation Error", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "x-api-key", "value": "" } ], "url": { "raw": "{{baseUrl}}/v1/knowledge-files/:id/submit", "host": [ "{{baseUrl}}" ], "path": [ "v1", "knowledge-files", ":id", "submit" ], "variable": [ { "key": "id" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"detail\": [\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\"\n },\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-907d3238-2ec6-4336-bb9b-ccfb3c137444" } ], "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-9362922e-0340-49e2-85f5-ed9d198c213d" } ], "id": "a8df23aa-2452-4b51-87dc-d4e3c96f968f", "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-a8df23aa-2452-4b51-87dc-d4e3c96f968f" }, { "name": "Retrieve Knowledge File", "id": "8fec3596-2ad3-430e-875a-ca7db836b291", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "x-api-key", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/knowledge-files/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "knowledge-files", ":id" ], "variable": [ { "id": "3561091f-ec2b-4587-9d32-7d31cbbc3ac0", "key": "id", "value": "", "description": "(Required) Knowledge File ID." } ] }, "description": "Retrieve knowledge file by ID." }, "response": [ { "id": "70e79a2f-383a-49b4-84d2-354626ac0d0a", "name": "Requested Knowledge File", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "x-api-key", "value": "" } ], "url": { "raw": "{{baseUrl}}/v1/knowledge-files/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "knowledge-files", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"format\": \"text\",\n \"status\": \"to-upload\"\n}", "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-70e79a2f-383a-49b4-84d2-354626ac0d0a" }, { "id": "abf7e786-bef6-4102-a722-f42c9b350a73", "name": "Validation Error", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "x-api-key", "value": "" } ], "url": { "raw": "{{baseUrl}}/v1/knowledge-files/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "knowledge-files", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"detail\": [\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\"\n },\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-abf7e786-bef6-4102-a722-f42c9b350a73" } ], "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-8fec3596-2ad3-430e-875a-ca7db836b291" }, { "name": "Delete Knowledge File", "id": "19baed14-8570-42f4-8cf9-8323f51c800f", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "x-api-key", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/knowledge-files/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "knowledge-files", ":id" ], "variable": [ { "id": "3482fda2-9e58-42fe-a8c7-4dcaa3f1a056", "key": "id", "value": "", "description": "(Required) Knowledge File ID." } ] }, "description": "Delete a knowledge file." }, "response": [ { "id": "e09f1224-c45f-4629-a93a-6079a7ea0d98", "name": "Successful Response", "originalRequest": { "method": "DELETE", "header": [ { "description": "Added as a part of security scheme: apikey", "key": "x-api-key", "value": "" } ], "url": { "raw": "{{baseUrl}}/v1/knowledge-files/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "knowledge-files", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-e09f1224-c45f-4629-a93a-6079a7ea0d98" }, { "id": "4bbc9d74-736e-4b98-8ffb-d53476804def", "name": "Validation Error", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "x-api-key", "value": "" } ], "url": { "raw": "{{baseUrl}}/v1/knowledge-files/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "knowledge-files", ":id" ], "variable": [ { "key": "id" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"detail\": [\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\"\n },\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-4bbc9d74-736e-4b98-8ffb-d53476804def" } ], "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-19baed14-8570-42f4-8cf9-8323f51c800f" } ], "id": "9a9d4588-64eb-4883-aac6-13c50cef4abb", "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-9a9d4588-64eb-4883-aac6-13c50cef4abb" }, { "name": "List Knowledge Files", "id": "9ba017c7-2522-4308-b7a4-0999910f2824", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "x-api-key", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/knowledge-files?limit=10&cursor=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "knowledge-files" ], "query": [ { "description": "Maximum number of objects to return.", "key": "limit", "value": "10" }, { "description": "Cursor for pagination.", "key": "cursor", "value": "" } ] }, "description": "List available knowledge files." }, "response": [ { "id": "832faf3b-9465-4833-a91f-c8fdb809e4e8", "name": "Paginated List of Knowledge Files", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "x-api-key", "value": "" } ], "url": { "raw": "{{baseUrl}}/v1/knowledge-files?limit=10&cursor=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "knowledge-files" ], "query": [ { "description": "Maximum number of objects to return.", "key": "limit", "value": "10" }, { "description": "Cursor for pagination.", "key": "cursor", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"data\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"format\": \"pdf\",\n \"status\": \"to-upload\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"format\": \"text\",\n \"status\": \"to-upload\"\n }\n ],\n \"next_cursor\": \"\",\n \"has_more\": true\n}", "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-832faf3b-9465-4833-a91f-c8fdb809e4e8" }, { "id": "c54510a9-fbf7-466d-b957-6cfb8b42052f", "name": "Validation Error", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "x-api-key", "value": "" } ], "url": { "raw": "{{baseUrl}}/v1/knowledge-files?limit=10&cursor=", "host": [ "{{baseUrl}}" ], "path": [ "v1", "knowledge-files" ], "query": [ { "description": "Maximum number of objects to return.", "key": "limit", "value": "10" }, { "description": "Cursor for pagination.", "key": "cursor", "value": "" } ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"detail\": [\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\"\n },\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-c54510a9-fbf7-466d-b957-6cfb8b42052f" } ], "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-9ba017c7-2522-4308-b7a4-0999910f2824" }, { "name": "Create Knowledge File", "id": "5f094050-2c2e-4bdc-9df5-0b30af388329", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "x-api-key", "type": "string" }, { "key": "value", "value": "{{apiKey}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"format\": \"\",\n \"content\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/knowledge-files", "host": [ "{{baseUrl}}" ], "path": [ "v1", "knowledge-files" ] }, "description": "Create a new knowledge file and initialize chunked upload." }, "response": [ { "id": "5ca042ec-eac1-421a-aab7-dd6081f61331", "name": "Created Knowledge File", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "x-api-key", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"format\": \"\",\n \"content\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/knowledge-files", "host": [ "{{baseUrl}}" ], "path": [ "v1", "knowledge-files" ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"name\": \"\",\n \"format\": \"text\",\n \"status\": \"to-upload\"\n}", "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-5ca042ec-eac1-421a-aab7-dd6081f61331" }, { "id": "6a7cbd29-766e-4bae-bf23-83ae49e5caca", "name": "Validation Error", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: apikey", "key": "x-api-key", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"format\": \"\",\n \"content\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/v1/knowledge-files", "host": [ "{{baseUrl}}" ], "path": [ "v1", "knowledge-files" ] } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"detail\": [\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\"\n },\n {\n \"loc\": [\n \"\",\n \"\"\n ],\n \"msg\": \"\",\n \"type\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-6a7cbd29-766e-4bae-bf23-83ae49e5caca" } ], "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-5f094050-2c2e-4bdc-9df5-0b30af388329" } ], "id": "285c2723-8075-42e6-8f92-9d48ac471eda", "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-285c2723-8075-42e6-8f92-9d48ac471eda" } ], "id": "87098ec2-9074-4e1f-8597-4032538dee28", "createdAt": "2026-07-28T01:13:12.000Z", "updatedAt": "2026-07-28T01:13:12.000Z", "uid": "35240-87098ec2-9074-4e1f-8597-4032538dee28" } ], "variable": [ { "key": "baseUrl", "value": "https://api.bey.dev" } ] }