@geolens/sdk 1.25.1 → 1.27.0

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.
@@ -233,6 +233,171 @@ export const getEmbeddingStatsAdminEmbeddingStatsGet = (options) => (options?.cl
233
233
  url: '/admin/embedding-stats/',
234
234
  ...options
235
235
  });
236
+ /**
237
+ * List Groups
238
+ *
239
+ * List sharing groups by name, with member counts (admin only).
240
+ */
241
+ export const listGroupsAdminGroupsGet = (options) => (options?.client ?? client).get({
242
+ security: [
243
+ { scheme: 'bearer', type: 'http' },
244
+ { name: 'X-Api-Key', type: 'apiKey' },
245
+ {
246
+ in: 'query',
247
+ name: 'api_key',
248
+ type: 'apiKey'
249
+ }
250
+ ],
251
+ url: '/admin/groups/',
252
+ ...options
253
+ });
254
+ /**
255
+ * Create Group
256
+ *
257
+ * Create an empty sharing group (admin only). A duplicate name is 409.
258
+ */
259
+ export const createGroupAdminGroupsPost = (options) => (options.client ?? client).post({
260
+ security: [
261
+ { scheme: 'bearer', type: 'http' },
262
+ { name: 'X-Api-Key', type: 'apiKey' },
263
+ {
264
+ in: 'query',
265
+ name: 'api_key',
266
+ type: 'apiKey'
267
+ }
268
+ ],
269
+ url: '/admin/groups/',
270
+ ...options,
271
+ headers: {
272
+ 'Content-Type': 'application/json',
273
+ ...options.headers
274
+ }
275
+ });
276
+ /**
277
+ * Delete Group
278
+ *
279
+ * Delete a sharing group and all its memberships (admin only).
280
+ *
281
+ * Its members lose the group's datasets and maps at once, signed tile URLs
282
+ * included. A restricted map shared only with this group becomes private.
283
+ */
284
+ export const deleteGroupAdminGroupsGroupIdDelete = (options) => (options.client ?? client).delete({
285
+ security: [
286
+ { scheme: 'bearer', type: 'http' },
287
+ { name: 'X-Api-Key', type: 'apiKey' },
288
+ {
289
+ in: 'query',
290
+ name: 'api_key',
291
+ type: 'apiKey'
292
+ }
293
+ ],
294
+ url: '/admin/groups/{group_id}',
295
+ ...options
296
+ });
297
+ /**
298
+ * Get Group
299
+ *
300
+ * Get one sharing group with its member count (admin only).
301
+ */
302
+ export const getGroupAdminGroupsGroupIdGet = (options) => (options.client ?? client).get({
303
+ security: [
304
+ { scheme: 'bearer', type: 'http' },
305
+ { name: 'X-Api-Key', type: 'apiKey' },
306
+ {
307
+ in: 'query',
308
+ name: 'api_key',
309
+ type: 'apiKey'
310
+ }
311
+ ],
312
+ url: '/admin/groups/{group_id}',
313
+ ...options
314
+ });
315
+ /**
316
+ * Rename Group
317
+ *
318
+ * Rename a sharing group (admin only). A name already in use is 409.
319
+ */
320
+ export const renameGroupAdminGroupsGroupIdPatch = (options) => (options.client ?? client).patch({
321
+ security: [
322
+ { scheme: 'bearer', type: 'http' },
323
+ { name: 'X-Api-Key', type: 'apiKey' },
324
+ {
325
+ in: 'query',
326
+ name: 'api_key',
327
+ type: 'apiKey'
328
+ }
329
+ ],
330
+ url: '/admin/groups/{group_id}',
331
+ ...options,
332
+ headers: {
333
+ 'Content-Type': 'application/json',
334
+ ...options.headers
335
+ }
336
+ });
337
+ /**
338
+ * List Group Members
339
+ *
340
+ * List a sharing group's members by username (admin only).
341
+ */
342
+ export const listGroupMembersAdminGroupsGroupIdMembersGet = (options) => (options.client ?? client).get({
343
+ security: [
344
+ { scheme: 'bearer', type: 'http' },
345
+ { name: 'X-Api-Key', type: 'apiKey' },
346
+ {
347
+ in: 'query',
348
+ name: 'api_key',
349
+ type: 'apiKey'
350
+ }
351
+ ],
352
+ url: '/admin/groups/{group_id}/members/',
353
+ ...options
354
+ });
355
+ /**
356
+ * Add Group Members
357
+ *
358
+ * Add users to a sharing group (admin only).
359
+ *
360
+ * Users already in the group are skipped. If any id matches no user, the
361
+ * request is 404 and nobody is added. 422 when the new members' access to
362
+ * the group's datasets would let a VRT reach past one of its sources.
363
+ */
364
+ export const addGroupMembersAdminGroupsGroupIdMembersPost = (options) => (options.client ?? client).post({
365
+ security: [
366
+ { scheme: 'bearer', type: 'http' },
367
+ { name: 'X-Api-Key', type: 'apiKey' },
368
+ {
369
+ in: 'query',
370
+ name: 'api_key',
371
+ type: 'apiKey'
372
+ }
373
+ ],
374
+ url: '/admin/groups/{group_id}/members/',
375
+ ...options,
376
+ headers: {
377
+ 'Content-Type': 'application/json',
378
+ ...options.headers
379
+ }
380
+ });
381
+ /**
382
+ * Remove Group Member
383
+ *
384
+ * Remove one user from a sharing group (admin only).
385
+ *
386
+ * The user loses the group's datasets at once, signed tile URLs included.
387
+ */
388
+ export const removeGroupMemberAdminGroupsGroupIdMembersUserIdDelete = (options) => (options.client ?? client).delete({
389
+ security: [
390
+ { scheme: 'bearer', type: 'http' },
391
+ { name: 'X-Api-Key', type: 'apiKey' },
392
+ {
393
+ in: 'query',
394
+ name: 'api_key',
395
+ type: 'apiKey'
396
+ }
397
+ ],
398
+ url: '/admin/groups/{group_id}/members/{user_id}',
399
+ ...options
400
+ });
236
401
  /**
237
402
  * Get Infrastructure
238
403
  *
@@ -1193,6 +1358,27 @@ export const verifyEmailAuthVerifyEmailPost = (options) => (options.client ?? cl
1193
1358
  ...options.headers
1194
1359
  }
1195
1360
  });
1361
+ /**
1362
+ * Get Capabilities
1363
+ *
1364
+ * Describe what this server offers, for a client's first call.
1365
+ *
1366
+ * Anonymous callers get the server, sign-in, basemap, workflow and rate-limit
1367
+ * facts. A caller with credentials also gets `upload` and `me`.
1368
+ */
1369
+ export const getCapabilitiesCapabilitiesGet = (options) => (options?.client ?? client).get({
1370
+ security: [
1371
+ { scheme: 'bearer', type: 'http' },
1372
+ { name: 'X-Api-Key', type: 'apiKey' },
1373
+ {
1374
+ in: 'query',
1375
+ name: 'api_key',
1376
+ type: 'apiKey'
1377
+ }
1378
+ ],
1379
+ url: '/capabilities/',
1380
+ ...options
1381
+ });
1196
1382
  /**
1197
1383
  * List Collections Endpoint
1198
1384
  *
@@ -1876,6 +2062,42 @@ export const updateDatasetMetadataDatasetsDatasetIdPatch = (options) => (options
1876
2062
  ...options.headers
1877
2063
  }
1878
2064
  });
2065
+ /**
2066
+ * Aggregate Endpoint
2067
+ *
2068
+ * Compute one exact aggregate over a dataset's rows, for a widget.
2069
+ *
2070
+ * Anonymous callers can read public, published datasets; ``X-Embed-Token``
2071
+ * authorizes datasets in the token's scope. Other datasets return 404.
2072
+ *
2073
+ * With ``bbox``, a view the planner expects to hold more than 500,000 rows
2074
+ * is refused with 422 and the code ``too_wide`` rather than approximated. A
2075
+ * ``bbox`` that contains the whole dataset is answered as the whole layer.
2076
+ * Refusals carry a ``code`` in ``detail``: ``too_wide``, ``invalid_column``,
2077
+ * ``invalid_filter``, ``no_geometry``, ``query_timeout``,
2078
+ * ``query_data_error``, ``result_too_large``, and with 429 ``query_busy``
2079
+ * (this caller already has two aggregates running) or ``query_at_capacity``.
2080
+ *
2081
+ * Clients should keep at most two requests in flight per caller and retry a
2082
+ * 429 after 200-400 ms with jitter.
2083
+ */
2084
+ export const aggregateEndpointDatasetsDatasetIdAggregatePost = (options) => (options.client ?? client).post({
2085
+ security: [
2086
+ { scheme: 'bearer', type: 'http' },
2087
+ { name: 'X-Api-Key', type: 'apiKey' },
2088
+ {
2089
+ in: 'query',
2090
+ name: 'api_key',
2091
+ type: 'apiKey'
2092
+ }
2093
+ ],
2094
+ url: '/datasets/{dataset_id}/aggregate/',
2095
+ ...options,
2096
+ headers: {
2097
+ 'Content-Type': 'application/json',
2098
+ ...options.headers
2099
+ }
2100
+ });
1879
2101
  /**
1880
2102
  * Analysis Materialize Endpoint
1881
2103
  *
@@ -1930,6 +2152,79 @@ export const analysisPreviewEndpointDatasetsDatasetIdAnalysisPreviewPost = (opti
1930
2152
  ...options.headers
1931
2153
  }
1932
2154
  });
2155
+ /**
2156
+ * List Dataset Api Keys
2157
+ *
2158
+ * List the active keys bound to this dataset, newest first.
2159
+ *
2160
+ * Requires write access to the dataset. The dataset's owner and admins see
2161
+ * every key bound to it, anyone else only their own. Expired keys stay
2162
+ * listed until revoked.
2163
+ */
2164
+ export const listDatasetApiKeysDatasetsDatasetIdApiKeysGet = (options) => (options.client ?? client).get({
2165
+ security: [
2166
+ { scheme: 'bearer', type: 'http' },
2167
+ { name: 'X-Api-Key', type: 'apiKey' },
2168
+ {
2169
+ in: 'query',
2170
+ name: 'api_key',
2171
+ type: 'apiKey'
2172
+ }
2173
+ ],
2174
+ url: '/datasets/{dataset_id}/api-keys',
2175
+ ...options
2176
+ });
2177
+ /**
2178
+ * Create Dataset Api Key
2179
+ *
2180
+ * Create a key that reaches only this dataset's features.
2181
+ *
2182
+ * A ``dataset_write`` key, the default, authenticates the dataset's feature
2183
+ * routes and OGC API Features items. A ``dataset_append`` key authenticates
2184
+ * only `POST /datasets/{dataset_id}/features/`, so it can add features but
2185
+ * not read, change or delete them. Either is treated as an invalid key
2186
+ * everywhere else. The key acts as the caller, so the caller's own access
2187
+ * to the dataset still applies to every request it makes. Its feature
2188
+ * writes go through even when the instance has dataset editing switched
2189
+ * off. It must expire within 365 days. Requires write access to the
2190
+ * dataset, the ``edit_metadata`` permission the feature writes need, and a
2191
+ * signed-in session. A dataset that can't take feature edits (no feature
2192
+ * table or no geometry column) gets 422. A dataset holds at most 100 keys
2193
+ * that aren't revoked, expired ones included; minting past that gets 409
2194
+ * until one is revoked. The raw key is returned only in this response.
2195
+ */
2196
+ export const createDatasetApiKeyDatasetsDatasetIdApiKeysPost = (options) => (options.client ?? client).post({
2197
+ security: [{ scheme: 'bearer', type: 'http' }],
2198
+ url: '/datasets/{dataset_id}/api-keys',
2199
+ ...options,
2200
+ headers: {
2201
+ 'Content-Type': 'application/json',
2202
+ ...options.headers
2203
+ }
2204
+ });
2205
+ /**
2206
+ * Revoke Dataset Api Key
2207
+ *
2208
+ * Revoke a key bound to this dataset.
2209
+ *
2210
+ * The key's creator may revoke it while they can see the dataset, even
2211
+ * after losing write access to it; anyone with write access may revoke any
2212
+ * key bound to it, checked again under the dataset's row lock. Answers 404
2213
+ * when no active key with this id is bound to the dataset.
2214
+ */
2215
+ export const revokeDatasetApiKeyDatasetsDatasetIdApiKeysKeyIdDelete = (options) => (options.client ?? client).delete({
2216
+ security: [
2217
+ { scheme: 'bearer', type: 'http' },
2218
+ { name: 'X-Api-Key', type: 'apiKey' },
2219
+ {
2220
+ in: 'query',
2221
+ name: 'api_key',
2222
+ type: 'apiKey'
2223
+ }
2224
+ ],
2225
+ url: '/datasets/{dataset_id}/api-keys/{key_id}',
2226
+ ...options
2227
+ });
1933
2228
  /**
1934
2229
  * List Attributes Endpoint
1935
2230
  *
@@ -2048,12 +2343,13 @@ export const getColumnValuesDatasetsDatasetIdColumnsColumnNameValuesGet = (optio
2048
2343
  * Serve a published COPC point cloud's file, whole or by HTTP byte range.
2049
2344
  *
2050
2345
  * Point a client at the dataset's ``pointcloud.url``. The path names the
2051
- * upload attempt, so a replaced file gets a new URL and the old one answers
2052
- * 404. Header credentials (``X-Api-Key`` or ``Authorization``) or the
2053
- * ``api_key`` query parameter authenticate the read, and any caller who can
2054
- * view the dataset can read the file. The response carries a strong ETag and
2055
- * honours ``Range``, ``If-Range``, ``If-Match`` and ``If-None-Match``; a
2056
- * malformed byte range, or one naming no byte of the file, answers 416.
2346
+ * upload attempt, and a URL naming any other attempt answers 404. Point
2347
+ * clouds cannot be replaced; a new file is a new dataset. Header credentials
2348
+ * (``X-Api-Key`` or ``Authorization``) or the ``api_key`` query parameter
2349
+ * authenticate the read, and any caller who can view the dataset can read the
2350
+ * file. The response carries a strong ETag and honours ``Range``,
2351
+ * ``If-Range``, ``If-Match`` and ``If-None-Match``; a malformed byte range, or
2352
+ * one naming no byte of the file, answers 416.
2057
2353
  * Each client may make 1200 reads a minute. A read of one byte range of up
2058
2354
  * to 16 MiB also draws its size on a budget of 1 GiB a minute, in 64 KiB
2059
2355
  * units; any other read of the file, such as one without ``Range``, counts
@@ -2062,8 +2358,8 @@ export const getColumnValuesDatasetsDatasetIdColumnsColumnNameValuesGet = (optio
2062
2358
  * A page on any origin can read a public file without credentials. Through
2063
2359
  * the bundled web server it can also send header credentials; the API alone
2064
2360
  * accepts those only from the origins in ``CORS_ALLOWED_ORIGINS``. A
2065
- * private, missing or replaced point cloud answers 404, and a storage
2066
- * failure answers 502.
2361
+ * private or missing point cloud answers 404, and a storage failure answers
2362
+ * 502.
2067
2363
  */
