trieve_ruby_client 0.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (272) hide show
  1. checksums.yaml +7 -0
  2. data/Gemfile +9 -0
  3. data/LICENSE +21 -0
  4. data/README.md +240 -0
  5. data/Rakefile +10 -0
  6. data/docs/AddChunkToGroupData.md +18 -0
  7. data/docs/ApiKeyDTO.md +28 -0
  8. data/docs/AuthApi.md +274 -0
  9. data/docs/BookmarkData.md +22 -0
  10. data/docs/BookmarkGroupResult.md +20 -0
  11. data/docs/ChatMessageProxy.md +20 -0
  12. data/docs/ChunkApi.md +955 -0
  13. data/docs/ChunkFilter.md +22 -0
  14. data/docs/ChunkGroup.md +30 -0
  15. data/docs/ChunkGroupAndFile.md +32 -0
  16. data/docs/ChunkGroupApi.md +1262 -0
  17. data/docs/ChunkMetadata.md +42 -0
  18. data/docs/ChunkMetadataWithFileData.md +44 -0
  19. data/docs/ClientDatasetConfiguration.md +38 -0
  20. data/docs/CreateChunkData.md +42 -0
  21. data/docs/CreateChunkGroupData.md +22 -0
  22. data/docs/CreateDatasetRequest.md +24 -0
  23. data/docs/CreateMessageData.md +28 -0
  24. data/docs/CreateOrganizationData.md +18 -0
  25. data/docs/CreateTopicData.md +22 -0
  26. data/docs/Dataset.md +30 -0
  27. data/docs/DatasetAndUsage.md +20 -0
  28. data/docs/DatasetApi.md +480 -0
  29. data/docs/DatasetDTO.md +28 -0
  30. data/docs/DatasetUsageCount.md +22 -0
  31. data/docs/DeleteDatasetRequest.md +18 -0
  32. data/docs/DeleteTopicData.md +18 -0
  33. data/docs/DeleteUserApiKeyRequest.md +18 -0
  34. data/docs/EditMessageData.md +30 -0
  35. data/docs/ErrorResponseBody.md +18 -0
  36. data/docs/Event.md +28 -0
  37. data/docs/EventReturn.md +20 -0
  38. data/docs/EventsApi.md +86 -0
  39. data/docs/FieldCondition.md +22 -0
  40. data/docs/File.md +36 -0
  41. data/docs/FileApi.md +326 -0
  42. data/docs/FileDTO.md +32 -0
  43. data/docs/GenerateChunksRequest.md +26 -0
  44. data/docs/GetGroupsForChunksData.md +18 -0
  45. data/docs/GroupData.md +20 -0
  46. data/docs/GroupScoreChunkDTO.md +20 -0
  47. data/docs/HealthApi.md +66 -0
  48. data/docs/InvitationApi.md +85 -0
  49. data/docs/InvitationData.md +26 -0
  50. data/docs/MatchCondition.md +49 -0
  51. data/docs/Message.md +38 -0
  52. data/docs/MessageApi.md +322 -0
  53. data/docs/Organization.md +26 -0
  54. data/docs/OrganizationApi.md +479 -0
  55. data/docs/OrganizationUsageCount.md +28 -0
  56. data/docs/Range.md +24 -0
  57. data/docs/ReccomendGroupChunksRequest.md +30 -0
  58. data/docs/RecommendChunksRequest.md +28 -0
  59. data/docs/RegenerateMessageData.md +26 -0
  60. data/docs/ReturnQueuedChunk.md +20 -0
  61. data/docs/ScoreChunkDTO.md +20 -0
  62. data/docs/SearchChunkData.md +38 -0
  63. data/docs/SearchChunkQueryResponseBody.md +20 -0
  64. data/docs/SearchGroupsResult.md +22 -0
  65. data/docs/SearchOverGroupsData.md +36 -0
  66. data/docs/SearchOverGroupsResponseBody.md +20 -0
  67. data/docs/SearchWithinGroupData.md +40 -0
  68. data/docs/SetUserApiKeyRequest.md +20 -0
  69. data/docs/SetUserApiKeyResponse.md +18 -0
  70. data/docs/SlimGroup.md +24 -0
  71. data/docs/SlimUser.md +32 -0
  72. data/docs/StripeApi.md +285 -0
  73. data/docs/StripePlan.md +38 -0
  74. data/docs/StripeSubscription.md +30 -0
  75. data/docs/SuggestedQueriesRequest.md +18 -0
  76. data/docs/SuggestedQueriesResponse.md +18 -0
  77. data/docs/Topic.md +30 -0
  78. data/docs/TopicApi.md +321 -0
  79. data/docs/UpdateChunkByTrackingIdData.md +32 -0
  80. data/docs/UpdateChunkData.md +34 -0
  81. data/docs/UpdateChunkGroupData.md +24 -0
  82. data/docs/UpdateDatasetRequest.md +24 -0
  83. data/docs/UpdateGroupByTrackingIDData.md +22 -0
  84. data/docs/UpdateOrganizationData.md +20 -0
  85. data/docs/UpdateTopicData.md +20 -0
  86. data/docs/UpdateUserData.md +30 -0
  87. data/docs/UploadFileData.md +34 -0
  88. data/docs/UploadFileResult.md +18 -0
  89. data/docs/UserApi.md +238 -0
  90. data/docs/UserOrganization.md +28 -0
  91. data/git_push.sh +57 -0
  92. data/lib/trieve_ruby_client/api/auth_api.rb +262 -0
  93. data/lib/trieve_ruby_client/api/chunk_api.rb +906 -0
  94. data/lib/trieve_ruby_client/api/chunk_group_api.rb +1230 -0
  95. data/lib/trieve_ruby_client/api/dataset_api.rb +458 -0
  96. data/lib/trieve_ruby_client/api/events_api.rb +92 -0
  97. data/lib/trieve_ruby_client/api/file_api.rb +324 -0
  98. data/lib/trieve_ruby_client/api/health_api.rb +75 -0
  99. data/lib/trieve_ruby_client/api/invitation_api.rb +97 -0
  100. data/lib/trieve_ruby_client/api/message_api.rb +317 -0
  101. data/lib/trieve_ruby_client/api/organization_api.rb +445 -0
  102. data/lib/trieve_ruby_client/api/stripe_api.rb +278 -0
  103. data/lib/trieve_ruby_client/api/topic_api.rb +317 -0
  104. data/lib/trieve_ruby_client/api/user_api.rb +226 -0
  105. data/lib/trieve_ruby_client/api_client.rb +394 -0
  106. data/lib/trieve_ruby_client/api_error.rb +58 -0
  107. data/lib/trieve_ruby_client/configuration.rb +305 -0
  108. data/lib/trieve_ruby_client/models/add_chunk_to_group_data.rb +222 -0
  109. data/lib/trieve_ruby_client/models/api_key_dto.rb +301 -0
  110. data/lib/trieve_ruby_client/models/bookmark_data.rb +255 -0
  111. data/lib/trieve_ruby_client/models/bookmark_group_result.rb +239 -0
  112. data/lib/trieve_ruby_client/models/chat_message_proxy.rb +237 -0
  113. data/lib/trieve_ruby_client/models/chunk_filter.rb +244 -0
  114. data/lib/trieve_ruby_client/models/chunk_group.rb +311 -0
  115. data/lib/trieve_ruby_client/models/chunk_group_and_file.rb +321 -0
  116. data/lib/trieve_ruby_client/models/chunk_metadata.rb +371 -0
  117. data/lib/trieve_ruby_client/models/chunk_metadata_with_file_data.rb +381 -0
  118. data/lib/trieve_ruby_client/models/client_dataset_configuration.rb +336 -0
  119. data/lib/trieve_ruby_client/models/create_chunk_data.rb +356 -0
  120. data/lib/trieve_ruby_client/models/create_chunk_group_data.rb +250 -0
  121. data/lib/trieve_ruby_client/models/create_dataset_request.rb +265 -0
  122. data/lib/trieve_ruby_client/models/create_message_data.rb +285 -0
  123. data/lib/trieve_ruby_client/models/create_organization_data.rb +222 -0
  124. data/lib/trieve_ruby_client/models/create_topic_data.rb +238 -0
  125. data/lib/trieve_ruby_client/models/dataset.rb +309 -0
  126. data/lib/trieve_ruby_client/models/dataset_and_usage.rb +237 -0
  127. data/lib/trieve_ruby_client/models/dataset_dto.rb +297 -0
  128. data/lib/trieve_ruby_client/models/dataset_usage_count.rb +253 -0
  129. data/lib/trieve_ruby_client/models/delete_dataset_request.rb +222 -0
  130. data/lib/trieve_ruby_client/models/delete_topic_data.rb +222 -0
  131. data/lib/trieve_ruby_client/models/delete_user_api_key_request.rb +222 -0
  132. data/lib/trieve_ruby_client/models/edit_message_data.rb +302 -0
  133. data/lib/trieve_ruby_client/models/error_response_body.rb +221 -0
  134. data/lib/trieve_ruby_client/models/event.rb +297 -0
  135. data/lib/trieve_ruby_client/models/event_return.rb +239 -0
  136. data/lib/trieve_ruby_client/models/field_condition.rb +245 -0
  137. data/lib/trieve_ruby_client/models/file.rb +341 -0
  138. data/lib/trieve_ruby_client/models/file_dto.rb +321 -0
  139. data/lib/trieve_ruby_client/models/generate_chunks_request.rb +276 -0
  140. data/lib/trieve_ruby_client/models/get_groups_for_chunks_data.rb +223 -0
  141. data/lib/trieve_ruby_client/models/group_data.rb +239 -0
  142. data/lib/trieve_ruby_client/models/group_score_chunk_dto.rb +239 -0
  143. data/lib/trieve_ruby_client/models/invitation_data.rb +290 -0
  144. data/lib/trieve_ruby_client/models/match_condition.rb +105 -0
  145. data/lib/trieve_ruby_client/models/message.rb +369 -0
  146. data/lib/trieve_ruby_client/models/organization.rb +279 -0
  147. data/lib/trieve_ruby_client/models/organization_usage_count.rb +301 -0
  148. data/lib/trieve_ruby_client/models/range.rb +245 -0
  149. data/lib/trieve_ruby_client/models/reccomend_group_chunks_request.rb +319 -0
  150. data/lib/trieve_ruby_client/models/recommend_chunks_request.rb +293 -0
  151. data/lib/trieve_ruby_client/models/regenerate_message_data.rb +268 -0
  152. data/lib/trieve_ruby_client/models/return_queued_chunk.rb +237 -0
  153. data/lib/trieve_ruby_client/models/score_chunk_dto.rb +239 -0
  154. data/lib/trieve_ruby_client/models/search_chunk_data.rb +369 -0
  155. data/lib/trieve_ruby_client/models/search_chunk_query_response_body.rb +239 -0
  156. data/lib/trieve_ruby_client/models/search_groups_result.rb +255 -0
  157. data/lib/trieve_ruby_client/models/search_over_groups_data.rb +372 -0
  158. data/lib/trieve_ruby_client/models/search_over_groups_response_body.rb +239 -0
  159. data/lib/trieve_ruby_client/models/search_within_group_data.rb +380 -0
  160. data/lib/trieve_ruby_client/models/set_user_api_key_request.rb +239 -0
  161. data/lib/trieve_ruby_client/models/set_user_api_key_response.rb +222 -0
  162. data/lib/trieve_ruby_client/models/slim_group.rb +269 -0
  163. data/lib/trieve_ruby_client/models/slim_user.rb +319 -0
  164. data/lib/trieve_ruby_client/models/stripe_plan.rb +381 -0
  165. data/lib/trieve_ruby_client/models/stripe_subscription.rb +311 -0
  166. data/lib/trieve_ruby_client/models/suggested_queries_request.rb +222 -0
  167. data/lib/trieve_ruby_client/models/suggested_queries_response.rb +223 -0
  168. data/lib/trieve_ruby_client/models/topic.rb +317 -0
  169. data/lib/trieve_ruby_client/models/update_chunk_by_tracking_id_data.rb +303 -0
  170. data/lib/trieve_ruby_client/models/update_chunk_data.rb +308 -0
  171. data/lib/trieve_ruby_client/models/update_chunk_group_data.rb +249 -0
  172. data/lib/trieve_ruby_client/models/update_dataset_request.rb +255 -0
  173. data/lib/trieve_ruby_client/models/update_group_by_tracking_id_data.rb +244 -0
  174. data/lib/trieve_ruby_client/models/update_organization_data.rb +233 -0
  175. data/lib/trieve_ruby_client/models/update_topic_data.rb +239 -0
  176. data/lib/trieve_ruby_client/models/update_user_data.rb +288 -0
  177. data/lib/trieve_ruby_client/models/upload_file_data.rb +324 -0
  178. data/lib/trieve_ruby_client/models/upload_file_result.rb +221 -0
  179. data/lib/trieve_ruby_client/models/user_organization.rb +301 -0
  180. data/lib/trieve_ruby_client/version.rb +15 -0
  181. data/lib/trieve_ruby_client.rb +124 -0
  182. data/openapi-generator.yaml +9 -0
  183. data/openapi.json +6530 -0
  184. data/openapitools.json +7 -0
  185. data/spec/api/auth_api_spec.rb +82 -0
  186. data/spec/api/chunk_api_spec.rb +191 -0
  187. data/spec/api/chunk_group_api_spec.rb +242 -0
  188. data/spec/api/dataset_api_spec.rb +113 -0
  189. data/spec/api/events_api_spec.rb +48 -0
  190. data/spec/api/file_api_spec.rb +89 -0
  191. data/spec/api/health_api_spec.rb +44 -0
  192. data/spec/api/invitation_api_spec.rb +48 -0
  193. data/spec/api/message_api_spec.rb +87 -0
  194. data/spec/api/organization_api_spec.rb +112 -0
  195. data/spec/api/stripe_api_spec.rb +78 -0
  196. data/spec/api/topic_api_spec.rb +87 -0
  197. data/spec/api/user_api_spec.rb +71 -0
  198. data/spec/models/add_chunk_to_group_data_spec.rb +36 -0
  199. data/spec/models/api_key_dto_spec.rb +66 -0
  200. data/spec/models/bookmark_data_spec.rb +48 -0
  201. data/spec/models/bookmark_group_result_spec.rb +42 -0
  202. data/spec/models/chat_message_proxy_spec.rb +42 -0
  203. data/spec/models/chunk_filter_spec.rb +48 -0
  204. data/spec/models/chunk_group_and_file_spec.rb +78 -0
  205. data/spec/models/chunk_group_spec.rb +72 -0
  206. data/spec/models/chunk_metadata_spec.rb +108 -0
  207. data/spec/models/chunk_metadata_with_file_data_spec.rb +114 -0
  208. data/spec/models/client_dataset_configuration_spec.rb +96 -0
  209. data/spec/models/create_chunk_data_spec.rb +108 -0
  210. data/spec/models/create_chunk_group_data_spec.rb +48 -0
  211. data/spec/models/create_dataset_request_spec.rb +54 -0
  212. data/spec/models/create_message_data_spec.rb +66 -0
  213. data/spec/models/create_organization_data_spec.rb +36 -0
  214. data/spec/models/create_topic_data_spec.rb +48 -0
  215. data/spec/models/dataset_and_usage_spec.rb +42 -0
  216. data/spec/models/dataset_dto_spec.rb +66 -0
  217. data/spec/models/dataset_spec.rb +72 -0
  218. data/spec/models/dataset_usage_count_spec.rb +48 -0
  219. data/spec/models/delete_dataset_request_spec.rb +36 -0
  220. data/spec/models/delete_topic_data_spec.rb +36 -0
  221. data/spec/models/delete_user_api_key_request_spec.rb +36 -0
  222. data/spec/models/edit_message_data_spec.rb +72 -0
  223. data/spec/models/error_response_body_spec.rb +36 -0
  224. data/spec/models/event_return_spec.rb +42 -0
  225. data/spec/models/event_spec.rb +66 -0
  226. data/spec/models/field_condition_spec.rb +48 -0
  227. data/spec/models/file_dto_spec.rb +78 -0
  228. data/spec/models/file_spec.rb +90 -0
  229. data/spec/models/generate_chunks_request_spec.rb +60 -0
  230. data/spec/models/get_groups_for_chunks_data_spec.rb +36 -0
  231. data/spec/models/group_data_spec.rb +42 -0
  232. data/spec/models/group_score_chunk_dto_spec.rb +42 -0
  233. data/spec/models/invitation_data_spec.rb +60 -0
  234. data/spec/models/match_condition_spec.rb +32 -0
  235. data/spec/models/message_spec.rb +96 -0
  236. data/spec/models/organization_spec.rb +60 -0
  237. data/spec/models/organization_usage_count_spec.rb +66 -0
  238. data/spec/models/range_spec.rb +54 -0
  239. data/spec/models/reccomend_group_chunks_request_spec.rb +72 -0
  240. data/spec/models/recommend_chunks_request_spec.rb +66 -0
  241. data/spec/models/regenerate_message_data_spec.rb +60 -0
  242. data/spec/models/return_queued_chunk_spec.rb +42 -0
  243. data/spec/models/score_chunk_dto_spec.rb +42 -0
  244. data/spec/models/search_chunk_data_spec.rb +96 -0
  245. data/spec/models/search_chunk_query_response_body_spec.rb +42 -0
  246. data/spec/models/search_groups_result_spec.rb +48 -0
  247. data/spec/models/search_over_groups_data_spec.rb +90 -0
  248. data/spec/models/search_over_groups_response_body_spec.rb +42 -0
  249. data/spec/models/search_within_group_data_spec.rb +102 -0
  250. data/spec/models/set_user_api_key_request_spec.rb +42 -0
  251. data/spec/models/set_user_api_key_response_spec.rb +36 -0
  252. data/spec/models/slim_group_spec.rb +54 -0
  253. data/spec/models/slim_user_spec.rb +78 -0
  254. data/spec/models/stripe_plan_spec.rb +96 -0
  255. data/spec/models/stripe_subscription_spec.rb +72 -0
  256. data/spec/models/suggested_queries_request_spec.rb +36 -0
  257. data/spec/models/suggested_queries_response_spec.rb +36 -0
  258. data/spec/models/topic_spec.rb +72 -0
  259. data/spec/models/update_chunk_by_tracking_id_data_spec.rb +66 -0
  260. data/spec/models/update_chunk_data_spec.rb +72 -0
  261. data/spec/models/update_chunk_group_data_spec.rb +48 -0
  262. data/spec/models/update_dataset_request_spec.rb +54 -0
  263. data/spec/models/update_group_by_tracking_id_data_spec.rb +48 -0
  264. data/spec/models/update_organization_data_spec.rb +42 -0
  265. data/spec/models/update_topic_data_spec.rb +42 -0
  266. data/spec/models/update_user_data_spec.rb +72 -0
  267. data/spec/models/upload_file_data_spec.rb +84 -0
  268. data/spec/models/upload_file_result_spec.rb +36 -0
  269. data/spec/models/user_organization_spec.rb +66 -0
  270. data/spec/spec_helper.rb +111 -0
  271. data/trieve_ruby_client.gemspec +39 -0
  272. metadata +439 -0
