API
파일 업로드
요청 본문으로 보내 백그라운드에서 읽는 문서나 이미지.
POST/knowledge/files
워크스페이스에 실제 호출을 실행합니다.
POST /knowledge/files
요청 본문으로 보내 백그라운드에서 읽는 문서나 이미지.
예시
knowledge:write가 필요합니다. 파일 자체를 Content-Type과 함께 본문으로 보내고, filename이나 X-Filename 헤더로 이름을 붙이세요. scope와 title도 쿼리에 넣습니다. 문서는 최대 20MB, 이미지는 최대 10MB입니다. queued 상태의 파일과 함께 201로 응답합니다.
curl -X POST "$OE/knowledge/files?filename=price-list.pdf&[email protected]" -H "$AUTH" \ -H "Content-Type: application/pdf" --data-binary @price-list.pdf{ "object": "knowledge_item", "id": "kb_9a4d2c7e1b5f3086d2e4a19c", "kind": "file", "scope": "[email protected]", "level": "address", "title": "price-list", "url": null, "fileName": "price-list.pdf", "mimeType": "application/pdf", "sizeBytes": 482113, "pinned": false, "status": "queued", "failure": null, "chunks": 0, "chars": 0, "origin": "api", "createdBy": "usr_5f2a9c71", "createdAt": "2026-10-08T09:15:30.000Z", "updatedAt": "2026-10-08T09:15:30.000Z", "indexedAt": null}Content-Type이 일반적인 값이면 이름의 확장자로 파일 종류를 판단합니다. 읽을 수 없는 종류의 파일은 422 knowledge_file_unsupported, 빈 파일은 422 knowledge_file_empty, 한도를 넘는 파일은 413 knowledge_file_too_large입니다.
텍스트가 없는 파일은 failure: "empty"와 함께 failed로 끝납니다. 같은 파일을 두 번 보내면 두 번 저장됩니다.