dub 0.29.1 → 0.29.2

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 (317) hide show
  1. package/README.md +23 -10
  2. package/docs/sdks/analytics/README.md +59 -93
  3. package/docs/sdks/clicks/README.md +579 -0
  4. package/docs/sdks/links/README.md +2 -2
  5. package/lib/config.d.ts +3 -3
  6. package/lib/config.js +3 -3
  7. package/models/components/domainschema.d.ts +14 -16
  8. package/models/components/domainschema.d.ts.map +1 -1
  9. package/models/components/domainschema.js +7 -3
  10. package/models/components/domainschema.js.map +1 -1
  11. package/models/components/linkschema.d.ts +7 -291
  12. package/models/components/linkschema.d.ts.map +1 -1
  13. package/models/components/linkschema.js +4 -0
  14. package/models/components/linkschema.js.map +1 -1
  15. package/models/components/security.d.ts +1 -4
  16. package/models/components/security.d.ts.map +1 -1
  17. package/models/components/security.js.map +1 -1
  18. package/models/components/tagschema.d.ts +24 -9
  19. package/models/components/tagschema.d.ts.map +1 -1
  20. package/models/components/tagschema.js +7 -3
  21. package/models/components/tagschema.js.map +1 -1
  22. package/models/components/workspaceschema.d.ts +38 -36
  23. package/models/components/workspaceschema.d.ts.map +1 -1
  24. package/models/components/workspaceschema.js +14 -6
  25. package/models/components/workspaceschema.js.map +1 -1
  26. package/models/errors/badrequest.d.ts +13 -13
  27. package/models/errors/badrequest.d.ts.map +1 -1
  28. package/models/errors/badrequest.js +7 -3
  29. package/models/errors/badrequest.js.map +1 -1
  30. package/models/errors/conflict.d.ts +13 -13
  31. package/models/errors/conflict.d.ts.map +1 -1
  32. package/models/errors/conflict.js +7 -3
  33. package/models/errors/conflict.js.map +1 -1
  34. package/models/errors/forbidden.d.ts +13 -13
  35. package/models/errors/forbidden.d.ts.map +1 -1
  36. package/models/errors/forbidden.js +7 -3
  37. package/models/errors/forbidden.js.map +1 -1
  38. package/models/errors/internalservererror.d.ts +13 -13
  39. package/models/errors/internalservererror.d.ts.map +1 -1
  40. package/models/errors/internalservererror.js +7 -3
  41. package/models/errors/internalservererror.js.map +1 -1
  42. package/models/errors/inviteexpired.d.ts +13 -13
  43. package/models/errors/inviteexpired.d.ts.map +1 -1
  44. package/models/errors/inviteexpired.js +7 -3
  45. package/models/errors/inviteexpired.js.map +1 -1
  46. package/models/errors/notfound.d.ts +13 -13
  47. package/models/errors/notfound.d.ts.map +1 -1
  48. package/models/errors/notfound.js +7 -3
  49. package/models/errors/notfound.js.map +1 -1
  50. package/models/errors/ratelimitexceeded.d.ts +13 -13
  51. package/models/errors/ratelimitexceeded.d.ts.map +1 -1
  52. package/models/errors/ratelimitexceeded.js +7 -3
  53. package/models/errors/ratelimitexceeded.js.map +1 -1
  54. package/models/errors/unauthorized.d.ts +13 -13
  55. package/models/errors/unauthorized.d.ts.map +1 -1
  56. package/models/errors/unauthorized.js +7 -3
  57. package/models/errors/unauthorized.js.map +1 -1
  58. package/models/errors/unprocessableentity.d.ts +13 -13
  59. package/models/errors/unprocessableentity.d.ts.map +1 -1
  60. package/models/errors/unprocessableentity.js +7 -3
  61. package/models/errors/unprocessableentity.js.map +1 -1
  62. package/models/operations/adddomain.d.ts +14 -12
  63. package/models/operations/adddomain.d.ts.map +1 -1
  64. package/models/operations/adddomain.js +7 -3
  65. package/models/operations/adddomain.js.map +1 -1
  66. package/models/operations/bulkcreatelinks.d.ts +4 -282
  67. package/models/operations/bulkcreatelinks.d.ts.map +1 -1
  68. package/models/operations/bulkcreatelinks.js.map +1 -1
  69. package/models/operations/createlink.d.ts +4 -282
  70. package/models/operations/createlink.d.ts.map +1 -1
  71. package/models/operations/createlink.js.map +1 -1
  72. package/models/operations/createtag.d.ts +24 -8
  73. package/models/operations/createtag.d.ts.map +1 -1
  74. package/models/operations/createtag.js +7 -3
  75. package/models/operations/createtag.js.map +1 -1
  76. package/models/operations/createworkspace.d.ts +1 -6
  77. package/models/operations/createworkspace.d.ts.map +1 -1
  78. package/models/operations/createworkspace.js.map +1 -1
  79. package/models/operations/deletedomain.d.ts +2 -8
  80. package/models/operations/deletedomain.d.ts.map +1 -1
  81. package/models/operations/deletedomain.js.map +1 -1
  82. package/models/operations/deletelink.d.ts +2 -8
  83. package/models/operations/deletelink.d.ts.map +1 -1
  84. package/models/operations/deletelink.js.map +1 -1
  85. package/models/operations/getbrowsersbyclicks.d.ts +922 -0
  86. package/models/operations/getbrowsersbyclicks.d.ts.map +1 -0
  87. package/models/operations/getbrowsersbyclicks.js +423 -0
  88. package/models/operations/getbrowsersbyclicks.js.map +1 -0
  89. package/models/operations/getbrowsersbyclicksdeprecated.d.ts +922 -0
  90. package/models/operations/getbrowsersbyclicksdeprecated.d.ts.map +1 -0
  91. package/models/operations/getbrowsersbyclicksdeprecated.js +423 -0
  92. package/models/operations/getbrowsersbyclicksdeprecated.js.map +1 -0
  93. package/models/operations/getcitiesbyclicks.d.ts +1693 -0
  94. package/models/operations/getcitiesbyclicks.d.ts.map +1 -0
  95. package/models/operations/{getcityanalytics.js → getcitiesbyclicks.js} +39 -27
  96. package/models/operations/getcitiesbyclicks.js.map +1 -0
  97. package/models/operations/getcitiesbyclicksdeprecated.d.ts +1693 -0
  98. package/models/operations/getcitiesbyclicksdeprecated.d.ts.map +1 -0
  99. package/models/operations/getcitiesbyclicksdeprecated.js +688 -0
  100. package/models/operations/{getcountryanalytics.js.map → getcitiesbyclicksdeprecated.js.map} +1 -1
  101. package/models/operations/getclickscount.d.ts +903 -0
  102. package/models/operations/getclickscount.d.ts.map +1 -0
  103. package/models/operations/{getclicksanalytics.js → getclickscount.js} +24 -16
  104. package/models/operations/getclickscount.js.map +1 -0
  105. package/models/operations/getclickscountdeprecated.d.ts +903 -0
  106. package/models/operations/getclickscountdeprecated.d.ts.map +1 -0
  107. package/models/operations/{getbrowseranalytics.js → getclickscountdeprecated.js} +26 -44
  108. package/models/operations/getclickscountdeprecated.js.map +1 -0
  109. package/models/operations/getcountriesbyclicks.d.ts +1688 -0
  110. package/models/operations/getcountriesbyclicks.d.ts.map +1 -0
  111. package/models/operations/{getcountryanalytics.js → getcountriesbyclicks.js} +39 -27
  112. package/models/operations/getcountriesbyclicks.js.map +1 -0
  113. package/models/operations/getcountriesbyclicksdeprecated.d.ts +1688 -0
  114. package/models/operations/getcountriesbyclicksdeprecated.d.ts.map +1 -0
  115. package/models/operations/getcountriesbyclicksdeprecated.js +684 -0
  116. package/models/operations/{getcityanalytics.js.map → getcountriesbyclicksdeprecated.js.map} +1 -1
  117. package/models/operations/getdevicesbyclicks.d.ts +922 -0
  118. package/models/operations/getdevicesbyclicks.d.ts.map +1 -0
  119. package/models/operations/{getdeviceanalytics.js → getdevicesbyclicks.js} +31 -23
  120. package/models/operations/getdevicesbyclicks.js.map +1 -0
  121. package/models/operations/getdevicesbyclicksdeprecated.d.ts +922 -0
  122. package/models/operations/getdevicesbyclicksdeprecated.d.ts.map +1 -0
  123. package/models/operations/getdevicesbyclicksdeprecated.js +423 -0
  124. package/models/operations/getdevicesbyclicksdeprecated.js.map +1 -0
  125. package/models/operations/getlinkinfo.d.ts +1 -7
  126. package/models/operations/getlinkinfo.d.ts.map +1 -1
  127. package/models/operations/getlinkinfo.js.map +1 -1
  128. package/models/operations/getlinks.d.ts +18 -20
  129. package/models/operations/getlinks.d.ts.map +1 -1
  130. package/models/operations/getlinks.js +7 -3
  131. package/models/operations/getlinks.js.map +1 -1
  132. package/models/operations/getlinkscount.d.ts +25 -24
  133. package/models/operations/getlinkscount.d.ts.map +1 -1
  134. package/models/operations/getlinkscount.js +20 -6
  135. package/models/operations/getlinkscount.js.map +1 -1
  136. package/models/operations/getmetatags.d.ts +2 -10
  137. package/models/operations/getmetatags.d.ts.map +1 -1
  138. package/models/operations/getmetatags.js.map +1 -1
  139. package/models/operations/getosbyclicks.d.ts +922 -0
  140. package/models/operations/getosbyclicks.d.ts.map +1 -0
  141. package/models/operations/{getosanalytics.js → getosbyclicks.js} +31 -23
  142. package/models/operations/getosbyclicks.js.map +1 -0
  143. package/models/operations/getosbyclicksdeprecated.d.ts +922 -0
  144. package/models/operations/getosbyclicksdeprecated.d.ts.map +1 -0
  145. package/models/operations/getosbyclicksdeprecated.js +423 -0
  146. package/models/operations/getosbyclicksdeprecated.js.map +1 -0
  147. package/models/operations/getqrcode.d.ts +18 -12
  148. package/models/operations/getqrcode.d.ts.map +1 -1
  149. package/models/operations/getqrcode.js +7 -3
  150. package/models/operations/getqrcode.js.map +1 -1
  151. package/models/operations/getreferersbyclicks.d.ts +922 -0
  152. package/models/operations/getreferersbyclicks.d.ts.map +1 -0
  153. package/models/operations/{getrefereranalytics.js → getreferersbyclicks.js} +31 -23
  154. package/models/operations/getreferersbyclicks.js.map +1 -0
  155. package/models/operations/getreferersbyclicksdeprecated.d.ts +922 -0
  156. package/models/operations/getreferersbyclicksdeprecated.d.ts.map +1 -0
  157. package/models/operations/getreferersbyclicksdeprecated.js +423 -0
  158. package/models/operations/getreferersbyclicksdeprecated.js.map +1 -0
  159. package/models/operations/gettags.d.ts +1 -2
  160. package/models/operations/gettags.d.ts.map +1 -1
  161. package/models/operations/gettags.js.map +1 -1
  162. package/models/operations/gettimeseriesbyclicks.d.ts +922 -0
  163. package/models/operations/gettimeseriesbyclicks.d.ts.map +1 -0
  164. package/models/operations/{gettimeseriesanalytics.js → gettimeseriesbyclicks.js} +24 -16
  165. package/models/operations/{gettoplinks.js.map → gettimeseriesbyclicks.js.map} +1 -1
  166. package/models/operations/gettimeseriesbyclicksdeprecated.d.ts +922 -0
  167. package/models/operations/gettimeseriesbyclicksdeprecated.d.ts.map +1 -0
  168. package/models/operations/gettimeseriesbyclicksdeprecated.js +423 -0
  169. package/models/operations/gettimeseriesbyclicksdeprecated.js.map +1 -0
  170. package/models/operations/gettoplinksbyclicks.d.ts +922 -0
  171. package/models/operations/gettoplinksbyclicks.d.ts.map +1 -0
  172. package/models/operations/{gettoplinks.js → gettoplinksbyclicks.js} +31 -23
  173. package/models/operations/gettoplinksbyclicks.js.map +1 -0
  174. package/models/operations/gettoplinksbyclicksdeprecated.d.ts +922 -0
  175. package/models/operations/gettoplinksbyclicksdeprecated.d.ts.map +1 -0
  176. package/models/operations/gettoplinksbyclicksdeprecated.js +423 -0
  177. package/models/operations/gettoplinksbyclicksdeprecated.js.map +1 -0
  178. package/models/operations/gettopurlsbyclicks.d.ts +922 -0
  179. package/models/operations/gettopurlsbyclicks.d.ts.map +1 -0
  180. package/models/operations/{gettopurls.js → gettopurlsbyclicks.js} +31 -23
  181. package/models/operations/{getclicksanalytics.js.map → gettopurlsbyclicks.js.map} +1 -1
  182. package/models/operations/gettopurlsbyclicksdeprecated.d.ts +922 -0
  183. package/models/operations/gettopurlsbyclicksdeprecated.d.ts.map +1 -0
  184. package/models/operations/gettopurlsbyclicksdeprecated.js +423 -0
  185. package/models/operations/gettopurlsbyclicksdeprecated.js.map +1 -0
  186. package/models/operations/getworkspace.d.ts +1 -4
  187. package/models/operations/getworkspace.d.ts.map +1 -1
  188. package/models/operations/getworkspace.js.map +1 -1
  189. package/models/operations/index.d.ts +20 -10
  190. package/models/operations/index.d.ts.map +1 -1
  191. package/models/operations/index.js +20 -10
  192. package/models/operations/index.js.map +1 -1
  193. package/models/operations/listdomains.d.ts +1 -2
  194. package/models/operations/listdomains.d.ts.map +1 -1
  195. package/models/operations/listdomains.js.map +1 -1
  196. package/models/operations/setprimarydomain.d.ts +1 -4
  197. package/models/operations/setprimarydomain.d.ts.map +1 -1
  198. package/models/operations/setprimarydomain.js.map +1 -1
  199. package/models/operations/transferdomain.d.ts +2 -9
  200. package/models/operations/transferdomain.d.ts.map +1 -1
  201. package/models/operations/transferdomain.js.map +1 -1
  202. package/models/operations/updatedomain.d.ts +15 -17
  203. package/models/operations/updatedomain.d.ts.map +1 -1
  204. package/models/operations/updatedomain.js +7 -3
  205. package/models/operations/updatedomain.js.map +1 -1
  206. package/models/operations/updatelink.d.ts +5 -287
  207. package/models/operations/updatelink.d.ts.map +1 -1
  208. package/models/operations/updatelink.js.map +1 -1
  209. package/models/operations/upsertlink.d.ts +4 -282
  210. package/models/operations/upsertlink.d.ts.map +1 -1
  211. package/models/operations/upsertlink.js.map +1 -1
  212. package/package.json +1 -1
  213. package/sdk/analytics.d.ts +39 -25
  214. package/sdk/analytics.d.ts.map +1 -1
  215. package/sdk/analytics.js +70 -248
  216. package/sdk/analytics.js.map +1 -1
  217. package/sdk/clicks.d.ts +87 -0
  218. package/sdk/clicks.d.ts.map +1 -0
  219. package/sdk/clicks.js +2355 -0
  220. package/sdk/clicks.js.map +1 -0
  221. package/sdk/links.d.ts +2 -2
  222. package/sdk/links.js +2 -2
  223. package/src/lib/config.ts +3 -3
  224. package/src/models/components/domainschema.ts +10 -19
  225. package/src/models/components/linkschema.ts +11 -293
  226. package/src/models/components/security.ts +1 -5
  227. package/src/models/components/tagschema.ts +10 -12
  228. package/src/models/components/workspaceschema.ts +20 -43
  229. package/src/models/errors/badrequest.ts +11 -17
  230. package/src/models/errors/conflict.ts +11 -17
  231. package/src/models/errors/forbidden.ts +11 -17
  232. package/src/models/errors/internalservererror.ts +11 -19
  233. package/src/models/errors/inviteexpired.ts +11 -18
  234. package/src/models/errors/notfound.ts +11 -17
  235. package/src/models/errors/ratelimitexceeded.ts +11 -19
  236. package/src/models/errors/unauthorized.ts +11 -18
  237. package/src/models/errors/unprocessableentity.ts +11 -19
  238. package/src/models/operations/adddomain.ts +10 -15
  239. package/src/models/operations/bulkcreatelinks.ts +8 -288
  240. package/src/models/operations/createlink.ts +8 -288
  241. package/src/models/operations/createtag.ts +10 -11
  242. package/src/models/operations/createworkspace.ts +1 -7
  243. package/src/models/operations/deletedomain.ts +2 -10
  244. package/src/models/operations/deletelink.ts +2 -10
  245. package/src/models/operations/{getbrowseranalytics.ts → getbrowsersbyclicks.ts} +39 -59
  246. package/src/models/operations/getbrowsersbyclicksdeprecated.ts +538 -0
  247. package/src/models/operations/getcitiesbyclicks.ts +797 -0
  248. package/src/models/operations/{getcityanalytics.ts → getcitiesbyclicksdeprecated.ts} +67 -69
  249. package/src/models/operations/{getclicksanalytics.ts → getclickscount.ts} +27 -40
  250. package/src/models/operations/getclickscountdeprecated.ts +483 -0
  251. package/src/models/operations/{getcountryanalytics.ts → getcountriesbyclicks.ts} +49 -68
  252. package/src/models/operations/getcountriesbyclicksdeprecated.ts +807 -0
  253. package/src/models/operations/{getdeviceanalytics.ts → getdevicesbyclicks.ts} +39 -59
  254. package/src/models/operations/getdevicesbyclicksdeprecated.ts +537 -0
  255. package/src/models/operations/getlinkinfo.ts +1 -8
  256. package/src/models/operations/getlinks.ts +16 -27
  257. package/src/models/operations/getlinkscount.ts +29 -31
  258. package/src/models/operations/getmetatags.ts +2 -12
  259. package/src/models/operations/{getosanalytics.ts → getosbyclicks.ts} +35 -59
  260. package/src/models/operations/{gettimeseriesanalytics.ts → getosbyclicksdeprecated.ts} +55 -63
  261. package/src/models/operations/getqrcode.ts +10 -15
  262. package/src/models/operations/{getrefereranalytics.ts → getreferersbyclicks.ts} +39 -59
  263. package/src/models/operations/getreferersbyclicksdeprecated.ts +538 -0
  264. package/src/models/operations/gettags.ts +1 -3
  265. package/src/models/operations/gettimeseriesbyclicks.ts +517 -0
  266. package/src/models/operations/gettimeseriesbyclicksdeprecated.ts +539 -0
  267. package/src/models/operations/gettoplinksbyclicks.ts +526 -0
  268. package/src/models/operations/{gettoplinks.ts → gettoplinksbyclicksdeprecated.ts} +56 -57
  269. package/src/models/operations/gettopurlsbyclicks.ts +522 -0
  270. package/src/models/operations/{gettopurls.ts → gettopurlsbyclicksdeprecated.ts} +55 -57
  271. package/src/models/operations/getworkspace.ts +1 -5
  272. package/src/models/operations/index.ts +20 -10
  273. package/src/models/operations/listdomains.ts +1 -3
  274. package/src/models/operations/setprimarydomain.ts +1 -5
  275. package/src/models/operations/transferdomain.ts +2 -11
  276. package/src/models/operations/updatedomain.ts +11 -22
  277. package/src/models/operations/updatelink.ts +9 -294
  278. package/src/models/operations/upsertlink.ts +8 -288
  279. package/src/sdk/analytics.ts +97 -317
  280. package/src/sdk/clicks.ts +2906 -0
  281. package/src/sdk/links.ts +2 -2
  282. package/src/types/enums.ts +16 -0
  283. package/src/types/index.ts +2 -0
  284. package/types/enums.d.ts +12 -0
  285. package/types/enums.d.ts.map +1 -0
  286. package/types/enums.js +11 -0
  287. package/types/enums.js.map +1 -0
  288. package/types/index.d.ts +2 -0
  289. package/types/index.d.ts.map +1 -1
  290. package/types/index.js +3 -1
  291. package/types/index.js.map +1 -1
  292. package/models/operations/getbrowseranalytics.d.ts +0 -418
  293. package/models/operations/getbrowseranalytics.d.ts.map +0 -1
  294. package/models/operations/getbrowseranalytics.js.map +0 -1
  295. package/models/operations/getcityanalytics.d.ts +0 -685
  296. package/models/operations/getcityanalytics.d.ts.map +0 -1
  297. package/models/operations/getclicksanalytics.d.ts +0 -395
  298. package/models/operations/getclicksanalytics.d.ts.map +0 -1
  299. package/models/operations/getcountryanalytics.d.ts +0 -679
  300. package/models/operations/getcountryanalytics.d.ts.map +0 -1
  301. package/models/operations/getdeviceanalytics.d.ts +0 -418
  302. package/models/operations/getdeviceanalytics.d.ts.map +0 -1
  303. package/models/operations/getdeviceanalytics.js.map +0 -1
  304. package/models/operations/getosanalytics.d.ts +0 -418
  305. package/models/operations/getosanalytics.d.ts.map +0 -1
  306. package/models/operations/getosanalytics.js.map +0 -1
  307. package/models/operations/getrefereranalytics.d.ts +0 -418
  308. package/models/operations/getrefereranalytics.d.ts.map +0 -1
  309. package/models/operations/getrefereranalytics.js.map +0 -1
  310. package/models/operations/gettimeseriesanalytics.d.ts +0 -418
  311. package/models/operations/gettimeseriesanalytics.d.ts.map +0 -1
  312. package/models/operations/gettimeseriesanalytics.js.map +0 -1
  313. package/models/operations/gettoplinks.d.ts +0 -418
  314. package/models/operations/gettoplinks.d.ts.map +0 -1
  315. package/models/operations/gettopurls.d.ts +0 -418
  316. package/models/operations/gettopurls.d.ts.map +0 -1
  317. package/models/operations/gettopurls.js.map +0 -1