2068
2364
  export const getPointcloudFileDatasetsDatasetIdCopcAttemptIdNameCopcLazGet = (options) => (options.client ?? client).get({
2069
2365
  security: [
@@ -2277,6 +2573,26 @@ export const listFeaturesDatasetsDatasetIdFeaturesGet = (options) => (options.cl
2277
2573
  * been replaced by a reupload or an overwrite, the repeat is refused with 409
2278
2574
  * rather than creating another. Without the key every request inserts, and
2279
2575
  * an attempt number sent without one is ignored.
2576
+ *
2577
+ * Through an append-only dataset key, every created feature, single or in a
2578
+ * FeatureCollection, is answered with its `id`, a null `geometry`, empty
2579
+ * `properties`, and null `table_id` and `tile_cache_version`, since the
2580
+ * stored row can hold values the key didn't send and the others move with
2581
+ * other writers. A repeat through one matches only that key's own creates,
2582
+ * applies nothing and answers the same way. If the feature was deleted or
2583
+ * the dataset's data replaced, the repeat gets 409 `feature_gone` with no
2584
+ * `tile_cache_version`.
2585
+ *
2586
+ * A GeoJSON FeatureCollection body inserts up to 1,000 features in one
2587
+ * transaction: all of them or none. A feature the schema refuses is named
2588
+ * by its position under `features` in the 422. One refused while writing
2589
+ * gets the status a single create would, with `detail.code`
2590
+ * `feature_refused`, `detail.index` (counting from 0) and
2591
+ * `detail.message`. The 201 answer is a FeatureCollection of the stored
2592
+ * features in request order, each as a single create returns it, with
2593
+ * `table_id` and `tile_cache_version` also on the collection. It has no
2594
+ * `Location` header since there is no single new resource.
2595
+ * `Idempotency-Key` is refused with 422 for a FeatureCollection.
2280
2596
  */
2281
2597
  export const createFeatureDatasetsDatasetIdFeaturesPost = (options) => (options.client ?? client).post({
2282
2598
  security: [
@@ -2295,6 +2611,72 @@ export const createFeatureDatasetsDatasetIdFeaturesPost = (options) => (options.
2295
2611
  ...options.headers
2296
2612
  }
2297
2613
  });
2614
+ /**
2615
+ * Delete Features Batch
2616
+ *
2617
+ * Delete up to 1,000 features by gid in one transaction (hard delete).
2618
+ *
2619
+ * Either every listed feature is deleted or none is. If any gid does not
2620
+ * exist, the request is refused with 404, `detail.code` `feature_not_found`
2621
+ * and the missing ids in `detail.gids`. A gid listed twice is deleted once.
2622
+ * Takes the checks and the `table_id` a single delete takes, and writes one
2623
+ * `feature.bulk_delete` audit entry.
2624
+ */
2625
+ export const deleteFeaturesBatchDatasetsDatasetIdFeaturesDeletePost = (options) => (options.client ?? client).post({
2626
+ security: [
2627
+ { scheme: 'bearer', type: 'http' },
2628
+ { name: 'X-Api-Key', type: 'apiKey' },
2629
+ {
2630
+ in: 'query',
2631
+ name: 'api_key',
2632
+ type: 'apiKey'
2633
+ }
2634
+ ],
2635
+ url: '/datasets/{dataset_id}/features/delete/',
2636
+ ...options,
2637
+ headers: {
2638
+ 'Content-Type': 'application/json',
2639
+ ...options.headers
2640
+ }
2641
+ });
2642
+ /**
2643
+ * Dry Run Create Feature
2644
+ *
2645
+ * Check a feature create without writing it.
2646
+ *
2647
+ * Takes the body `POST /datasets/{dataset_id}/features/` takes and runs
2648
+ * every check that create runs, the database's own casts and constraints
2649
+ * included, so a body it would refuse is refused here with the same status
2650
+ * and body. A deferred constraint is checked here too: a create that breaks
2651
+ * one fails at commit with a 500, and this answers 400. Nothing is written.
2652
+ * A body that passes gets 200 with the feature as it would be stored, or a
2653
+ * FeatureCollection of them in request order, with no `id`, `table_id` or
2654
+ * `tile_cache_version`.
2655
+ *
2656
+ * A dataset whose table has a shape that lets an insert run code with
2657
+ * effects outside the transaction, such as a trigger, a CHECK constraint or
2658
+ * a user-defined column type, is refused with 409, and the detail names
2659
+ * those shapes. The insert still runs column defaults, type input functions
2660
+ * and index support functions, volatile defaults included, so a dry run can
2661
+ * consume sequence values and stored ids can have gaps.
2662
+ */
2663
+ export const dryRunCreateFeatureDatasetsDatasetIdFeaturesDryRunPost = (options) => (options.client ?? client).post({
2664
+ security: [
2665
+ { scheme: 'bearer', type: 'http' },
2666
+ { name: 'X-Api-Key', type: 'apiKey' },
2667
+ {
2668
+ in: 'query',
2669
+ name: 'api_key',
2670
+ type: 'apiKey'
2671
+ }
2672
+ ],
2673
+ url: '/datasets/{dataset_id}/features/dry-run/',
2674
+ ...options,
2675
+ headers: {
2676
+ 'Content-Type': 'application/json',
2677
+ ...options.headers
2678
+ }
2679
+ });
2298
2680
  /**
2299
2681
  * Delete Single Feature
2300
2682
  *
@@ -2438,6 +2820,35 @@ export const validateGeodcatApRecordDatasetsDatasetIdGeodcatApValidationGet = (o
2438
2820
  url: '/datasets/{dataset_id}/geodcat-ap/validation/',
2439
2821
  ...options
2440
2822
  });
2823
+ /**
2824
+ * Set Dataset Groups Endpoint
2825
+ *
2826
+ * Share a dataset with exactly these sharing groups (owner or admin).
2827
+ *
2828
+ * An owner may add only groups they belong to (403); an admin may add any.
2829
+ * A private dataset shared with a group becomes restricted, and a restricted
2830
+ * one left with no group or role grant becomes private; internal and public
2831
+ * datasets keep their audience. 404 for an unknown group, and 422 when the
2832
+ * change would hide the dataset from viewers of the owner's shared maps or
2833
+ * let a VRT reach people who cannot see all of its sources.
2834
+ */
2835
+ export const setDatasetGroupsEndpointDatasetsDatasetIdGroupsPut = (options) => (options.client ?? client).put({
2836
+ security: [
2837
+ { scheme: 'bearer', type: 'http' },
2838
+ { name: 'X-Api-Key', type: 'apiKey' },
2839
+ {
2840
+ in: 'query',
2841
+ name: 'api_key',
2842
+ type: 'apiKey'
2843
+ }
2844
+ ],
2845
+ url: '/datasets/{dataset_id}/groups/',
2846
+ ...options,
2847
+ headers: {
2848
+ 'Content-Type': 'application/json',
2849
+ ...options.headers
2850
+ }
2851
+ });
2441
2852
  /**
2442
2853
  * Get Dataset History
2443
2854
  *
@@ -2477,13 +2888,13 @@ export const datasetMapsDatasetsDatasetIdMapsGet = (options) => (options.client
2477
2888
  /**
2478
2889
  * Delete Previous Version
2479
2890
  *
2480
- * Delete the dataset's previous version, so it can no longer be restored.
2891
+ * Delete the dataset's newest kept version, so it can no longer be restored.
2892
+ *
2893
+ * Deprecated: use ``DELETE /previous-versions/{version_number}``. Behaves
2894
+ * like it, and also refuses with 409 ``previous_version_changed`` when
2895
+ * ``expected_version_number`` is not the newest kept version.
2481
2896
  *
2482
- * Refuses with 404 ``no_previous_version`` when there is none, 409
2483
- * ``previous_version_changed`` when it is not ``expected_version_number``,
2484
- * 409 ``previous_version_in_use`` while a view or foreign key elsewhere
2485
- * reads its table, and 409 ``dataset_busy`` while a refresh, replacement or
2486
- * restore is active.
2897
+ * @deprecated
2487
2898
  */
2488
2899
  export const deletePreviousVersionDatasetsDatasetIdPreviousVersionDelete = (options) => (options.client ?? client).delete({
2489
2900
  security: [
@@ -2501,20 +2912,13 @@ export const deletePreviousVersionDatasetsDatasetIdPreviousVersionDelete = (opti
2501
2912
  /**
2502
2913
  * Restore Previous Version
2503
2914
  *
2504
- * Publish the dataset's previous version as its live data again.
2915
+ * Publish the dataset's newest kept version as its live data again.
2505
2916
  *
2506
- * The previous version is the data the last replacement or restore
2507
- * replaced. The restore runs as a job and a refresh run with origin kind
2508
- * ``restore``, and publishes a new version that names the restored one in
2509
- * ``restored_from_version``. The data it replaces, including any feature
2510
- * edits made since, becomes the previous version in turn. Scheduled
2511
- * refreshes of the dataset are held afterwards.
2917
+ * Deprecated: use ``POST /previous-versions/{version_number}/restore``.
2918
+ * Behaves like it, and also refuses with 409 ``previous_version_changed``
2919
+ * when ``expected_version_number`` is not the newest kept version.
2512
2920
  *
2513
- * Refuses with 422 ``restore_not_applicable`` for a dataset without a
2514
- * feature table, 404 ``no_previous_version`` when there is none, 409
2515
- * ``previous_version_changed`` when it is not ``expected_version_number``,
2516
- * and 409 ``dataset_busy`` while another refresh, replacement or restore is
2517
- * active.
2921
+ * @deprecated
2518
2922
  */
2519
2923
  export const restorePreviousVersionDatasetsDatasetIdPreviousVersionRestorePost = (options) => (options.client ?? client).post({
2520
2924
  security: [
@@ -2533,6 +2937,59 @@ export const restorePreviousVersionDatasetsDatasetIdPreviousVersionRestorePost =
2533
2937
  ...options.headers
2534
2938
  }
2535
2939
  });
2940
+ /**
2941
+ * Delete Kept Version
2942
+ *
2943
+ * Delete one of the dataset's kept previous versions, so it can no longer be restored.
2944
+ *
2945
+ * Refuses with 404 ``no_previous_version`` when the dataset does not keep
2946
+ * ``version_number``, 409 ``previous_version_in_use`` while a view or
2947
+ * foreign key elsewhere reads its table, and 409 ``dataset_busy`` while a
2948
+ * refresh, replacement or restore is active.
2949
+ */
2950
+ export const deleteKeptVersionDatasetsDatasetIdPreviousVersionsVersionNumberDelete = (options) => (options.client ?? client).delete({
2951
+ security: [
2952
+ { scheme: 'bearer', type: 'http' },
2953
+ { name: 'X-Api-Key', type: 'apiKey' },
2954
+ {
2955
+ in: 'query',
2956
+ name: 'api_key',
2957
+ type: 'apiKey'
2958
+ }
2959
+ ],
2960
+ url: '/datasets/{dataset_id}/previous-versions/{version_number}',
2961
+ ...options
2962
+ });
2963
+ /**
2964
+ * Restore Kept Version
2965
+ *
2966
+ * Publish one of the dataset's kept previous versions as its live data again.
2967
+ *
2968
+ * The dataset detail lists the kept versions in ``previous_versions``. The
2969
+ * restore runs as a job and a refresh run with origin kind ``restore``, and
2970
+ * publishes a new version that names the restored one in
2971
+ * ``restored_from_version``. The data it replaces, including any feature
2972
+ * edits made since, becomes a kept version in turn. Scheduled refreshes of
2973
+ * the dataset are held afterwards.
2974
+ *
2975
+ * Refuses with 422 ``restore_not_applicable`` for a dataset without a
2976
+ * feature table, 404 ``no_previous_version`` when the dataset does not keep
2977
+ * ``version_number``, and 409 ``dataset_busy`` while another refresh,
2978
+ * replacement or restore is active.
2979
+ */
2980
+ export const restoreKeptVersionDatasetsDatasetIdPreviousVersionsVersionNumberRestorePost = (options) => (options.client ?? client).post({
2981
+ security: [
2982
+ { scheme: 'bearer', type: 'http' },
2983
+ { name: 'X-Api-Key', type: 'apiKey' },
2984
+ {
2985
+ in: 'query',
2986
+ name: 'api_key',
2987
+ type: 'apiKey'
2988
+ }
2989
+ ],
2990
+ url: '/datasets/{dataset_id}/previous-versions/{version_number}/restore',
2991
+ ...options
2992
+ });
2536
2993
  /**
2537
2994
  * Get Quicklook
2538
2995
  *
@@ -2692,6 +3149,35 @@ export const createDatasetRelationshipDatasetsDatasetIdRelationshipsPost = (opti
2692
3149
  ...options.headers
2693
3150
  }
2694
3151
  });
3152
+ /**
3153
+ * Set Dataset Retention
3154
+ *
3155
+ * Set or clear how many days of rows a feature dataset keeps.
3156
+ *
3157
+ * Hourly worker runs delete rows whose retention column is older than the
3158
+ * cutoff, in batches, so a large backlog can take several runs; rows where
3159
+ * it is null are kept. A dry run counts the rows past the cutoff now in
3160
+ * `rows_past_cutoff`; a save skips that scan and returns null. The
3161
+ * instance's dataset editing switch does not apply: this is the owner's
3162
+ * setting, not an edit.
3163
+ */
3164
+ export const setDatasetRetentionDatasetsDatasetIdRetentionPut = (options) => (options.client ?? client).put({
3165
+ security: [
3166
+ { scheme: 'bearer', type: 'http' },
3167
+ { name: 'X-Api-Key', type: 'apiKey' },
3168
+ {
3169
+ in: 'query',
3170
+ name: 'api_key',
3171
+ type: 'apiKey'
3172
+ }
3173
+ ],
3174
+ url: '/datasets/{dataset_id}/retention/',
3175
+ ...options,
3176
+ headers: {
3177
+ 'Content-Type': 'application/json',
3178
+ ...options.headers
3179
+ }
3180
+ });
2695
3181
  /**
2696
3182
  * Reupload Dataset
2697
3183
  *
@@ -2836,7 +3322,8 @@ export const reuploadPreviewDatasetsDatasetIdReuploadJobIdPreviewPost = (options
2836
3322
  *
2837
3323
  * Get keyset-paginated rows from a dataset's data table.
2838
3324
  *
2839
- * Uses cursor-based pagination: pass ``after`` (gid) to fetch the next page.
3325
+ * Uses cursor-based pagination: pass ``after`` (the ``next_cursor`` gid) to
3326
+ * fetch the next page, with or without ``sort``.
2840
3327
  * Supports column filtering via query params: ``filter[column_name]=value``.
2841
3328
  */
2842
3329
  export const getDatasetRowsEndpointDatasetsDatasetIdRowsGet = (options) => (options.client ?? client).get({
@@ -3084,6 +3571,26 @@ export const getVrtStatusDatasetsDatasetIdVrtStatusGet = (options) => (options.c
3084
3571
  url: '/datasets/{dataset_id}/vrt/status/',
3085
3572
  ...options
3086
3573
  });
3574
+ /**
3575
+ * List My Groups
3576
+ *
3577
+ * List the sharing groups the caller may share with, by name.
3578
+ *
3579
+ * That is the groups the caller belongs to, or every group for an admin.
3580
+ */
3581
+ export const listMyGroupsGroupsMineGet = (options) => (options?.client ?? client).get({
3582
+ security: [
3583
+ { scheme: 'bearer', type: 'http' },
3584
+ { name: 'X-Api-Key', type: 'apiKey' },
3585
+ {
3586
+ in: 'query',
3587
+ name: 'api_key',
3588
+ type: 'apiKey'
3589
+ }
3590
+ ],
3591
+ url: '/groups/mine/',
3592
+ ...options
3593
+ });
3087
3594
  /**
3088
3595
  * Health
3089
3596
  *
@@ -3411,7 +3918,7 @@ export const uploadFromUrlIngestUploadUrlPost = (options) => (options.client ??
3411
3918
  *
3412
3919
  * Validates sources synchronously, then defers VRT assembly to an async task.
3413
3920
  * Returns a job_id for polling. Validation + queuing logic lives in
3414
- * ``ingest.service.create_vrt_job`` (K5 extraction).
3921
+ * ``ingest.service.create_vrt_job``.
3415
3922
  */
3416
3923
  export const createVrtIngestVrtCreatePost = (options) => (options.client ?? client).post({
3417
3924
  security: [
@@ -3545,6 +4052,33 @@ export const cleanupStaleJobsJobsCleanupStalePost = (options) => (options?.clien
3545
4052
  url: '/jobs/cleanup/stale/',
3546
4053
  ...options
3547
4054
  });
4055
+ /**
4056
+ * Get Job Statuses
4057
+ *
4058
+ * Get the status of up to 100 ingestion jobs in one request.
4059
+ *
4060
+ * Applies the same access rule as `GET /jobs/{id}`: the job creator, or a
4061
+ * caller the effective permission policy lets read other users' jobs. An
4062
+ * unknown id and a job the caller may not read both come back as
4063
+ * `not_found`, so the response does not reveal which jobs exist.
4064
+ */
4065
+ export const getJobStatusesJobsStatusPost = (options) => (options.client ?? client).post({
4066
+ security: [
4067
+ { scheme: 'bearer', type: 'http' },
4068
+ { name: 'X-Api-Key', type: 'apiKey' },
4069
+ {
4070
+ in: 'query',
4071
+ name: 'api_key',
4072
+ type: 'apiKey'
4073
+ }
4074
+ ],
4075
+ url: '/jobs/status/',
4076
+ ...options,
4077
+ headers: {
4078
+ 'Content-Type': 'application/json',
4079
+ ...options.headers
4080
+ }
4081
+ });
3548
4082
  /**
3549
4083
  * Get Job Status
3550
4084
  *
@@ -3750,10 +4284,10 @@ export const alterColumnTypeEndpointLayersDatasetIdColumnsColumnNameTypePatch =
3750
4284
  /**
3751
4285
  * List Maps Endpoint
3752
4286
  *
3753
- * List maps. Admins see all; authenticated users see own + internal + public; anonymous see public only.
4287
+ * List maps. Admins see all; authenticated users see own + internal + public + restricted maps shared with their groups; anonymous see public only.
3754
4288
  *
3755
4289
  * Supports search (ILIKE on name+description), sort_by (name/created_at/updated_at),
3756
- * sort_dir (asc/desc), and visibility filter (private/internal/public).
4290
+ * sort_dir (asc/desc), and visibility filter (private/internal/public/restricted).
3757
4291
  * owned_only restricts results to the caller's maps; anonymous callers get no maps.
3758
4292
  */
3759
4293
  export const listMapsEndpointMapsGet = (options) => (options?.client ?? client).get({
@@ -3873,6 +4407,35 @@ export const importMapStyleEndpointMapsImportPost = (options) => (options.client
3873
4407
  ...options.headers
3874
4408
  }
3875
4409
  });
4410
+ /**
4411
+ * Import Arcgis Webmap Endpoint
4412
+ *
4413
+ * Import an ArcGIS web map as a new GeoLens map.
4414
+ *
4415
+ * Translates the web map's operational layers, renderers, labels, popups and
4416
+ * scale ranges, and reports everything it could not carry over in
4417
+ * `loss_report`. Only layers named in `dataset_matches` are imported, and
4418
+ * every matched dataset must be readable by the caller (404 otherwise). The
4419
+ * report is also written to the map's private notes. With `dry_run` nothing
4420
+ * is created and `map` is null.
4421
+ */
4422
+ export const importArcgisWebmapEndpointMapsImportArcgisWebmapPost = (options) => (options.client ?? client).post({
4423
+ security: [
4424
+ { scheme: 'bearer', type: 'http' },
4425
+ { name: 'X-Api-Key', type: 'apiKey' },
4426
+ {
4427
+ in: 'query',
4428
+ name: 'api_key',
4429
+ type: 'apiKey'
4430
+ }
4431
+ ],
4432
+ url: '/maps/import/arcgis-webmap/',
4433
+ ...options,
4434
+ headers: {
4435
+ 'Content-Type': 'application/json',
4436
+ ...options.headers
4437
+ }
4438
+ });
3876
4439
  /**
3877
4440
  * Get Shared Map Endpoint
3878
4441
  *
@@ -4112,6 +4675,38 @@ export const updateEmbedTokenEndpointMapsMapIdEmbedTokensTokenIdPatch = (options
4112
4675
  ...options.headers
4113
4676
  }
4114
4677
  });
4678
+ /**
4679
+ * Set Map Groups Endpoint
4680
+ *
4681
+ * Share a map with exactly these sharing groups (owner or admin).
4682
+ *
4683
+ * An owner may add only groups they belong to (403); an admin may add any.
4684
+ * A private map shared with a group becomes restricted and its members can
4685
+ * read it; a restricted one left with no group becomes private. Internal
4686
+ * and public maps keep their audience. Becoming restricted revokes the
4687
+ * map's share link and embed tokens. 404 for an unknown group.
4688
+ *
4689
+ * 409 (`detail.code` `layers_hidden_from_groups`, the layers under
4690
+ * `detail.layers`) when new groups can't read some layers; see `confirm`.
4691
+ * A lock wait that times out also answers 409, without `detail.code`.
4692
+ */
4693
+ export const setMapGroupsEndpointMapsMapIdGroupsPut = (options) => (options.client ?? client).put({
4694
+ security: [
4695
+ { scheme: 'bearer', type: 'http' },
4696
+ { name: 'X-Api-Key', type: 'apiKey' },
4697
+ {
4698
+ in: 'query',
4699
+ name: 'api_key',
4700
+ type: 'apiKey'
4701
+ }
4702
+ ],
4703
+ url: '/maps/{map_id}/groups/',
4704
+ ...options,
4705
+ headers: {
4706
+ 'Content-Type': 'application/json',
4707
+ ...options.headers
4708
+ }
4709
+ });
4115
4710
  /**
4116
4711
  * Get Map History Endpoint
4117
4712
  *
@@ -4439,12 +5034,10 @@ export const uploadThumbnailMapsMapIdThumbnailPut = (options) => (options.client
4439
5034
  /**
4440
5035
  * Visibility Check Endpoint
4441
5036
  *
4442
- * Check if a map has non-public datasets. Informational only.
5037
+ * Check which layers a map's audience can't see. Informational only.
4443
5038
  *
4444
- * Owner-or-admin like the other sharing mutations: the response names
4445
- * non-public dataset titles, which read access alone must not reveal.
4446
- * Read access is checked first so unreadable maps keep answering 404
4447
- * (existence-hiding); readable non-owners get 403.
5039
+ * Owner-or-admin, since the answer names datasets that read access alone
5040
+ * must not reveal. Unreadable maps answer 404; readable non-owners get 403.
4448
5041
  */
4449
5042
  export const visibilityCheckEndpointMapsMapIdVisibilityCheckGet = (options) => (options.client ?? client).get({
4450
5043
  security: [
@@ -5619,7 +6212,10 @@ export const searchPostStacSearchPost = (options) => (options.client ?? client).
5619
6212
  *
5620
6213
  * ``cluster_radius`` is a screen-pixel distance, the same units MapLibre's
5621
6214
  * ``clusterRadius`` uses, and ``cluster_max_zoom`` is the last zoom at which
5622
- * features are grouped. ``cols`` works as it does on the vector route, and
6215
+ * features are grouped. ``filter`` is an optional CQL2-JSON expression over
6216
+ * the dataset's attribute columns, as the OGC items ``filter`` takes; only the
6217
+ * points it keeps are clustered. An invalid expression responds 400. ``cols``
6218
+ * works as it does on the vector route, and
5623
6219
  * the named columns are projected onto the unclustered features, so
5624
6220
  * data-driven styling and popups keep working here too.
5625
6221
  *
@@ -5679,20 +6275,21 @@ export const clusterTileEndpointTilesClustersTablePathZXYPbfGet = (options) => (
5679
6275
  * default is used in place of the value sent.
5680
6276
  *
5681
6277
  * Responds 204 when the tile falls outside the raster, 400 for an
5682
- * unsupported format, 401 when authentication is required, or when a request
5683
- * that no capability authorized carried a credential which did not resolve,
5684
- * 403 when the embed token is invalid or expired
5685
- * or a multi-tenant request arrives with no tenant context, 422 for an
5686
- * out-of-range stretch parameter, and 503 when the renderer cannot be
5687
- * reached. A different failure from the renderer is passed through with its
5688
- * own status.
6278
+ * unsupported format, 401 when a request that no capability authorized
6279
+ * carried a credential which did not resolve, 403 when the embed token is
6280
+ * invalid or expired or a multi-tenant request arrives with no tenant
6281
+ * context, 422 for an out-of-range stretch parameter, and 503 when the
6282
+ * renderer cannot be reached. A different failure from the renderer is
6283
+ * passed through with its own status.
5689
6284
  *
5690
6285
  * 404 covers more than a missing dataset. A dataset that is unknown, is not a
5691
6286
  * raster or has no image answers 404. Where no capability authorized the
5692
- * request, so does a dataset the caller may not read: an authorization denial
5693
- * on a non-public raster, and an unpublished raster asked for by a caller who
5694
- * is neither its owner nor an admin. That is deliberate, so a refusal keeps a
5695
- * dataset's existence undisclosed.
6287
+ * request, so does a dataset the caller may not read: a non-public raster
6288
+ * asked for anonymously or by a caller without access, and an unpublished
6289
+ * raster asked for by a caller who is neither its owner nor an admin. An
6290
+ * anonymous request whose signature parameters did not authorize gets 403
6291
+ * instead, for a missing dataset as for one it cannot see. Either way a
6292
+ * refusal never discloses that the dataset exists.
5696
6293
  */
5697
6294
  export const rasterTileProxyTilesRasterProxyDatasetIdZXYFmtGet = (options) => (options.client ?? client).get({
5698
6295
  security: [
@@ -5717,8 +6314,9 @@ export const rasterTileProxyTilesRasterProxyDatasetIdZXYFmtGet = (options) => (o
5717
6314
  *
5718
6315
  * Both responses include a discriminated ``kind`` field.
5719
6316
  *
5720
- * Public datasets can be accessed without authentication.
5721
- * Private/restricted datasets require authentication and RBAC checks.
6317
+ * A public, published dataset needs no authentication. Any other dataset
6318
+ * needs a caller with access to it, and answers 404 to everyone else,
6319
+ * anonymous callers included, exactly as an unknown dataset does.
5722
6320
  */
5723
6321
  export const getTileTokenTilesTokenDatasetIdGet = (options) => (options.client ?? client).get({
5724
6322
  security: [