data/docs/Topic.md ADDED
@@ -0,0 +1,30 @@
1
+ # TrieveRubyClient::Topic
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **created_at** | **Time** | | |
8
+ | **dataset_id** | **String** | | |
9
+ | **deleted** | **Boolean** | | |
10
+ | **id** | **String** | | |
11
+ | **name** | **String** | | |
12
+ | **updated_at** | **Time** | | |
13
+ | **user_id** | **String** | | |
14
+
15
+ ## Example
16
+
17
+ ```ruby
18
+ require 'trieve_ruby_client'
19
+
20
+ instance = TrieveRubyClient::Topic.new(
21
+ created_at: null,
22
+ dataset_id: null,
23
+ deleted: null,
24
+ id: null,
25
+ name: null,
26
+ updated_at: null,
27
+ user_id: null
28
+ )
29
+ ```
30
+
data/docs/TopicApi.md ADDED
@@ -0,0 +1,321 @@
1
+ # TrieveRubyClient::TopicApi
2
+
3
+ All URIs are relative to *http://localhost*
4
+
5
+ | Method | HTTP request | Description |
6
+ | ------ | ------------ | ----------- |
7
+ | [**create_topic**](TopicApi.md#create_topic) | **POST** /api/topic | create_topic |
8
+ | [**delete_topic**](TopicApi.md#delete_topic) | **DELETE** /api/topic | delete_topic |
9
+ | [**get_all_topics_for_user**](TopicApi.md#get_all_topics_for_user) | **GET** /api/topic/user/{user_id} | get_all_topics_for_user |
10
+ | [**update_topic**](TopicApi.md#update_topic) | **PUT** /api/topic | update_topic |
11
+
12
+
13
+ ## create_topic
14
+
15
+ > <Topic> create_topic(tr_dataset, create_topic_data)
16
+
17
+ create_topic
18
+
19
+ create_topic Create a new chat topic. Topics are attached to a user and act as a coordinator for memory of gen-AI chat sessions. We are considering refactoring this resource of the API soon.
20
+
21
+ ### Examples
22
+
23
+ ```ruby
24
+ require 'time'
25
+ require 'trieve_ruby_client'
26
+ # setup authorization
27
+ TrieveRubyClient.configure do |config|
28
+ # Configure API key authorization: Cookie
29
+ config.api_key['Cookie'] = 'YOUR API KEY'
30
+ # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
31
+ # config.api_key_prefix['Cookie'] = 'Bearer'
32
+
33
+ # Configure API key authorization: ApiKey
34
+ config.api_key['ApiKey'] = 'YOUR API KEY'
35
+ # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
36
+ # config.api_key_prefix['ApiKey'] = 'Bearer'
37
+ end
38
+
39
+ api_instance = TrieveRubyClient::TopicApi.new
40
+ tr_dataset = 'tr_dataset_example' # String | The dataset id to use for the request
41
+ create_topic_data = TrieveRubyClient::CreateTopicData.new # CreateTopicData | JSON request payload to create chat topic
42
+
43
+ begin
44
+ # create_topic
45
+ result = api_instance.create_topic(tr_dataset, create_topic_data)
46
+ p result
47
+ rescue TrieveRubyClient::ApiError => e
48
+ puts "Error when calling TopicApi->create_topic: #{e}"
49
+ end
50
+ ```
51
+
52
+ #### Using the create_topic_with_http_info variant
53
+
54
+ This returns an Array which contains the response data, status code and headers.
55
+
56
+ > <Array(<Topic>, Integer, Hash)> create_topic_with_http_info(tr_dataset, create_topic_data)
57
+
58
+ ```ruby
59
+ begin
60
+ # create_topic
61
+ data, status_code, headers = api_instance.create_topic_with_http_info(tr_dataset, create_topic_data)
62
+ p status_code # => 2xx
63
+ p headers # => { ... }
64
+ p data # => <Topic>
65
+ rescue TrieveRubyClient::ApiError => e
66
+ puts "Error when calling TopicApi->create_topic_with_http_info: #{e}"
67
+ end
68
+ ```
69
+
70
+ ### Parameters
71
+
72
+ | Name | Type | Description | Notes |
73
+ | ---- | ---- | ----------- | ----- |
74
+ | **tr_dataset** | **String** | The dataset id to use for the request | |
75
+ | **create_topic_data** | [**CreateTopicData**](CreateTopicData.md) | JSON request payload to create chat topic | |
76
+
77
+ ### Return type
78
+
79
+ [**Topic**](Topic.md)
80
+
81
+ ### Authorization
82
+
83
+ [Cookie](../README.md#Cookie), [ApiKey](../README.md#ApiKey)
84
+
85
+ ### HTTP request headers
86
+
87
+ - **Content-Type**: application/json
88
+ - **Accept**: application/json
89
+
90
+
91
+ ## delete_topic
92
+
93
+ > delete_topic(tr_dataset, delete_topic_data)
94
+
95
+ delete_topic
96
+
97
+ delete_topic Delete an existing chat topic. When a topic is deleted, all associated chat messages are also deleted.
98
+
99
+ ### Examples
100
+
101
+ ```ruby
102
+ require 'time'
103
+ require 'trieve_ruby_client'
104
+ # setup authorization
105
+ TrieveRubyClient.configure do |config|
106
+ # Configure API key authorization: Cookie
107
+ config.api_key['Cookie'] = 'YOUR API KEY'
108
+ # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
109
+ # config.api_key_prefix['Cookie'] = 'Bearer'
110
+
111
+ # Configure API key authorization: ApiKey
112
+ config.api_key['ApiKey'] = 'YOUR API KEY'
113
+ # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
114
+ # config.api_key_prefix['ApiKey'] = 'Bearer'
115
+ end
116
+
117
+ api_instance = TrieveRubyClient::TopicApi.new
118
+ tr_dataset = 'tr_dataset_example' # String | The dataset id to use for the request
119
+ delete_topic_data = TrieveRubyClient::DeleteTopicData.new({topic_id: 'topic_id_example'}) # DeleteTopicData | JSON request payload to delete a chat topic
120
+
121
+ begin
122
+ # delete_topic
123
+ api_instance.delete_topic(tr_dataset, delete_topic_data)
124
+ rescue TrieveRubyClient::ApiError => e
125
+ puts "Error when calling TopicApi->delete_topic: #{e}"
126
+ end
127
+ ```
128
+
129
+ #### Using the delete_topic_with_http_info variant
130
+
131
+ This returns an Array which contains the response data (`nil` in this case), status code and headers.
132
+
133
+ > <Array(nil, Integer, Hash)> delete_topic_with_http_info(tr_dataset, delete_topic_data)
134
+
135
+ ```ruby
136
+ begin
137
+ # delete_topic
138
+ data, status_code, headers = api_instance.delete_topic_with_http_info(tr_dataset, delete_topic_data)
139
+ p status_code # => 2xx
140
+ p headers # => { ... }
141
+ p data # => nil
142
+ rescue TrieveRubyClient::ApiError => e
143
+ puts "Error when calling TopicApi->delete_topic_with_http_info: #{e}"
144
+ end
145
+ ```
146
+
147
+ ### Parameters
148
+
149
+ | Name | Type | Description | Notes |
150
+ | ---- | ---- | ----------- | ----- |
151
+ | **tr_dataset** | **String** | The dataset id to use for the request | |
152
+ | **delete_topic_data** | [**DeleteTopicData**](DeleteTopicData.md) | JSON request payload to delete a chat topic | |
153
+
154
+ ### Return type
155
+
156
+ nil (empty response body)
157
+
158
+ ### Authorization
159
+
160
+ [Cookie](../README.md#Cookie), [ApiKey](../README.md#ApiKey)
161
+
162
+ ### HTTP request headers
163
+
164
+ - **Content-Type**: application/json
165
+ - **Accept**: application/json
166
+
167
+
168
+ ## get_all_topics_for_user
169
+
170
+ > <Array<Topic>> get_all_topics_for_user(user_id, tr_dataset)
171
+
172
+ get_all_topics_for_user
173
+
174
+ get_all_topics_for_user Get all topics belonging to a the auth'ed user. Soon, we plan to allow specification of the user for this route and include pagination.
175
+
176
+ ### Examples
177
+
178
+ ```ruby
179
+ require 'time'
180
+ require 'trieve_ruby_client'
181
+ # setup authorization
182
+ TrieveRubyClient.configure do |config|
183
+ # Configure API key authorization: Cookie
184
+ config.api_key['Cookie'] = 'YOUR API KEY'
185
+ # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
186
+ # config.api_key_prefix['Cookie'] = 'Bearer'
187
+
188
+ # Configure API key authorization: ApiKey
189
+ config.api_key['ApiKey'] = 'YOUR API KEY'
190
+ # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
191
+ # config.api_key_prefix['ApiKey'] = 'Bearer'
192
+ end
193
+
194
+ api_instance = TrieveRubyClient::TopicApi.new
195
+ user_id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String | The id of the user to get topics for
196
+ tr_dataset = 'tr_dataset_example' # String | The dataset id to use for the request
197
+
198
+ begin
199
+ # get_all_topics_for_user
200
+ result = api_instance.get_all_topics_for_user(user_id, tr_dataset)
201
+ p result
202
+ rescue TrieveRubyClient::ApiError => e
203
+ puts "Error when calling TopicApi->get_all_topics_for_user: #{e}"
204
+ end
205
+ ```
206
+
207
+ #### Using the get_all_topics_for_user_with_http_info variant
208
+
209
+ This returns an Array which contains the response data, status code and headers.
210
+
211
+ > <Array(<Array<Topic>>, Integer, Hash)> get_all_topics_for_user_with_http_info(user_id, tr_dataset)
212
+
213
+ ```ruby
214
+ begin
215
+ # get_all_topics_for_user
216
+ data, status_code, headers = api_instance.get_all_topics_for_user_with_http_info(user_id, tr_dataset)
217
+ p status_code # => 2xx
218
+ p headers # => { ... }
219
+ p data # => <Array<Topic>>
220
+ rescue TrieveRubyClient::ApiError => e
221
+ puts "Error when calling TopicApi->get_all_topics_for_user_with_http_info: #{e}"
222
+ end
223
+ ```
224
+
225
+ ### Parameters
226
+
227
+ | Name | Type | Description | Notes |
228
+ | ---- | ---- | ----------- | ----- |
229
+ | **user_id** | **String** | The id of the user to get topics for | |
230
+ | **tr_dataset** | **String** | The dataset id to use for the request | |
231
+
232
+ ### Return type
233
+
234
+ [**Array&lt;Topic&gt;**](Topic.md)
235
+
236
+ ### Authorization
237
+
238
+ [Cookie](../README.md#Cookie), [ApiKey](../README.md#ApiKey)
239
+
240
+ ### HTTP request headers
241
+
242
+ - **Content-Type**: Not defined
243
+ - **Accept**: application/json
244
+
245
+
246
+ ## update_topic
247
+
248
+ > update_topic(tr_dataset, update_topic_data)
249
+
250
+ update_topic
251
+
252
+ update_topic Update an existing chat topic. Currently, only the name of the topic can be updated.
253
+
254
+ ### Examples
255
+
256
+ ```ruby
257
+ require 'time'
258
+ require 'trieve_ruby_client'
259
+ # setup authorization
260
+ TrieveRubyClient.configure do |config|
261
+ # Configure API key authorization: Cookie
262
+ config.api_key['Cookie'] = 'YOUR API KEY'
263
+ # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
264
+ # config.api_key_prefix['Cookie'] = 'Bearer'
265
+
266
+ # Configure API key authorization: ApiKey
267
+ config.api_key['ApiKey'] = 'YOUR API KEY'
268
+ # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
269
+ # config.api_key_prefix['ApiKey'] = 'Bearer'
270
+ end
271
+
272
+ api_instance = TrieveRubyClient::TopicApi.new
273
+ tr_dataset = 'tr_dataset_example' # String | The dataset id to use for the request
274
+ update_topic_data = TrieveRubyClient::UpdateTopicData.new({name: 'name_example', topic_id: 'topic_id_example'}) # UpdateTopicData | JSON request payload to update a chat topic
275
+
276
+ begin
277
+ # update_topic
278
+ api_instance.update_topic(tr_dataset, update_topic_data)
279
+ rescue TrieveRubyClient::ApiError => e
280
+ puts "Error when calling TopicApi->update_topic: #{e}"
281
+ end
282
+ ```
283
+
284
+ #### Using the update_topic_with_http_info variant
285
+
286
+ This returns an Array which contains the response data (`nil` in this case), status code and headers.
287
+
288
+ > <Array(nil, Integer, Hash)> update_topic_with_http_info(tr_dataset, update_topic_data)
289
+
290
+ ```ruby
291
+ begin
292
+ # update_topic
293
+ data, status_code, headers = api_instance.update_topic_with_http_info(tr_dataset, update_topic_data)
294
+ p status_code # => 2xx
295
+ p headers # => { ... }
296
+ p data # => nil
297
+ rescue TrieveRubyClient::ApiError => e
298
+ puts "Error when calling TopicApi->update_topic_with_http_info: #{e}"
299
+ end
300
+ ```
301
+
302
+ ### Parameters
303
+
304
+ | Name | Type | Description | Notes |
305
+ | ---- | ---- | ----------- | ----- |
306
+ | **tr_dataset** | **String** | The dataset id to use for the request | |
307
+ | **update_topic_data** | [**UpdateTopicData**](UpdateTopicData.md) | JSON request payload to update a chat topic | |
308
+
309
+ ### Return type
310
+
311
+ nil (empty response body)
312
+
313
+ ### Authorization
314
+
315
+ [Cookie](../README.md#Cookie), [ApiKey](../README.md#ApiKey)
316
+
317
+ ### HTTP request headers
318
+
319
+ - **Content-Type**: application/json
320
+ - **Accept**: application/json
321
+
@@ -0,0 +1,32 @@
1
+ # TrieveRubyClient::UpdateChunkByTrackingIdData
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **chunk_html** | **String** | HTML content of the chunk you want to update. This can also be plaintext. The innerText of the HTML will be used to create the embedding vector. The point of using HTML is for convienience, as some users have applications where users submit HTML content. If no chunk_html is provided, the existing chunk_html will be used. | [optional] |
8
+ | **group_ids** | **Array&lt;String&gt;** | Group ids are the ids of the groups that the chunk should be placed into. This is useful for when you want to update a chunk and add it to a group or multiple groups in one request. | [optional] |
9
+ | **group_tracking_ids** | **Array&lt;String&gt;** | Group tracking_ids are the tracking_ids of the groups that the chunk should be placed into. This is useful for when you want to update a chunk and add it to a group or multiple groups in one request. | [optional] |
10
+ | **link** | **String** | Link of the chunk you want to update. This can also be any string. Frequently, this is a link to the source of the chunk. The link value will not affect the embedding creation. If no link is provided, the existing link will be used. | [optional] |
11
+ | **metadata** | **Object** | The metadata is a JSON object which can be used to filter chunks. This is useful for when you want to filter chunks by arbitrary metadata. Unlike with tag filtering, there is a performance hit for filtering on metadata. If no metadata is provided, the existing metadata will be used. | [optional] |
12
+ | **time_stamp** | **String** | Time_stamp should be an ISO 8601 combined date and time without timezone. It is used for time window filtering and recency-biasing search results. If no time_stamp is provided, the existing time_stamp will be used. | [optional] |
13
+ | **tracking_id** | **String** | Tracking_id of the chunk you want to update. This is required to match an existing chunk. | |
14
+ | **weight** | **Float** | Weight is a float which can be used to bias search results. This is useful for when you want to bias search results for a chunk. The magnitude only matters relative to other chunks in the chunk&#39;s dataset dataset. If no weight is provided, the existing weight will be used. | [optional] |
15
+
16
+ ## Example
17
+
18
+ ```ruby
19
+ require 'trieve_ruby_client'
20
+
21
+ instance = TrieveRubyClient::UpdateChunkByTrackingIdData.new(
22
+ chunk_html: null,
23
+ group_ids: null,
24
+ group_tracking_ids: null,
25
+ link: null,
26
+ metadata: null,
27
+ time_stamp: null,
28
+ tracking_id: null,
29
+ weight: null
30
+ )
31
+ ```
32
+
@@ -0,0 +1,34 @@
1
+ # TrieveRubyClient::UpdateChunkData
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **chunk_html** | **String** | HTML content of the chunk you want to update. This can also be plaintext. The innerText of the HTML will be used to create the embedding vector. The point of using HTML is for convienience, as some users have applications where users submit HTML content. If no chunk_html is provided, the existing chunk_html will be used. | [optional] |
8
+ | **chunk_id** | **String** | Id of the chunk you want to update. You can provide either the chunk_id or the tracking_id. If both are provided, the chunk_id will be used. | [optional] |
9
+ | **group_ids** | **Array&lt;String&gt;** | Group ids are the ids of the groups that the chunk should be placed into. This is useful for when you want to update a chunk and add it to a group or multiple groups in one request. | [optional] |
10
+ | **group_tracking_ids** | **Array&lt;String&gt;** | Group tracking_ids are the tracking_ids of the groups that the chunk should be placed into. This is useful for when you want to update a chunk and add it to a group or multiple groups in one request. | [optional] |
11
+ | **link** | **String** | Link of the chunk you want to update. This can also be any string. Frequently, this is a link to the source of the chunk. The link value will not affect the embedding creation. If no link is provided, the existing link will be used. | [optional] |
12
+ | **metadata** | **Object** | The metadata is a JSON object which can be used to filter chunks. This is useful for when you want to filter chunks by arbitrary metadata. Unlike with tag filtering, there is a performance hit for filtering on metadata. If no metadata is provided, the existing metadata will be used. | [optional] |
13
+ | **time_stamp** | **String** | Time_stamp should be an ISO 8601 combined date and time without timezone. It is used for time window filtering and recency-biasing search results. If no time_stamp is provided, the existing time_stamp will be used. | [optional] |
14
+ | **tracking_id** | **String** | Tracking_id of the chunk you want to update. This is required to match an existing chunk. | [optional] |
15
+ | **weight** | **Float** | Weight is a float which can be used to bias search results. This is useful for when you want to bias search results for a chunk. The magnitude only matters relative to other chunks in the chunk&#39;s dataset dataset. If no weight is provided, the existing weight will be used. | [optional] |
16
+
17
+ ## Example
18
+
19
+ ```ruby
20
+ require 'trieve_ruby_client'
21
+
22
+ instance = TrieveRubyClient::UpdateChunkData.new(
23
+ chunk_html: null,
24
+ chunk_id: null,
25
+ group_ids: null,
26
+ group_tracking_ids: null,
27
+ link: null,
28
+ metadata: null,
29
+ time_stamp: null,
30
+ tracking_id: null,
31
+ weight: null
32
+ )
33
+ ```
34
+
@@ -0,0 +1,24 @@
1
+ # TrieveRubyClient::UpdateChunkGroupData
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **description** | **String** | Description to assign to the chunk_group. Convenience field for you to avoid having to remember what the group is for. If not provided, the description will not be updated. | [optional] |
8
+ | **group_id** | **String** | Id of the chunk_group to update. | [optional] |
9
+ | **name** | **String** | Name to assign to the chunk_group. Does not need to be unique. If not provided, the name will not be updated. | [optional] |
10
+ | **tracking_id** | **String** | Tracking Id of the chunk_group to update. | [optional] |
11
+
12
+ ## Example
13
+
14
+ ```ruby
15
+ require 'trieve_ruby_client'
16
+
17
+ instance = TrieveRubyClient::UpdateChunkGroupData.new(
18
+ description: null,
19
+ group_id: null,
20
+ name: null,
21
+ tracking_id: null
22
+ )
23
+ ```
24
+
@@ -0,0 +1,24 @@
1
+ # TrieveRubyClient::UpdateDatasetRequest
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **client_configuration** | **Object** | The new client configuration of the dataset, can be arbitrary JSON. See docs.trieve.ai for more information. If not provided, the client configuration will not be updated. | [optional] |
8
+ | **dataset_id** | **String** | The id of the dataset you want to update. | |
9
+ | **dataset_name** | **String** | The new name of the dataset. Must be unique within the organization. If not provided, the name will not be updated. | [optional] |
10
+ | **server_configuration** | **Object** | The new server configuration of the dataset, can be arbitrary JSON. See docs.trieve.ai for more information. If not provided, the server configuration will not be updated. | [optional] |
11
+
12
+ ## Example
13
+
14
+ ```ruby
15
+ require 'trieve_ruby_client'
16
+
17
+ instance = TrieveRubyClient::UpdateDatasetRequest.new(
18
+ client_configuration: null,
19
+ dataset_id: null,
20
+ dataset_name: null,
21
+ server_configuration: null
22
+ )
23
+ ```
24
+
@@ -0,0 +1,22 @@
1
+ # TrieveRubyClient::UpdateGroupByTrackingIDData
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **description** | **String** | Description to assign to the chunk_group. Convenience field for you to avoid having to remember what the group is for. If not provided, the description will not be updated. | [optional] |
8
+ | **name** | **String** | Name to assign to the chunk_group. Does not need to be unique. If not provided, the name will not be updated. | [optional] |
9
+ | **tracking_id** | **String** | Tracking Id of the chunk_group to update. | |
10
+
11
+ ## Example
12
+
13
+ ```ruby
14
+ require 'trieve_ruby_client'
15
+
16
+ instance = TrieveRubyClient::UpdateGroupByTrackingIDData.new(
17
+ description: null,
18
+ name: null,
19
+ tracking_id: null
20
+ )
21
+ ```
22
+
@@ -0,0 +1,20 @@
1
+ # TrieveRubyClient::UpdateOrganizationData
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **name** | **String** | The new name of the organization. If not provided, the name will not be updated. | [optional] |
8
+ | **organization_id** | **String** | The id of the organization to update. | |
9
+
10
+ ## Example
11
+
12
+ ```ruby
13
+ require 'trieve_ruby_client'
14
+
15
+ instance = TrieveRubyClient::UpdateOrganizationData.new(
16
+ name: null,
17
+ organization_id: null
18
+ )
19
+ ```
20
+
@@ -0,0 +1,20 @@
1
+ # TrieveRubyClient::UpdateTopicData
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **name** | **String** | The new name of the topic. A name is not generated from this field, it is used as-is. | |
8
+ | **topic_id** | **String** | The id of the topic to target. | |
9
+
10
+ ## Example
11
+
12
+ ```ruby
13
+ require 'trieve_ruby_client'
14
+
15
+ instance = TrieveRubyClient::UpdateTopicData.new(
16
+ name: null,
17
+ topic_id: null
18
+ )
19
+ ```
20
+
@@ -0,0 +1,30 @@
1
+ # TrieveRubyClient::UpdateUserData
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **name** | **String** | In the sense of a legal name, not a username. The new name to assign to the user, if not provided, the current name will be used. | [optional] |
8
+ | **organization_id** | **String** | The id of the organization to update the user for. | |
9
+ | **role** | **Integer** | Either 0 (user), 1 (admin), or 2 (owner). If not provided, the current role will be used. The auth&#39;ed user must have a role greater than or equal to the role being assigned. | [optional] |
10
+ | **user_id** | **String** | The id of the user to update, if not provided, the auth&#39;ed user will be updated. If provided, the auth&#39;ed user must be an admin (1) or owner (2) of the organization. | [optional] |
11
+ | **username** | **String** | The new username to assign to the user, if not provided, the current username will be used. | [optional] |
12
+ | **visible_email** | **Boolean** | Determines if the user&#39;s email is visible to other users, if not provided, the current value will be used. | [optional] |
13
+ | **website** | **String** | The new website to assign to the user, if not provided, the current website will be used. Used for linking to the user&#39;s personal or company website. | [optional] |
14
+
15
+ ## Example
16
+
17
+ ```ruby
18
+ require 'trieve_ruby_client'
19
+
20
+ instance = TrieveRubyClient::UpdateUserData.new(
21
+ name: null,
22
+ organization_id: null,
23
+ role: null,
24
+ user_id: null,
25
+ username: null,
26
+ visible_email: null,
27
+ website: null
28
+ )
29
+ ```
30
+
@@ -0,0 +1,34 @@
1
+ # TrieveRubyClient::UploadFileData
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **base64_file** | **String** | Base64 encoded file. Convert + to -, / to _, and remove the ending &#x3D; if present. This is the standard base64url encoding. | |
8
+ | **create_chunks** | **Boolean** | Create chunks is a boolean which determines whether or not to create chunks from the file. If false, you can manually chunk the file and send the chunks to the create_chunk endpoint with the file_id to associate chunks with the file. Meant mostly for advanced users. | [optional] |
9
+ | **description** | **String** | Description is an optional convience field so you do not have to remember what the file contains or is about. It will be included on the group resulting from the file which will hold its chunk. | [optional] |
10
+ | **file_mime_type** | **String** | MIME type of the file being uploaded. | |
11
+ | **file_name** | **String** | Name of the file being uploaded, including the extension. | |
12
+ | **link** | **String** | Link to the file. This can also be any string. This can be used to filter when searching for the file&#39;s resulting chunks. The link value will not affect embedding creation. | [optional] |
13
+ | **metadata** | **Object** | Metadata is a JSON object which can be used to filter chunks. This is useful for when you want to filter chunks by arbitrary metadata. Unlike with tag filtering, there is a performance hit for filtering on metadata. Will be passed down to the file&#39;s chunks. | [optional] |
14
+ | **tag_set** | **Array&lt;String&gt;** | Tag set is a comma separated list of tags which will be passed down to the chunks made from the file. Tags are used to filter chunks when searching. HNSW indices are created for each tag such that there is no performance loss when filtering on them. | [optional] |
15
+ | **time_stamp** | **String** | Time stamp should be an ISO 8601 combined date and time without timezone. Time_stamp is used for time window filtering and recency-biasing search results. Will be passed down to the file&#39;s chunks. | [optional] |
16
+
17
+ ## Example
18
+
19
+ ```ruby
20
+ require 'trieve_ruby_client'
21
+
22
+ instance = TrieveRubyClient::UploadFileData.new(
23
+ base64_file: null,
24
+ create_chunks: null,
25
+ description: null,
26
+ file_mime_type: null,
27
+ file_name: null,
28
+ link: null,
29
+ metadata: null,
30
+ tag_set: null,
31
+ time_stamp: null
32
+ )
33
+ ```
34
+
@@ -0,0 +1,18 @@
1
+ # TrieveRubyClient::UploadFileResult
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **file_metadata** | **File** | | |
8
+
9
+ ## Example
10
+
11
+ ```ruby
12
+ require 'trieve_ruby_client'
13
+
14
+ instance = TrieveRubyClient::UploadFileResult.new(
15
+ file_metadata: null
16
+ )
17
+ ```
18
+