@@ -0,0 +1,579 @@
1
+ # Clicks
2
+ (*analytics.clicks*)
3
+
4
+ ### Available Operations
5
+
6
+ * [count](#count) - Retrieve the total clicks count
7
+ * [timeseries](#timeseries) - Retrieve timeseries click analytics
8
+ * [countries](#countries) - Retrieve top countries by clicks
9
+ * [cities](#cities) - Retrieve top cities by clicks
10
+ * [devices](#devices) - Retrieve top devices by clicks
11
+ * [browsers](#browsers) - Retrieve top browsers by clicks
12
+ * [os](#os) - Retrieve top OS by clicks
13
+ * [referers](#referers) - Retrieve top referers by clicks
14
+ * [topLinks](#toplinks) - Retrieve top links by clicks
15
+ * [topUrls](#topurls) - Retrieve top URLs by clicks
16
+ * [~~getClicksCountDeprecated~~](#getclickscountdeprecated) - Retrieve the total clicks count :warning: **Deprecated** Use `count` instead.
17
+
18
+ ## count
19
+
20
+ Retrieve the total number of clicks for a link, a domain, or the authenticated workspace.
21
+
22
+ ### Example Usage
23
+
24
+ ```typescript
25
+ import { Dub } from "dub";
26
+
27
+ const dub = new Dub({
28
+ token: "DUB_API_KEY",
29
+ workspaceId: "<value>",
30
+ });
31
+
32
+ async function run() {
33
+ const result = await dub.analytics.clicks.count({});
34
+
35
+ // Handle the result
36
+ console.log(result)
37
+ }
38
+
39
+ run();
40
+ ```
41
+
42
+ ### Parameters
43
+
44
+ | Parameter | Type | Required | Description |
45
+ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
46
+ | `request` | [operations.GetClicksCountRequest](../../models/operations/getclickscountrequest.md) | :heavy_check_mark: | The request object to use for the request. |
47
+ | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
48
+ | `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
49
+
50
+
51
+ ### Response
52
+
53
+ **Promise<[number](../../models/.md)>**
54
+ ### Errors
55
+
56
+ | Error Object | Status Code | Content Type |
57
+ | -------------------------- | -------------------------- | -------------------------- |
58
+ | errors.BadRequest | 400 | application/json |
59
+ | errors.Unauthorized | 401 | application/json |
60
+ | errors.Forbidden | 403 | application/json |
61
+ | errors.NotFound | 404 | application/json |
62
+ | errors.Conflict | 409 | application/json |
63
+ | errors.InviteExpired | 410 | application/json |
64
+ | errors.UnprocessableEntity | 422 | application/json |
65
+ | errors.RateLimitExceeded | 429 | application/json |
66
+ | errors.InternalServerError | 500 | application/json |
67
+ | errors.SDKError | 4xx-5xx | */* |
68
+
69
+ ## timeseries
70
+
71
+ Retrieve timeseries click analytics for a link, a domain, or the authenticated workspace over a period of time.
72
+
73
+ ### Example Usage
74
+
75
+ ```typescript
76
+ import { Dub } from "dub";
77
+
78
+ const dub = new Dub({
79
+ token: "DUB_API_KEY",
80
+ workspaceId: "<value>",
81
+ });
82
+
83
+ async function run() {
84
+ const result = await dub.analytics.clicks.timeseries({});
85
+
86
+ // Handle the result
87
+ console.log(result)
88
+ }
89
+
90
+ run();
91
+ ```
92
+
93
+ ### Parameters
94
+
95
+ | Parameter | Type | Required | Description |
96
+ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
97
+ | `request` | [operations.GetTimeseriesByClicksRequest](../../models/operations/gettimeseriesbyclicksrequest.md) | :heavy_check_mark: | The request object to use for the request. |
98
+ | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
99
+ | `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
100
+
101
+
102
+ ### Response
103
+
104
+ **Promise<[operations.ResponseBody[]](../../models/.md)>**
105
+ ### Errors
106
+
107
+ | Error Object | Status Code | Content Type |
108
+ | -------------------------- | -------------------------- | -------------------------- |
109
+ | errors.BadRequest | 400 | application/json |
110
+ | errors.Unauthorized | 401 | application/json |
111
+ | errors.Forbidden | 403 | application/json |
112
+ | errors.NotFound | 404 | application/json |
113
+ | errors.Conflict | 409 | application/json |
114
+ | errors.InviteExpired | 410 | application/json |
115
+ | errors.UnprocessableEntity | 422 | application/json |
116
+ | errors.RateLimitExceeded | 429 | application/json |
117
+ | errors.InternalServerError | 500 | application/json |
118
+ | errors.SDKError | 4xx-5xx | */* |
119
+
120
+ ## countries
121
+
122
+ Retrieve the top countries by number of clicks for a link, a domain, or the authenticated workspace.
123
+
124
+ ### Example Usage
125
+
126
+ ```typescript
127
+ import { Dub } from "dub";
128
+
129
+ const dub = new Dub({
130
+ token: "DUB_API_KEY",
131
+ workspaceId: "<value>",
132
+ });
133
+
134
+ async function run() {
135
+ const result = await dub.analytics.clicks.countries({});
136
+
137
+ // Handle the result
138
+ console.log(result)
139
+ }
140
+
141
+ run();
142
+ ```
143
+
144
+ ### Parameters
145
+
146
+ | Parameter | Type | Required | Description |
147
+ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
148
+ | `request` | [operations.GetCountriesByClicksRequest](../../models/operations/getcountriesbyclicksrequest.md) | :heavy_check_mark: | The request object to use for the request. |
149
+ | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
150
+ | `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
151
+
152
+
153
+ ### Response
154
+
155
+ **Promise<[operations.GetCountriesByClicksResponseBody[]](../../models/.md)>**
156
+ ### Errors
157
+
158
+ | Error Object | Status Code | Content Type |
159
+ | -------------------------- | -------------------------- | -------------------------- |
160
+ | errors.BadRequest | 400 | application/json |
161
+ | errors.Unauthorized | 401 | application/json |
162
+ | errors.Forbidden | 403 | application/json |
163
+ | errors.NotFound | 404 | application/json |
164
+ | errors.Conflict | 409 | application/json |
165
+ | errors.InviteExpired | 410 | application/json |
166
+ | errors.UnprocessableEntity | 422 | application/json |
167
+ | errors.RateLimitExceeded | 429 | application/json |
168
+ | errors.InternalServerError | 500 | application/json |
169
+ | errors.SDKError | 4xx-5xx | */* |
170
+
171
+ ## cities
172
+
173
+ Retrieve the top countries by number of clicks for a link, a domain, or the authenticated workspace.
174
+
175
+ ### Example Usage
176
+
177
+ ```typescript
178
+ import { Dub } from "dub";
179
+
180
+ const dub = new Dub({
181
+ token: "DUB_API_KEY",
182
+ workspaceId: "<value>",
183
+ });
184
+
185
+ async function run() {
186
+ const result = await dub.analytics.clicks.cities({});
187
+
188
+ // Handle the result
189
+ console.log(result)
190
+ }
191
+
192
+ run();
193
+ ```
194
+
195
+ ### Parameters
196
+
197
+ | Parameter | Type | Required | Description |
198
+ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
199
+ | `request` | [operations.GetCitiesByClicksRequest](../../models/operations/getcitiesbyclicksrequest.md) | :heavy_check_mark: | The request object to use for the request. |
200
+ | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
201
+ | `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
202
+
203
+
204
+ ### Response
205
+
206
+ **Promise<[operations.GetCitiesByClicksResponseBody[]](../../models/.md)>**
207
+ ### Errors
208
+
209
+ | Error Object | Status Code | Content Type |
210
+ | -------------------------- | -------------------------- | -------------------------- |
211
+ | errors.BadRequest | 400 | application/json |
212
+ | errors.Unauthorized | 401 | application/json |
213
+ | errors.Forbidden | 403 | application/json |
214
+ | errors.NotFound | 404 | application/json |
215
+ | errors.Conflict | 409 | application/json |
216
+ | errors.InviteExpired | 410 | application/json |
217
+ | errors.UnprocessableEntity | 422 | application/json |
218
+ | errors.RateLimitExceeded | 429 | application/json |
219
+ | errors.InternalServerError | 500 | application/json |
220
+ | errors.SDKError | 4xx-5xx | */* |
221
+
222
+ ## devices
223
+
224
+ Retrieve the top devices by number of clicks for a link, a domain, or the authenticated workspace.
225
+
226
+ ### Example Usage
227
+
228
+ ```typescript
229
+ import { Dub } from "dub";
230
+
231
+ const dub = new Dub({
232
+ token: "DUB_API_KEY",
233
+ workspaceId: "<value>",
234
+ });
235
+
236
+ async function run() {
237
+ const result = await dub.analytics.clicks.devices({});
238
+
239
+ // Handle the result
240
+ console.log(result)
241
+ }
242
+
243
+ run();
244
+ ```
245
+
246
+ ### Parameters
247
+
248
+ | Parameter | Type | Required | Description |
249
+ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
250
+ | `request` | [operations.GetDevicesByClicksRequest](../../models/operations/getdevicesbyclicksrequest.md) | :heavy_check_mark: | The request object to use for the request. |
251
+ | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
252
+ | `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
253
+
254
+
255
+ ### Response
256
+
257
+ **Promise<[operations.GetDevicesByClicksResponseBody[]](../../models/.md)>**
258
+ ### Errors
259
+
260
+ | Error Object | Status Code | Content Type |
261
+ | -------------------------- | -------------------------- | -------------------------- |
262
+ | errors.BadRequest | 400 | application/json |
263
+ | errors.Unauthorized | 401 | application/json |
264
+ | errors.Forbidden | 403 | application/json |
265
+ | errors.NotFound | 404 | application/json |
266
+ | errors.Conflict | 409 | application/json |
267
+ | errors.InviteExpired | 410 | application/json |
268
+ | errors.UnprocessableEntity | 422 | application/json |
269
+ | errors.RateLimitExceeded | 429 | application/json |
270
+ | errors.InternalServerError | 500 | application/json |
271
+ | errors.SDKError | 4xx-5xx | */* |
272
+
273
+ ## browsers
274
+
275
+ Retrieve the top browsers by number of clicks for a link, a domain, or the authenticated workspace.
276
+
277
+ ### Example Usage
278
+
279
+ ```typescript
280
+ import { Dub } from "dub";
281
+
282
+ const dub = new Dub({
283
+ token: "DUB_API_KEY",
284
+ workspaceId: "<value>",
285
+ });
286
+
287
+ async function run() {
288
+ const result = await dub.analytics.clicks.browsers({});
289
+
290
+ // Handle the result
291
+ console.log(result)
292
+ }
293
+
294
+ run();
295
+ ```
296
+
297
+ ### Parameters
298
+
299
+ | Parameter | Type | Required | Description |
300
+ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
301
+ | `request` | [operations.GetBrowsersByClicksRequest](../../models/operations/getbrowsersbyclicksrequest.md) | :heavy_check_mark: | The request object to use for the request. |
302
+ | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
303
+ | `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
304
+
305
+
306
+ ### Response
307
+
308
+ **Promise<[operations.GetBrowsersByClicksResponseBody[]](../../models/.md)>**
309
+ ### Errors
310
+
311
+ | Error Object | Status Code | Content Type |
312
+ | -------------------------- | -------------------------- | -------------------------- |
313
+ | errors.BadRequest | 400 | application/json |
314
+ | errors.Unauthorized | 401 | application/json |
315
+ | errors.Forbidden | 403 | application/json |
316
+ | errors.NotFound | 404 | application/json |
317
+ | errors.Conflict | 409 | application/json |
318
+ | errors.InviteExpired | 410 | application/json |
319
+ | errors.UnprocessableEntity | 422 | application/json |
320
+ | errors.RateLimitExceeded | 429 | application/json |
321
+ | errors.InternalServerError | 500 | application/json |
322
+ | errors.SDKError | 4xx-5xx | */* |
323
+
324
+ ## os
325
+
326
+ Retrieve the top OS by number of clicks for a link, a domain, or the authenticated workspace.
327
+
328
+ ### Example Usage
329
+
330
+ ```typescript
331
+ import { Dub } from "dub";
332
+
333
+ const dub = new Dub({
334
+ token: "DUB_API_KEY",
335
+ workspaceId: "<value>",
336
+ });
337
+
338
+ async function run() {
339
+ const result = await dub.analytics.clicks.os({});
340
+
341
+ // Handle the result
342
+ console.log(result)
343
+ }
344
+
345
+ run();
346
+ ```
347
+
348
+ ### Parameters
349
+
350
+ | Parameter | Type | Required | Description |
351
+ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
352
+ | `request` | [operations.GetOSByClicksRequest](../../models/operations/getosbyclicksrequest.md) | :heavy_check_mark: | The request object to use for the request. |
353
+ | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
354
+ | `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
355
+
356
+
357
+ ### Response
358
+
359
+ **Promise<[operations.GetOSByClicksResponseBody[]](../../models/.md)>**
360
+ ### Errors
361
+
362
+ | Error Object | Status Code | Content Type |
363
+ | -------------------------- | -------------------------- | -------------------------- |
364
+ | errors.BadRequest | 400 | application/json |
365
+ | errors.Unauthorized | 401 | application/json |
366
+ | errors.Forbidden | 403 | application/json |
367
+ | errors.NotFound | 404 | application/json |
368
+ | errors.Conflict | 409 | application/json |
369
+ | errors.InviteExpired | 410 | application/json |
370
+ | errors.UnprocessableEntity | 422 | application/json |
371
+ | errors.RateLimitExceeded | 429 | application/json |
372
+ | errors.InternalServerError | 500 | application/json |
373
+ | errors.SDKError | 4xx-5xx | */* |
374
+
375
+ ## referers
376
+
377
+ Retrieve the top referers by number of clicks for a link, a domain, or the authenticated workspace.
378
+
379
+ ### Example Usage
380
+
381
+ ```typescript
382
+ import { Dub } from "dub";
383
+
384
+ const dub = new Dub({
385
+ token: "DUB_API_KEY",
386
+ workspaceId: "<value>",
387
+ });
388
+
389
+ async function run() {
390
+ const result = await dub.analytics.clicks.referers({});
391
+
392
+ // Handle the result
393
+ console.log(result)
394
+ }
395
+
396
+ run();
397
+ ```
398
+
399
+ ### Parameters
400
+
401
+ | Parameter | Type | Required | Description |
402
+ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
403
+ | `request` | [operations.GetReferersByClicksRequest](../../models/operations/getreferersbyclicksrequest.md) | :heavy_check_mark: | The request object to use for the request. |
404
+ | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
405
+ | `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
406
+
407
+
408
+ ### Response
409
+
410
+ **Promise<[operations.GetReferersByClicksResponseBody[]](../../models/.md)>**
411
+ ### Errors
412
+
413
+ | Error Object | Status Code | Content Type |
414
+ | -------------------------- | -------------------------- | -------------------------- |
415
+ | errors.BadRequest | 400 | application/json |
416
+ | errors.Unauthorized | 401 | application/json |
417
+ | errors.Forbidden | 403 | application/json |
418
+ | errors.NotFound | 404 | application/json |
419
+ | errors.Conflict | 409 | application/json |
420
+ | errors.InviteExpired | 410 | application/json |
421
+ | errors.UnprocessableEntity | 422 | application/json |
422
+ | errors.RateLimitExceeded | 429 | application/json |
423
+ | errors.InternalServerError | 500 | application/json |
424
+ | errors.SDKError | 4xx-5xx | */* |
425
+
426
+ ## topLinks
427
+
428
+ Retrieve the top links by number of clicks for a domain or the authenticated workspace.
429
+
430
+ ### Example Usage
431
+
432
+ ```typescript
433
+ import { Dub } from "dub";
434
+
435
+ const dub = new Dub({
436
+ token: "DUB_API_KEY",
437
+ workspaceId: "<value>",
438
+ });
439
+
440
+ async function run() {
441
+ const result = await dub.analytics.clicks.topLinks({});
442
+
443
+ // Handle the result
444
+ console.log(result)
445
+ }
446
+
447
+ run();
448
+ ```
449
+
450
+ ### Parameters
451
+
452
+ | Parameter | Type | Required | Description |
453
+ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
454
+ | `request` | [operations.GetTopLinksByClicksRequest](../../models/operations/gettoplinksbyclicksrequest.md) | :heavy_check_mark: | The request object to use for the request. |
455
+ | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
456
+ | `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
457
+
458
+
459
+ ### Response
460
+
461
+ **Promise<[operations.GetTopLinksByClicksResponseBody[]](../../models/.md)>**
462
+ ### Errors
463
+
464
+ | Error Object | Status Code | Content Type |
465
+ | -------------------------- | -------------------------- | -------------------------- |
466
+ | errors.BadRequest | 400 | application/json |
467
+ | errors.Unauthorized | 401 | application/json |
468
+ | errors.Forbidden | 403 | application/json |
469
+ | errors.NotFound | 404 | application/json |
470
+ | errors.Conflict | 409 | application/json |
471
+ | errors.InviteExpired | 410 | application/json |
472
+ | errors.UnprocessableEntity | 422 | application/json |
473
+ | errors.RateLimitExceeded | 429 | application/json |
474
+ | errors.InternalServerError | 500 | application/json |
475
+ | errors.SDKError | 4xx-5xx | */* |
476
+
477
+ ## topUrls
478
+
479
+ Retrieve the top URLs by number of clicks for a given short link.
480
+
481
+ ### Example Usage
482
+
483
+ ```typescript
484
+ import { Dub } from "dub";
485
+
486
+ const dub = new Dub({
487
+ token: "DUB_API_KEY",
488
+ workspaceId: "<value>",
489
+ });
490
+
491
+ async function run() {
492
+ const result = await dub.analytics.clicks.topUrls({});
493
+
494
+ // Handle the result
495
+ console.log(result)
496
+ }
497
+
498
+ run();
499
+ ```
500
+
501
+ ### Parameters
502
+
503
+ | Parameter | Type | Required | Description |
504
+ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
505
+ | `request` | [operations.GetTopURLsByClicksRequest](../../models/operations/gettopurlsbyclicksrequest.md) | :heavy_check_mark: | The request object to use for the request. |
506
+ | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
507
+ | `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
508
+
509
+
510
+ ### Response
511
+
512
+ **Promise<[operations.GetTopURLsByClicksResponseBody[]](../../models/.md)>**
513
+ ### Errors
514
+
515
+ | Error Object | Status Code | Content Type |
516
+ | -------------------------- | -------------------------- | -------------------------- |
517
+ | errors.BadRequest | 400 | application/json |
518
+ | errors.Unauthorized | 401 | application/json |
519
+ | errors.Forbidden | 403 | application/json |
520
+ | errors.NotFound | 404 | application/json |
521
+ | errors.Conflict | 409 | application/json |
522
+ | errors.InviteExpired | 410 | application/json |
523
+ | errors.UnprocessableEntity | 422 | application/json |
524
+ | errors.RateLimitExceeded | 429 | application/json |
525
+ | errors.InternalServerError | 500 | application/json |
526
+ | errors.SDKError | 4xx-5xx | */* |
527
+
528
+ ## ~~getClicksCountDeprecated~~
529
+
530
+ Retrieve the total number of clicks for a link, a domain, or the authenticated workspace.
531
+
532
+ > :warning: **DEPRECATED**: This method is deprecated. Use dub.analytics.clicks.count instead.. Use `count` instead.
533
+
534
+ ### Example Usage
535
+
536
+ ```typescript
537
+ import { Dub } from "dub";
538
+
539
+ const dub = new Dub({
540
+ token: "DUB_API_KEY",
541
+ workspaceId: "<value>",
542
+ });
543
+
544
+ async function run() {
545
+ const result = await dub.analytics.clicks.getClicksCountDeprecated({});
546
+
547
+ // Handle the result
548
+ console.log(result)
549
+ }
550
+
551
+ run();
552
+ ```
553
+
554
+ ### Parameters
555
+
556
+ | Parameter | Type | Required | Description |
557
+ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
558
+ | `request` | [operations.GetClicksCountDeprecatedRequest](../../models/operations/getclickscountdeprecatedrequest.md) | :heavy_check_mark: | The request object to use for the request. |
559
+ | `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
560
+ | `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
561
+
562
+
563
+ ### Response
564
+
565
+ **Promise<[number](../../models/.md)>**
566
+ ### Errors
567
+
568
+ | Error Object | Status Code | Content Type |
569
+ | -------------------------- | -------------------------- | -------------------------- |
570
+ | errors.BadRequest | 400 | application/json |
571
+ | errors.Unauthorized | 401 | application/json |
572
+ | errors.Forbidden | 403 | application/json |
573
+ | errors.NotFound | 404 | application/json |
574
+ | errors.Conflict | 409 | application/json |
575
+ | errors.InviteExpired | 410 | application/json |
576
+ | errors.UnprocessableEntity | 422 | application/json |
577
+ | errors.RateLimitExceeded | 429 | application/json |
578
+ | errors.InternalServerError | 500 | application/json |
579
+ | errors.SDKError | 4xx-5xx | */* |
@@ -271,7 +271,7 @@ run();
271
271
 
272
272
  ## update
273
273
 
274
- Update a link for the authenticated workspace. If there's no change, returns as is.
274
+ Update a link for the authenticated workspace. If there's no change, returns it as it is.
275
275
 
276
276
  ### Example Usage
277
277
 
@@ -380,7 +380,7 @@ run();
380
380
 
381
381
  ## upsert
382
382
 
383
- Upsert a link for the authenticated workspace by its URL. If a link with the same URL already exists, returns as is if there's no change, or update it. Otherwise, a new link will be created.
383
+ Upsert a link for the authenticated workspace by its URL. If a link with the same URL already exists, return it (or update it if there are any changes). Otherwise, a new link will be created.
384
384
 
385
385
  ### Example Usage
386
386