@deepraxis/sdk 0.1.1-dev.da4893e → 0.1.1-dev.df9eeaa

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.
@@ -1144,7 +1144,7 @@ export type OwnFileDeleteFileResponse = {
1144
1144
  };
1145
1145
  export type OwnFilePraxisCreateUpload = {
1146
1146
  /**
1147
- * Exact complete file length in bytes, from 1 through 2147483648 (2 GiB); the sum of completed parts must match.
1147
+ * Exact complete file length in bytes, from 1 through 21474836480 (20 GiB); the sum of completed parts must match.
1148
1148
  */
1149
1149
  bytes: number;
1150
1150
  /**
@@ -1195,7 +1195,7 @@ export type OwnFilePraxisUpload = {
1195
1195
  */
1196
1196
  created_at: number;
1197
1197
  /**
1198
- * Expiry time as Unix seconds; unfinished uploads expire after one hour.
1198
+ * Expiry time as Unix seconds; unfinished uploads expire after 7 days.
1199
1199
  */
1200
1200
  expires_at: number;
1201
1201
  /**
@@ -1207,13 +1207,38 @@ export type OwnFilePraxisUpload = {
1207
1207
  */
1208
1208
  purpose: 'user_data' | 'assistants' | 'vision';
1209
1209
  /**
1210
- * Upload state: pending accepts parts; completed has a file; cancelled was cancelled; expired exceeded its one-hour lifetime.
1210
+ * Upload state: pending accepts parts; completed has a file; cancelled was cancelled; expired exceeded its seven-day lifetime.
1211
1211
  */
1212
1212
  status: 'pending' | 'completed' | 'cancelled' | 'expired';
1213
1213
  /**
1214
1214
  * Present after complete. A file with status uploaded is still processing; poll files.retrieve until processed before use.
1215
1215
  */
1216
1216
  file?: OwnFileOpenAiFile | null;
1217
+ /**
1218
+ * Fixed part length in bytes for a fixed-size upload, or null for a general upload. Send exactly this many bytes per numbered part except for the final remainder.
1219
+ */
1220
+ part_size?: number | null;
1221
+ /**
1222
+ * Parts the upload already holds, in resume order: numbered parts by number, then a general upload's parts by arrival. Query GET /file/v1/uploads/{upload_id} after a break and resend only the numbers missing here.
1223
+ */
1224
+ received_parts?: Array<{
1225
+ /**
1226
+ * Fixed part number, or null for a part of a general upload.
1227
+ */
1228
+ part_number: number | null;
1229
+ /**
1230
+ * Part identifier to pass to complete for this content.
1231
+ */
1232
+ id: string;
1233
+ /**
1234
+ * Accepted length of this part in bytes.
1235
+ */
1236
+ bytes: number;
1237
+ /**
1238
+ * Part content digest prefixed sha256:.
1239
+ */
1240
+ sha256: string;
1241
+ }>;
1217
1242
  /**
1218
1243
  * Declared MIME type, verified during assembly.
1219
1244
  */
@@ -1274,7 +1299,7 @@ export type OwnFileSignedUploadRequest = {
1274
1299
  */
1275
1300
  filename: string;
1276
1301
  /**
1277
- * Exact local file size in bytes, from 1 through 2147483648 (2 GiB). Up to 104857600 bytes returns one PUT URL; larger files return numbered part URLs and a completion URL. Every PUT requires its exact signed Content-Length.
1302
+ * Exact local file size in bytes, from 1 through 21474836480 (20 GiB). Up to 104857600 bytes returns one PUT URL; larger files return numbered part URLs, a completion URL and a status URL. Every PUT requires its exact signed Content-Length.
1278
1303
  */
1279
1304
  bytes: number;
1280
1305
  /**
@@ -1286,7 +1311,7 @@ export type OwnFileSignedUploadRequest = {
1286
1311
  */
1287
1312
  purpose?: 'user_data' | 'assistants' | 'vision';
1288
1313
  /**
1289
- * Lifetime in seconds, from 1 through 604800: defaults to 900 for single PUT or 3600 for multipart. All part URLs and the completion URL share one expiry. This does not set the resulting file's lifetime.
1314
+ * Lifetime in seconds, from 1 through 604800: defaults to 900 for single PUT or 604800 (7 days) for multipart. All part URLs, the status URL and the completion URL share one expiry. This does not set the resulting file's lifetime.
1290
1315
  */
1291
1316
  expires_in?: number;
1292
1317
  /**
@@ -1337,6 +1362,10 @@ export type OwnFileSignedUploadResponse = {
1337
1362
  * Bearer URL to POST without a body after every chunk is acknowledged. Returns 201 with the file object; missing chunks return 400 and successful completion replays return 410 CAPABILITY_USED.
1338
1363
  */
1339
1364
  complete_url: string;
1365
+ /**
1366
+ * Read-only bearer URL for GET that answers the same body as GET /file/v1/uploads/{upload_id}: status, part_size and the received_parts. Use it after a break to resend only the missing chunks; it needs no API key and every write on it is refused.
1367
+ */
1368
+ status_url: string;
1340
1369
  };
1341
1370
  /**
1342
1371
  * Problem document returned by the Meta method catalog on failure.
@@ -10553,7 +10582,7 @@ export type AutomationTrigger = {
10553
10582
  */
10554
10583
  end_at: string | null;
10555
10584
  /**
10556
- * Overlap policy when a firing is due while the previous run is still active: skip (default) skips it, allow starts it anyway.
10585
+ * Overlap policy when a firing arrives while the previous run is still active: skip skips it, allow starts it anyway. When omitted, a schedule trigger uses skip and a webhook trigger uses allow, because a skipped webhook call is not redelivered.
10557
10586
  */
10558
10587
  overlap: AutomationTriggerOverlap;
10559
10588
  /**
@@ -10673,7 +10702,7 @@ export type AutomationTriggerCreateResult = {
10673
10702
  */
10674
10703
  end_at: string | null;
10675
10704
  /**
10676
- * Overlap policy when a firing is due while the previous run is still active: skip (default) skips it, allow starts it anyway.
10705
+ * Overlap policy when a firing arrives while the previous run is still active: skip skips it, allow starts it anyway. When omitted, a schedule trigger uses skip and a webhook trigger uses allow, because a skipped webhook call is not redelivered.
10677
10706
  */
10678
10707
  overlap: AutomationTriggerOverlap;
10679
10708
  /**
@@ -12774,6 +12803,10 @@ export type CutFramesResult = {
12774
12803
  images: {
12775
12804
  [key: string]: CutRenderRef;
12776
12805
  };
12806
+ /**
12807
+ * Frame delivery warnings; empty when every requested source frame was available.
12808
+ */
12809
+ warnings: Array<CutFrameWarning>;
12777
12810
  };
12778
12811
  /**
12779
12812
  * Analysis status and available ranges for each source asset and kind.
@@ -13018,6 +13051,27 @@ export type CutExport = {
13018
13051
  */
13019
13052
  audio: 'pending' | 'done';
13020
13053
  };
13054
+ /**
13055
+ * Present when the export was normalized (the default, or an explicit target); contains the target and the measured output levels. Absent when loudness was null.
13056
+ */
13057
+ loudness?: {
13058
+ /**
13059
+ * Requested integrated loudness target in LUFS.
13060
+ */
13061
+ target_lufs: number;
13062
+ /**
13063
+ * Requested maximum true peak in dBTP.
13064
+ */
13065
+ true_peak_dbtp: number;
13066
+ /**
13067
+ * Measured integrated loudness of the rendered export in LUFS.
13068
+ */
13069
+ integrated_lufs: number;
13070
+ /**
13071
+ * Measured maximum true peak of the rendered export in dBTP.
13072
+ */
13073
+ measured_true_peak_dbtp: number;
13074
+ };
13021
13075
  /**
13022
13076
  * Output media reference, available after the export reaches done.
13023
13077
  */
@@ -13090,6 +13144,19 @@ export type CutExportInput = {
13090
13144
  */
13091
13145
  binding?: string;
13092
13146
  revision?: CutRevision;
13147
+ /**
13148
+ * Loudness normalization target. Omitted, the export is normalized to -14 LUFS integrated and -1 dBTP true peak, the level short-video and streaming platforms play at; null renders without normalization. Normalization adds analysis and rendering work.
13149
+ */
13150
+ loudness?: {
13151
+ /**
13152
+ * Integrated loudness target in LUFS.
13153
+ */
13154
+ target_lufs: number;
13155
+ /**
13156
+ * Maximum true peak in dBTP.
13157
+ */
13158
+ true_peak_dbtp: number;
13159
+ } | null;
13093
13160
  };
13094
13161
  /**
13095
13162
  * One page of organization-accessible exports.
@@ -14142,7 +14209,7 @@ export type MediaLibrary = {
14142
14209
  };
14143
14210
  export type MediaMediaError = {
14144
14211
  error: {
14145
- code: 'LIBRARY_NOT_FOUND' | 'ASSET_NOT_FOUND' | 'JOB_NOT_FOUND' | 'UNDERSTANDING_NOT_FOUND' | 'ASSET_VERSION_CHANGED' | 'LIBRARY_INVALID_STATE' | 'INVALID_PARAMS' | 'INVALID_EXPRESSION' | 'UNSUPPORTED' | 'NOT_IMPLEMENTED' | 'FILE_TOO_LARGE' | 'FILE_EMPTY' | 'UNSUPPORTED_MEDIA' | 'FETCH_FAILED' | 'LIMIT_EXCEEDED' | 'CHUNK_INVALID' | 'RATE_LIMITED' | 'CAPACITY' | 'UPSTREAM_FAILED' | 'BINDING_READ_ONLY';
14212
+ code: 'LIBRARY_NOT_FOUND' | 'ASSET_NOT_FOUND' | 'JOB_NOT_FOUND' | 'UNDERSTANDING_NOT_FOUND' | 'ASSET_VERSION_CHANGED' | 'LIBRARY_INVALID_STATE' | 'INVALID_PARAMS' | 'INVALID_EXPRESSION' | 'UNSUPPORTED' | 'NOT_IMPLEMENTED' | 'FILE_TOO_LARGE' | 'FILE_EMPTY' | 'UNSUPPORTED_MEDIA' | 'FETCH_FAILED' | 'LIMIT_EXCEEDED' | 'CHUNK_INVALID' | 'RATE_LIMITED' | 'CAPACITY' | 'UPSTREAM_FAILED' | 'CONTENT_REJECTED' | 'GENERATION_FAILED' | 'CANDIDATE_EXPIRED' | 'BINDING_READ_ONLY';
14146
14213
  message: string;
14147
14214
  details: string | null;
14148
14215
  };
@@ -14394,6 +14461,10 @@ export type MediaAsset = {
14394
14461
  * Resource status; active identifies an asset that has not been deleted.
14395
14462
  */
14396
14463
  status: 'active';
14464
+ /**
14465
+ * True when the source header declares an alpha channel: a PNG color type 4 or 6 or a tRNS chunk, a WebP VP8X alpha flag or VP8L alpha bit, a WebM or MKV video track AlphaMode of 1, or a GIF transparent-color flag. False when a known container has no alpha channel. Omitted when the format is unknown, the header could not be parsed, or the asset was stored before this field existed; absence does not mean the source is opaque.
14466
+ */
14467
+ has_alpha?: boolean;
14397
14468
  /**
14398
14469
  * Search-vector status: pending awaits vector generation or reprocessing; ready has searchable vectors; unavailable indicates disabled, unsupported or failed embedding. Existing vectors may still serve searches while reprocessing is pending.
14399
14470
  */
@@ -14450,6 +14521,27 @@ export type MediaAsset = {
14450
14521
  };
14451
14522
  };
14452
14523
  };
14524
+ /**
14525
+ * Source details for the video-generation job that created this asset.
14526
+ */
14527
+ generation?: {
14528
+ /**
14529
+ * Job id that generated this asset.
14530
+ */
14531
+ job_id: MediaJobId;
14532
+ /**
14533
+ * Generation intent used to create the asset; v1 supports video.generate.
14534
+ */
14535
+ intent: string;
14536
+ /**
14537
+ * Text prompt submitted for the generation job.
14538
+ */
14539
+ prompt: string;
14540
+ /**
14541
+ * Router video-generation model that produced the asset.
14542
+ */
14543
+ model: string;
14544
+ };
14453
14545
  };
14454
14546
  /**
14455
14547
  * Receipt confirming that the asset was deleted.
@@ -14592,11 +14684,11 @@ export type MediaJob = {
14592
14684
  /**
14593
14685
  * Batch operation: tag adds labels, untag removes labels, set_context replaces custom metadata, move changes asset_folder, and delete removes selected assets. reprocess starts fenced understanding Workflows for retryable failed steps and legacy source-size unsupported steps; kinds narrows the selection. Other unsupported and permanent steps remain unchanged.
14594
14686
  */
14595
- action: 'tag' | 'untag' | 'set_context' | 'move' | 'delete' | 'reprocess';
14687
+ action: 'tag' | 'untag' | 'set_context' | 'move' | 'delete' | 'reprocess' | 'generate';
14596
14688
  /**
14597
14689
  * Job status: queued awaits execution; running is processing items; completed means all items succeeded; completed_with_errors means some succeeded and some failed; failed means all selected items failed. An empty job completes successfully.
14598
14690
  */
14599
- status: 'queued' | 'running' | 'completed' | 'completed_with_errors' | 'failed';
14691
+ status: MediaJobStatus;
14600
14692
  /**
14601
14693
  * Number of distinct assets selected when the job was created.
14602
14694
  */
@@ -14616,12 +14708,66 @@ export type MediaJob = {
14616
14708
  /**
14617
14709
  * Identifier supplied for the failed item; it may identify a missing asset.
14618
14710
  */
14619
- asset_id: MediaAssetId;
14711
+ asset_id?: MediaAssetId;
14712
+ /**
14713
+ * Zero-based output index for a failed video-generation item.
14714
+ */
14715
+ index?: number;
14620
14716
  /**
14621
14717
  * Domain error code explaining the individual item failure.
14622
14718
  */
14623
14719
  code: MediaMediaErrorCode;
14624
14720
  }>;
14721
+ /**
14722
+ * Generation intent used by this job; v1 supports video.generate.
14723
+ */
14724
+ intent?: string;
14725
+ /**
14726
+ * Router video-generation model used for the outputs.
14727
+ */
14728
+ model?: string;
14729
+ /**
14730
+ * Per-video results in index order; save a successful candidate before expires_at.
14731
+ */
14732
+ outputs?: Array<{
14733
+ /**
14734
+ * Zero-based position of this video in the requested count.
14735
+ */
14736
+ index: number;
14737
+ /**
14738
+ * State of this requested video output.
14739
+ */
14740
+ status: MediaGenerationOutputStatus;
14741
+ /**
14742
+ * Short-lived signed URL for previewing this candidate; read the Job again to obtain a fresh URL.
14743
+ */
14744
+ preview_url?: string;
14745
+ /**
14746
+ * Router seed for this video, when returned; it may be absent.
14747
+ */
14748
+ seed?: number | null;
14749
+ /**
14750
+ * Candidate expiry time; after expiry, save returns CANDIDATE_EXPIRED.
14751
+ */
14752
+ expires_at?: MediaIsoTimestamp;
14753
+ /**
14754
+ * Library asset identifier after this candidate has been saved, or when the job requested save=library.
14755
+ */
14756
+ asset_id?: MediaAssetId;
14757
+ }>;
14758
+ /**
14759
+ * Router-reported generation charge for the job.
14760
+ */
14761
+ usage?: {
14762
+ /**
14763
+ * Decimal amount in the currency named by currency; this is not a floating-point value.
14764
+ */
14765
+ amount: string;
14766
+ /**
14767
+ * Currency code for amount.
14768
+ */
14769
+ currency: string;
14770
+ };
14625
14771
  /**
14626
14772
  * Time the batch job was created, in UTC.
14627
14773
  */
@@ -14736,6 +14882,524 @@ export type MediaFailureSummary = {
14736
14882
  */
14737
14883
  counts_complete: boolean;
14738
14884
  };
14885
+ /**
14886
+ * Current state of a batch or video-generation job.
14887
+ */
14888
+ export type MediaJobStatus = 'queued' | 'running' | 'completed' | 'completed_with_errors' | 'failed' | 'cancelled';
14889
+ /**
14890
+ * Identifier returned when a batch job is created.
14891
+ */
14892
+ export type MediaJobId = string;
14893
+ /**
14894
+ * A page of jobs in a library.
14895
+ */
14896
+ export type MediaJobPage = {
14897
+ /**
14898
+ * Jobs returned in this page.
14899
+ */
14900
+ data: Array<MediaJob>;
14901
+ /**
14902
+ * Cursor for the next page, or null when there are no more jobs.
14903
+ */
14904
+ next_cursor: MediaJobId | null;
14905
+ };
14906
+ /**
14907
+ * Current text-to-video options, concurrency and candidate retention. Generation is charged per second; unsaved candidates expire after 7 days.
14908
+ */
14909
+ export type MediaGenerationCapabilities = {
14910
+ /**
14911
+ * Text-to-video intents currently supported by Media.
14912
+ */
14913
+ intents: Array<string>;
14914
+ /**
14915
+ * Model selected when model is omitted from a generation request.
14916
+ */
14917
+ default_model: string;
14918
+ /**
14919
+ * Allowed number of videos per generation job.
14920
+ */
14921
+ count: {
14922
+ /**
14923
+ * Minimum number of videos in one generation job.
14924
+ */
14925
+ minimum: number;
14926
+ /**
14927
+ * Maximum number of videos in one generation job.
14928
+ */
14929
+ maximum: number;
14930
+ };
14931
+ /**
14932
+ * Durations in seconds supported by the default video model.
14933
+ */
14934
+ duration_seconds: Array<number>;
14935
+ /**
14936
+ * Aspect ratios supported by the default video model.
14937
+ */
14938
+ aspect_ratios: Array<string>;
14939
+ /**
14940
+ * Aspect ratio used when aspect_ratio is omitted.
14941
+ */
14942
+ default_aspect_ratio: string;
14943
+ /**
14944
+ * Maximum number of queued or running generation jobs per library.
14945
+ */
14946
+ concurrency_per_library: number;
14947
+ /**
14948
+ * Unit used to charge video generation; generated duration is billed per second by Router.
14949
+ */
14950
+ price_unit: 'per second';
14951
+ /**
14952
+ * Days an unsaved candidate is retained before its File is deleted.
14953
+ */
14954
+ candidate_retention_days: number;
14955
+ };
14956
+ /**
14957
+ * One page of type registrations; types are few enough that this face returns them in a single page.
14958
+ */
14959
+ export type OntologyTypeRegistrationPage = {
14960
+ /**
14961
+ * The registrations in force for this organization.
14962
+ */
14963
+ data: Array<OntologyTypeRegistration>;
14964
+ /**
14965
+ * Always null here; the field is present so every list on this face has the same shape.
14966
+ */
14967
+ next_cursor: string;
14968
+ };
14969
+ /**
14970
+ * One service's registered types for this organization, as shipped by that service and stored by the deploy gate.
14971
+ */
14972
+ export type OntologyTypeRegistration = {
14973
+ /**
14974
+ * Service that registered these types, for example file or ticket; it is the registrant a later change to a type is checked against.
14975
+ */
14976
+ owner: string;
14977
+ /**
14978
+ * Monotonic version of this owner's registration; a later registration must extend this one without removing or narrowing anything.
14979
+ */
14980
+ version: number;
14981
+ /**
14982
+ * Node types this owner registers.
14983
+ */
14984
+ nodes: Array<OntologyNodeType>;
14985
+ /**
14986
+ * Relation types this owner registers.
14987
+ */
14988
+ edges: Array<OntologyEdgeType>;
14989
+ };
14990
+ export type OntologyOntologyError = {
14991
+ /**
14992
+ * Failure details for a non-2xx response; choose a recovery action using the operation's status and code description.
14993
+ */
14994
+ error: {
14995
+ /**
14996
+ * Machine-readable failure category; see this operation's error responses for triggering conditions and recovery actions.
14997
+ */
14998
+ code: string;
14999
+ /**
15000
+ * Human-readable explanation of why the request failed; it names the offending field or condition and the action to take.
15001
+ */
15002
+ message: string;
15003
+ /**
15004
+ * Optional error-specific context, present when the failure names particular items; absent for failures that concern the request as a whole.
15005
+ */
15006
+ details?: {
15007
+ [key: string]: unknown;
15008
+ };
15009
+ };
15010
+ };
15011
+ /**
15012
+ * One registered type, with the registration it belongs to and whether it is a node or a relation type.
15013
+ */
15014
+ export type OntologyTypeLookup = {
15015
+ /**
15016
+ * Service that registered this type; a change to the type is checked against that registrant.
15017
+ */
15018
+ owner: string;
15019
+ /**
15020
+ * Version of the registration this type came from, so a caller can tell when a definition moved on.
15021
+ */
15022
+ version: number;
15023
+ /**
15024
+ * Whether the type describes an entity or a fact, which decides whether it is used when creating a node or a relation.
15025
+ */
15026
+ kind: 'node' | 'edge';
15027
+ /**
15028
+ * The full registered definition — the same object as the entry in its registration's nodes or edges array.
15029
+ */
15030
+ definition: {
15031
+ [key: string]: unknown;
15032
+ };
15033
+ };
15034
+ /**
15035
+ * One page of nodes; a restricted entry carries only id, type, name and restricted.
15036
+ */
15037
+ export type OntologyNodePage = {
15038
+ /**
15039
+ * The nodes on this page, ordered by node id.
15040
+ */
15041
+ data: Array<OntologyNode | OntologyRestrictedNode>;
15042
+ /**
15043
+ * Opaque cursor for the next page, or null when this is the last page; copy it into the next request's cursor unchanged.
15044
+ */
15045
+ next_cursor: string;
15046
+ };
15047
+ /**
15048
+ * The entity to record; type must be registered and ref must match that type's prefix.
15049
+ */
15050
+ export type OntologyCreateNodeInput = {
15051
+ /**
15052
+ * Registered node type name from types.list; an unregistered name is refused and nothing is written.
15053
+ */
15054
+ type: string;
15055
+ /**
15056
+ * Id of the mirrored record in the owning service, which must start with the type's ref_prefix; omit or null for a concept with no external record.
15057
+ */
15058
+ ref?: string;
15059
+ /**
15060
+ * Display name of the entity, at most 200 characters.
15061
+ */
15062
+ name: string;
15063
+ /**
15064
+ * Other names this entity is known by; they are matched by search alongside the name.
15065
+ */
15066
+ aliases?: Array<string>;
15067
+ /**
15068
+ * Profile of the entity, at most 500 characters; omit or null for none.
15069
+ */
15070
+ description?: string;
15071
+ /**
15072
+ * Member id whose content this is, restricting it to that member; omit or null to make it readable organization-wide.
15073
+ */
15074
+ owner?: string;
15075
+ };
15076
+ /**
15077
+ * One entity in the graph, with when it was recorded and last changed.
15078
+ */
15079
+ export type OntologyNode = {
15080
+ /**
15081
+ * Node id, used by relations, merges and later reads; treat it as opaque and do not parse it.
15082
+ */
15083
+ id: string;
15084
+ /**
15085
+ * Registered node type this entity was recorded as; it never changes after creation.
15086
+ */
15087
+ type: string;
15088
+ /**
15089
+ * Id of the mirrored record in the service that owns it, matching the type's ref_prefix; null for a concept with no external record.
15090
+ */
15091
+ ref?: string;
15092
+ /**
15093
+ * Display name of the entity, at most 200 characters.
15094
+ */
15095
+ name: string;
15096
+ /**
15097
+ * Other names this entity is known by; they are matched by search alongside the name.
15098
+ */
15099
+ aliases: Array<string>;
15100
+ /**
15101
+ * Profile of the entity, at most 500 characters; null when none was recorded.
15102
+ */
15103
+ description?: string;
15104
+ /**
15105
+ * Member id whose content this is; null means it is readable organization-wide. Another member's node comes back restricted.
15106
+ */
15107
+ owner: string;
15108
+ /**
15109
+ * When this node was merged into another, that survivor's id; reads of a merged node resolve to the survivor.
15110
+ */
15111
+ merged_into?: string;
15112
+ /**
15113
+ * System time when the node was first recorded, in ISO 8601 UTC.
15114
+ */
15115
+ created_at: string;
15116
+ /**
15117
+ * System time of the last change to this node's content, in ISO 8601 UTC.
15118
+ */
15119
+ updated_at: string;
15120
+ /**
15121
+ * System time the mirrored record was deleted, when that is known; kept so history stays answerable.
15122
+ */
15123
+ deleted_at?: string;
15124
+ };
15125
+ export type OntologyNodeWithRelations = OntologyNode & {
15126
+ /**
15127
+ * Relations on and around this node that the caller may read, ordered by relation id; present only when expand=relations was sent.
15128
+ */
15129
+ relations?: Array<OntologyRelation>;
15130
+ };
15131
+ /**
15132
+ * The fields to change; omitted fields keep their current values.
15133
+ */
15134
+ export type OntologyUpdateNodeInput = {
15135
+ /**
15136
+ * New display name, at most 200 characters; omit to keep the current name.
15137
+ */
15138
+ name?: string;
15139
+ /**
15140
+ * Replacement alias list; an empty array clears the aliases and omitting the field keeps them.
15141
+ */
15142
+ aliases?: Array<string>;
15143
+ /**
15144
+ * Replacement profile, at most 500 characters; an explicit null clears it and omitting the field keeps it.
15145
+ */
15146
+ description?: string;
15147
+ };
15148
+ /**
15149
+ * The survivor the merged node folds into.
15150
+ */
15151
+ export type OntologyMergeNodeInput = {
15152
+ /**
15153
+ * Node id that should survive, from nodes.list or search; the merged node's relations and aliases move to it.
15154
+ */
15155
+ into: string;
15156
+ };
15157
+ /**
15158
+ * One page of relations.
15159
+ */
15160
+ export type OntologyRelationPage = {
15161
+ /**
15162
+ * The relations on this page, ordered by relation id.
15163
+ */
15164
+ data: Array<OntologyRelation>;
15165
+ /**
15166
+ * Opaque cursor for the next page, or null when this is the last page; copy it into the next request's cursor unchanged.
15167
+ */
15168
+ next_cursor: string;
15169
+ };
15170
+ /**
15171
+ * The fact to record between two existing nodes of this organization.
15172
+ */
15173
+ export type OntologyCreateRelationInput = {
15174
+ /**
15175
+ * Registered relation type name from types.list; it must admit both endpoints or the write is refused.
15176
+ */
15177
+ type: string;
15178
+ /**
15179
+ * Node id the fact starts from, from nodes.list or nodes.create.
15180
+ */
15181
+ source: string;
15182
+ /**
15183
+ * Node id the fact points at, from nodes.list or nodes.create.
15184
+ */
15185
+ target: string;
15186
+ /**
15187
+ * The relationship in one sentence, at most 280 characters, written to read back on its own.
15188
+ */
15189
+ fact: string;
15190
+ /**
15191
+ * World time the fact became true, when the mirrored record dates it; omit to leave it undated.
15192
+ */
15193
+ valid_at?: string;
15194
+ /**
15195
+ * Member id whose content this fact is, restricting it to that member; omit or null for organization-wide.
15196
+ */
15197
+ owner?: string;
15198
+ };
15199
+ /**
15200
+ * One fact between two nodes, with two clocks — when it was true in the world and when it was recorded.
15201
+ */
15202
+ export type OntologyRelation = {
15203
+ /**
15204
+ * Relation id, used by invalidation and later reads; treat it as opaque and do not parse it.
15205
+ */
15206
+ id: string;
15207
+ /**
15208
+ * Registered relation type this fact was recorded as; it must admit both endpoints.
15209
+ */
15210
+ type: string;
15211
+ /**
15212
+ * Node id the fact starts from.
15213
+ */
15214
+ source: string;
15215
+ /**
15216
+ * Node id the fact points at.
15217
+ */
15218
+ target: string;
15219
+ /**
15220
+ * The relationship in one sentence, at most 280 characters, as it should be read back.
15221
+ */
15222
+ fact: string;
15223
+ /**
15224
+ * Where this fact was learned, oldest first; each entry names the scope it came from and an optional time range.
15225
+ */
15226
+ episodes?: Array<{
15227
+ /**
15228
+ * Scope the experience belonged to, normally a session id.
15229
+ */
15230
+ scope?: string;
15231
+ /**
15232
+ * Start of the period the experience covered, when known; omit for a single moment.
15233
+ */
15234
+ from?: string;
15235
+ /**
15236
+ * End of the period the experience covered, when known; omit for a single moment.
15237
+ */
15238
+ to?: string;
15239
+ }>;
15240
+ /**
15241
+ * Where the fact came from; the relation type must list this origin among the ones it accepts.
15242
+ */
15243
+ origin: 'platform' | 'stated' | 'observed' | 'inferred';
15244
+ /**
15245
+ * How strongly the fact is held, from 0 to 1; 1 is fully held and lower values fade faster.
15246
+ */
15247
+ confidence: number;
15248
+ /**
15249
+ * Member id whose content this fact is; null means it is readable organization-wide. Another member's relation reads as not found.
15250
+ */
15251
+ owner?: string;
15252
+ /**
15253
+ * World time the fact became true; null when it was never dated, in which case treat it as true since it was recorded.
15254
+ */
15255
+ valid_at?: string;
15256
+ /**
15257
+ * World time the fact stopped being true; null while it still holds. The relation is kept and reads at an earlier as_of.
15258
+ */
15259
+ invalid_at?: string;
15260
+ /**
15261
+ * System time the fact was recorded, in ISO 8601 UTC.
15262
+ */
15263
+ created_at: string;
15264
+ /**
15265
+ * System time the fact was judged no longer true, which trails invalid_at; null while it still holds.
15266
+ */
15267
+ expired_at?: string;
15268
+ /**
15269
+ * Relation id that replaced this one, when the invalidation named a successor; null when nothing replaced it.
15270
+ */
15271
+ superseded_by?: string;
15272
+ /**
15273
+ * System time the fact was archived out of spreading; null while it still spreads, and reads by time still reach it either way.
15274
+ */
15275
+ archived_at?: string;
15276
+ };
15277
+ /**
15278
+ * When the fact stopped being true, and optionally what replaced it.
15279
+ */
15280
+ export type OntologyInvalidateRelationInput = {
15281
+ /**
15282
+ * World time the fact stopped being true, in ISO 8601 UTC; reads at an earlier as_of still return the relation.
15283
+ */
15284
+ invalid_at: string;
15285
+ /**
15286
+ * Relation id that replaces this one, when a successor was recorded; omit or null when nothing replaced it.
15287
+ */
15288
+ superseded_by?: string;
15289
+ /**
15290
+ * Why it stopped being true, for people reading the history later; not enforced and safe to omit.
15291
+ */
15292
+ reason?: string;
15293
+ };
15294
+ /**
15295
+ * A batch of graph operations applied as one transaction; every operation succeeds or none is applied.
15296
+ */
15297
+ export type OntologyChangesetInput = {
15298
+ /**
15299
+ * World time the batch describes, in ISO 8601 UTC; operations without their own time are dated by it.
15300
+ */
15301
+ at: string;
15302
+ /**
15303
+ * Scope the batch came from, normally the session id it was observed in; it is stored with the operations for later reading.
15304
+ */
15305
+ scope?: string;
15306
+ /**
15307
+ * At most 500 operations, applied in order; each names its kind in op and the fields that kind requires.
15308
+ */
15309
+ ops: Array<OntologyChangesetOp>;
15310
+ };
15311
+ /**
15312
+ * What the batch did, including the ids it assigned and anything it refused.
15313
+ */
15314
+ export type OntologyChangesetResult = {
15315
+ /**
15316
+ * Number of operations that changed the graph; zero when the key had been seen before.
15317
+ */
15318
+ applied: number;
15319
+ /**
15320
+ * Map from each key used in the batch to the node or relation id it produced or matched.
15321
+ */
15322
+ ids: {
15323
+ [key: string]: string;
15324
+ };
15325
+ /**
15326
+ * Relations that already held the same meaning and were refreshed instead of duplicated.
15327
+ */
15328
+ refreshed: Array<string>;
15329
+ /**
15330
+ * Operations refused within the batch, each with its index and reason; empty when the batch applied whole.
15331
+ */
15332
+ rejected: Array<{
15333
+ /**
15334
+ * Zero-based position of the operation in the submitted ops array.
15335
+ */
15336
+ index?: number;
15337
+ /**
15338
+ * Failure category for this operation, such as ONTOLOGY_TYPE_UNKNOWN for an unregistered type.
15339
+ */
15340
+ code?: string;
15341
+ /**
15342
+ * Why this operation was refused, naming the offending field.
15343
+ */
15344
+ message?: string;
15345
+ }>;
15346
+ /**
15347
+ * True when the Idempotency-Key had been seen before, so nothing changed and the first result is returned.
15348
+ */
15349
+ replayed: boolean;
15350
+ };
15351
+ /**
15352
+ * The text to resolve, optionally narrowed to types and a result count.
15353
+ */
15354
+ export type OntologySearchInput = {
15355
+ /**
15356
+ * Text to find nodes for, matched against names, aliases, descriptions and relation facts; an empty string is refused.
15357
+ */
15358
+ text: string;
15359
+ /**
15360
+ * Registered node type names to search within; omit to search every type.
15361
+ */
15362
+ types?: Array<string>;
15363
+ /**
15364
+ * Restrict matches to facts recorded within a period; omit to search all time.
15365
+ */
15366
+ window?: {
15367
+ /**
15368
+ * Start of the period, inclusive, in ISO 8601 UTC; omit to leave the start open.
15369
+ */
15370
+ from?: string;
15371
+ /**
15372
+ * End of the period, exclusive, in ISO 8601 UTC; omit to leave the end open.
15373
+ */
15374
+ to?: string;
15375
+ };
15376
+ /**
15377
+ * Maximum candidate nodes to return, from 1 to 50; defaults to 20 when omitted.
15378
+ */
15379
+ limit?: number;
15380
+ };
15381
+ /**
15382
+ * Ranked candidate nodes for the searched text, best match first.
15383
+ */
15384
+ export type OntologySearchResult = {
15385
+ /**
15386
+ * The candidate nodes, strongest match first; an empty array means nothing matched.
15387
+ */
15388
+ hits: Array<{
15389
+ /**
15390
+ * Node id of the candidate; pass it to nodes.retrieve to confirm before writing with it.
15391
+ */
15392
+ node?: string;
15393
+ /**
15394
+ * Match strength from 0 to 1; compare candidates within one response rather than across queries.
15395
+ */
15396
+ score?: number;
15397
+ /**
15398
+ * Which field matched, so a weak fact match can be checked against the node itself.
15399
+ */
15400
+ matched?: 'name' | 'alias' | 'description' | 'fact';
15401
+ }>;
15402
+ };
14739
15403
  /**
14740
15404
  * Sandbox creation request. All system communication with the sandbox is always secured; the template's envd version must support secured access.
14741
15405
  */
@@ -15178,6 +15842,10 @@ export type SandboxTemplateBuildInfo = {
15178
15842
  reason?: SandboxBuildStatusReason;
15179
15843
  };
15180
15844
  export type SandboxTemplateWithBuilds = {
15845
+ /**
15846
+ * Lifecycle classes this template can run as. ephemeral: cannot pause, snapshot or mount volumes and is deleted when it stops; persistent: can pause, resume and snapshot.
15847
+ */
15848
+ lifecycles?: Array<'ephemeral' | 'persistent'>;
15181
15849
  /**
15182
15850
  * Identifier of the template
15183
15851
  */
@@ -25182,6 +25850,20 @@ export type CutTrackSummary = {
25182
25850
  */
25183
25851
  items: number;
25184
25852
  };
25853
+ export type CutFrameWarning = {
25854
+ /**
25855
+ * FRAME_UNAVAILABLE means a source image could not be fetched for this preview.
25856
+ */
25857
+ code: 'FRAME_UNAVAILABLE';
25858
+ /**
25859
+ * Identifier of the clip whose source frame could not be fetched.
25860
+ */
25861
+ clip_id?: string;
25862
+ /**
25863
+ * Actionable safe explanation; source URLs and credentials are omitted.
25864
+ */
25865
+ message: string;
25866
+ };
25185
25867
  /**
25186
25868
  * Reference to an asset in a bound library; follows asset overwrites to the latest version rather than pinning a version.
25187
25869
  */
@@ -25216,9 +25898,9 @@ export type CutExportOutput = {
25216
25898
  */
25217
25899
  fps?: number;
25218
25900
  /**
25219
- * draft favors faster review renders; high favors final delivery quality.
25901
+ * Compression of the encoded video, like Shotstack quality. medium is the default and balances render, upload and storage at about 70% of the bitrate of high. draft is about 40% of high, for review renders. high is for delivery that will be transcoded again or needs the most detail.
25220
25902
  */
25221
- quality?: 'draft' | 'high';
25903
+ quality?: 'draft' | 'medium' | 'high';
25222
25904
  };
25223
25905
  export type DatabaseField = {
25224
25906
  /**
@@ -25404,7 +26086,7 @@ export type KnowledgeKnowledgeModels = {
25404
26086
  */
25405
26087
  query_rewrite: string;
25406
26088
  /**
25407
- * Extracts text from scanned PDF pages. Default: glm-ocr, falling back to qwen3.8-flash. A custom model precedes the platform defaults.
26089
+ * Extracts text from scanned PDF pages through the OCR API. Default: qwen-vl-ocr-2025-11-20, falling back to glm-ocr and qwen3.8-flash. A custom model precedes these defaults. OCR is billed by pages processed.
25408
26090
  */
25409
26091
  ocr: string;
25410
26092
  /**
@@ -25433,7 +26115,7 @@ export type KnowledgeKnowledgeModelsInput = {
25433
26115
  */
25434
26116
  query_rewrite?: string | null;
25435
26117
  /**
25436
- * Scanned PDF text extraction model; requires mistral.ocr or pdf_input capability. null restores glm-ocr. The preference leads the fallback chain glm-ocr, qwen3.8-flash with duplicates removed.
26118
+ * Scanned PDF text extraction model; requires mistral.ocr or pdf_input capability. null restores qwen-vl-ocr-2025-11-20. The preference leads the OCR API fallback chain qwen-vl-ocr-2025-11-20, glm-ocr, qwen3.8-flash with duplicates removed.
25437
26119
  */
25438
26120
  ocr?: string | null;
25439
26121
  /**
@@ -25874,7 +26556,7 @@ export type MediaChunkComplete = MediaCloudinaryResource & {
25874
26556
  done: true;
25875
26557
  };
25876
26558
  /**
25877
- * Per-task processing progress and its aggregate state for the asset. For understanding, Media generates proxies for video sources of 25 MB or more and audio-only sources of 100 MB or more; originals remain available unchanged. The duration limit is 10 minutes. A video proxy still above 95 MB after recompression, or a source exceeding the duration limit, is reported as UNSUPPORTED with the limit in the failure message. Proxy preparation uses the organization’s metered sandbox resources.
26559
+ * Per-task processing progress and its aggregate state for the asset. For understanding, Media generates proxies for video sources of 25 MB or more or longer than 10 minutes, and for audio-only sources of 100 MB or more; originals remain available unchanged. Long videos are supported. When a video proxy is needed and is still above 95 MB after recompression, the source is reported as UNSUPPORTED with the limit in the failure message. Proxy preparation uses the organization’s metered sandbox resources.
25878
26560
  */
25879
26561
  export type MediaProcessing = {
25880
26562
  /**
@@ -26174,6 +26856,10 @@ export type MediaSearchAsset = {
26174
26856
  * Resource status; active identifies an asset that has not been deleted.
26175
26857
  */
26176
26858
  status: 'active';
26859
+ /**
26860
+ * True when the source header declares an alpha channel: a PNG color type 4 or 6 or a tRNS chunk, a WebP VP8X alpha flag or VP8L alpha bit, a WebM or MKV video track AlphaMode of 1, or a GIF transparent-color flag. False when a known container has no alpha channel. Omitted when the format is unknown, the header could not be parsed, or the asset was stored before this field existed; absence does not mean the source is opaque.
26861
+ */
26862
+ has_alpha?: boolean;
26177
26863
  /**
26178
26864
  * Search-vector status: pending awaits vector generation or reprocessing; ready has searchable vectors; unavailable indicates disabled, unsupported or failed embedding. Existing vectors may still serve searches while reprocessing is pending.
26179
26865
  */
@@ -26230,6 +26916,27 @@ export type MediaSearchAsset = {
26230
26916
  };
26231
26917
  };
26232
26918
  };
26919
+ /**
26920
+ * Source details for the video-generation job that created this asset.
26921
+ */
26922
+ generation?: {
26923
+ /**
26924
+ * Job id that generated this asset.
26925
+ */
26926
+ job_id: MediaJobId;
26927
+ /**
26928
+ * Generation intent used to create the asset; v1 supports video.generate.
26929
+ */
26930
+ intent: string;
26931
+ /**
26932
+ * Text prompt submitted for the generation job.
26933
+ */
26934
+ prompt: string;
26935
+ /**
26936
+ * Router video-generation model that produced the asset.
26937
+ */
26938
+ model: string;
26939
+ };
26233
26940
  };
26234
26941
  /**
26235
26942
  * A matching asset with its ranking score and supporting matches.
@@ -26252,11 +26959,11 @@ export type MediaSemanticHit = {
26252
26959
  */
26253
26960
  matches: Array<MediaSemanticMatch>;
26254
26961
  };
26962
+ export type MediaMediaErrorCode = 'LIBRARY_NOT_FOUND' | 'ASSET_NOT_FOUND' | 'JOB_NOT_FOUND' | 'UNDERSTANDING_NOT_FOUND' | 'ASSET_VERSION_CHANGED' | 'LIBRARY_INVALID_STATE' | 'INVALID_PARAMS' | 'INVALID_EXPRESSION' | 'UNSUPPORTED' | 'NOT_IMPLEMENTED' | 'FILE_TOO_LARGE' | 'FILE_EMPTY' | 'UNSUPPORTED_MEDIA' | 'FETCH_FAILED' | 'LIMIT_EXCEEDED' | 'CHUNK_INVALID' | 'RATE_LIMITED' | 'CAPACITY' | 'UPSTREAM_FAILED' | 'CONTENT_REJECTED' | 'GENERATION_FAILED' | 'CANDIDATE_EXPIRED' | 'BINDING_READ_ONLY';
26255
26963
  /**
26256
- * Identifier returned when a batch job is created.
26964
+ * State of a requested video output.
26257
26965
  */
26258
- export type MediaJobId = string;
26259
- export type MediaMediaErrorCode = 'LIBRARY_NOT_FOUND' | 'ASSET_NOT_FOUND' | 'JOB_NOT_FOUND' | 'UNDERSTANDING_NOT_FOUND' | 'ASSET_VERSION_CHANGED' | 'LIBRARY_INVALID_STATE' | 'INVALID_PARAMS' | 'INVALID_EXPRESSION' | 'UNSUPPORTED' | 'NOT_IMPLEMENTED' | 'FILE_TOO_LARGE' | 'FILE_EMPTY' | 'UNSUPPORTED_MEDIA' | 'FETCH_FAILED' | 'LIMIT_EXCEEDED' | 'CHUNK_INVALID' | 'RATE_LIMITED' | 'CAPACITY' | 'UPSTREAM_FAILED' | 'BINDING_READ_ONLY';
26966
+ export type MediaGenerationOutputStatus = 'pending' | 'succeeded' | 'failed';
26260
26967
  /**
26261
26968
  * A recorded library event with a monotonically increasing sequence within that library.
26262
26969
  */
@@ -26330,6 +27037,170 @@ export type MediaFailureGroup = {
26330
27037
  */
26331
27038
  sample_asset_ids: Array<MediaAssetId>;
26332
27039
  };
27040
+ /**
27041
+ * A kind of entity the graph accepts, for example a file or a customer.
27042
+ */
27043
+ export type OntologyNodeType = {
27044
+ /**
27045
+ * Globally unique type name, used as a node's type when creating it; a dotted name marks a namespaced subtype.
27046
+ */
27047
+ name: string;
27048
+ /**
27049
+ * Required prefix of the external record id when a node of this type carries a ref, for example file_ for the file type; omit for types that are pure concepts.
27050
+ */
27051
+ ref_prefix?: string;
27052
+ /**
27053
+ * Type significance from 0 to 1, used when ranking how strongly reaching this kind of node matters.
27054
+ */
27055
+ weight: number;
27056
+ /**
27057
+ * Whether the graph may continue through a node of this type; false makes it a stopping point that is reached but never expanded.
27058
+ */
27059
+ passable: boolean;
27060
+ /**
27061
+ * What this type means in the registering service, used to choose the right type when writing.
27062
+ */
27063
+ description: string;
27064
+ };
27065
+ /**
27066
+ * A kind of fact the graph accepts between two nodes.
27067
+ */
27068
+ export type OntologyEdgeType = {
27069
+ /**
27070
+ * Globally unique relation type name, used as a relation's type when creating it.
27071
+ */
27072
+ name: string;
27073
+ /**
27074
+ * Node type names this relation may start from; the single entry * admits every type.
27075
+ */
27076
+ source: Array<string>;
27077
+ /**
27078
+ * Node type names this relation may point at; the single entry * admits every type.
27079
+ */
27080
+ target: Array<string>;
27081
+ /**
27082
+ * Whether the fact reads one way or the same in both directions, which decides how it renders on each endpoint.
27083
+ */
27084
+ direction: 'forward' | 'both';
27085
+ /**
27086
+ * Whether spreading may continue through this relation; false makes it a stopping point that is reached but never traversed.
27087
+ */
27088
+ passable: boolean;
27089
+ /**
27090
+ * Relation significance from 0 to 1, used when ranking how strongly reaching through this relation matters.
27091
+ */
27092
+ weight: number;
27093
+ /**
27094
+ * Whether a source may have at most one valid relation of this type at a time; true makes a new one supersede the old.
27095
+ */
27096
+ functional: boolean;
27097
+ /**
27098
+ * How long the relation stays strong while valid, from 0 to 1; 1 never fades and lower values decay faster. Omit for the default decay.
27099
+ */
27100
+ persistence?: number;
27101
+ /**
27102
+ * Origins a relation of this type may carry; each value names where the fact came from and they are checked when writing.
27103
+ */
27104
+ origins: Array<'platform' | 'stated' | 'observed' | 'inferred'>;
27105
+ /**
27106
+ * What this fact means in the registering service, used to choose the right type when writing.
27107
+ */
27108
+ description: string;
27109
+ };
27110
+ /**
27111
+ * A node the caller may reach but not read, because its content belongs to another member; its name confirms what was reached while the content stays withheld.
27112
+ */
27113
+ export type OntologyRestrictedNode = {
27114
+ /**
27115
+ * Node id, usable to relate this entity to others; treat it as opaque.
27116
+ */
27117
+ id: string;
27118
+ /**
27119
+ * Registered node type of the hidden entity, which is not itself restricted content.
27120
+ */
27121
+ type: string;
27122
+ /**
27123
+ * Display name of the hidden entity, shown so a caller can tell whether the reached node is the one it meant.
27124
+ */
27125
+ name: string;
27126
+ /**
27127
+ * Always true; its presence is how a caller tells a withheld node from a readable one.
27128
+ */
27129
+ restricted: boolean;
27130
+ };
27131
+ /**
27132
+ * One operation of a changeset, discriminated by op; it names new nodes and relations by caller-local keys reused within the same batch.
27133
+ */
27134
+ export type OntologyChangesetOp = {
27135
+ /**
27136
+ * Which operation to apply; the remaining required fields follow from this value.
27137
+ */
27138
+ op: 'upsert_node' | 'relate' | 'invalidate' | 'merge' | 'alias';
27139
+ /**
27140
+ * Caller-local name for the node or relation this operation creates, reused by later operations in the same batch; it is not an id.
27141
+ */
27142
+ key?: string;
27143
+ /**
27144
+ * Registered type name for upsert_node and relate; an unregistered name refuses the whole batch.
27145
+ */
27146
+ type?: string;
27147
+ /**
27148
+ * Mirrored record id for upsert_node, which must start with the type's ref_prefix; omit for a concept.
27149
+ */
27150
+ ref?: string;
27151
+ /**
27152
+ * Display name for upsert_node, at most 200 characters.
27153
+ */
27154
+ name?: string;
27155
+ /**
27156
+ * Start of a relate fact; a key from this batch or an existing node id.
27157
+ */
27158
+ source?: string;
27159
+ /**
27160
+ * End of a relate fact; a key from this batch or an existing node id.
27161
+ */
27162
+ target?: string;
27163
+ /**
27164
+ * The relationship in one sentence for relate, at most 280 characters.
27165
+ */
27166
+ fact?: string;
27167
+ /**
27168
+ * Where a relate fact came from; the relation type must accept this origin.
27169
+ */
27170
+ origin?: 'platform' | 'stated' | 'observed' | 'inferred';
27171
+ /**
27172
+ * Relation id an invalidate operation acts on, from relations.list or an earlier operation in this batch.
27173
+ */
27174
+ edge?: string;
27175
+ /**
27176
+ * World time an invalidate operation marks the fact as no longer true.
27177
+ */
27178
+ invalid_at?: string;
27179
+ /**
27180
+ * Relation id that replaces the invalidated one, when a successor was recorded; omit when nothing replaced it.
27181
+ */
27182
+ by?: string;
27183
+ /**
27184
+ * Why the operation was applied, kept for people reading the history; not enforced.
27185
+ */
27186
+ reason?: string;
27187
+ /**
27188
+ * Node id a merge operation folds away, resolving to the into node afterwards.
27189
+ */
27190
+ from?: string;
27191
+ /**
27192
+ * Node id a merge operation keeps, receiving the merged node's relations and aliases.
27193
+ */
27194
+ into?: string;
27195
+ /**
27196
+ * Node id an alias operation adds a name to.
27197
+ */
27198
+ node?: string;
27199
+ /**
27200
+ * The additional name an alias operation records for its node.
27201
+ */
27202
+ alias?: string;
27203
+ };
26333
27204
  /**
26334
27205
  * Auto-resume configuration for paused sandboxes.
26335
27206
  */
@@ -30907,7 +31778,7 @@ export type MediaSemanticMatch = {
30907
31778
  /**
30908
31779
  * Type of change recorded for a library, asset, processing task, search index or batch.
30909
31780
  */
30910
- export type MediaMediaEventType = 'library.status_provisioning' | 'library.status_active' | 'library.status_deleting' | 'library.status_deleted' | 'library.status_failed' | 'library.restored' | 'library.updated' | 'asset.created' | 'asset.updated' | 'asset.overwritten' | 'asset.renamed' | 'asset.deleted' | 'understanding.status_ready' | 'understanding.status_failed' | 'understanding.status_unsupported' | 'search.indexed' | 'batch.succeeded' | 'batch.failed' | 'library.understanding_drained' | 'batch.created';
31781
+ export type MediaMediaEventType = 'library.status_provisioning' | 'library.status_active' | 'library.status_deleting' | 'library.status_deleted' | 'library.status_failed' | 'library.restored' | 'library.updated' | 'asset.created' | 'asset.updated' | 'asset.overwritten' | 'asset.renamed' | 'asset.deleted' | 'understanding.status_ready' | 'understanding.status_failed' | 'understanding.status_unsupported' | 'search.indexed' | 'batch.succeeded' | 'batch.failed' | 'library.understanding_drained' | 'batch.created' | 'generation.created' | 'generation.succeeded' | 'generation.failed' | 'generation.cancelled';
30911
31782
  /**
30912
31783
  * Auto-resume enabled flag for paused sandboxes. Default false.
30913
31784
  */
@@ -31539,21 +32410,25 @@ export type AnthropicToolReferenceBlock = {
31539
32410
  */
31540
32411
  export type CutTextStyle = {
31541
32412
  /**
31542
- * Geist is the Latin typeface; Noto Sans SC is the simplified Chinese typeface.
32413
+ * Canonical font family name; call ListFonts() in the Cut script API to retrieve the available font families.
31543
32414
  */
31544
- font_family?: 'Geist' | 'Noto Sans SC';
32415
+ font_family?: string;
31545
32416
  /**
31546
32417
  * Text size in output pixels.
31547
32418
  */
31548
32419
  font_size?: number;
31549
32420
  /**
31550
- * Font weight: 400 is regular, 500 is medium and 700 is bold.
32421
+ * Positive requested font weight; each family has its own available catalog weights, and unsupported values resolve to the nearest available weight, preferring the heavier weight on a tie.
31551
32422
  */
31552
- font_weight?: 400 | 500 | 700;
32423
+ font_weight?: number;
31553
32424
  /**
31554
32425
  * Text color in #RRGGBB or #RRGGBBAA notation.
31555
32426
  */
31556
32427
  color?: string;
32428
+ /**
32429
+ * Optional solid or gradient glyph fill; gradients span the text box.
32430
+ */
32431
+ fill?: CutFill;
31557
32432
  /**
31558
32433
  * Optional text outline.
31559
32434
  */
@@ -31563,9 +32438,60 @@ export type CutTextStyle = {
31563
32438
  */
31564
32439
  color?: string;
31565
32440
  /**
31566
- * Outline width in output pixels.
32441
+ * Outline width in output pixels; must be non-negative and at most 40 pixels.
32442
+ */
32443
+ width?: number;
32444
+ };
32445
+ /**
32446
+ * Additional outlines, painted from outermost to innermost; at most 4 strokes.
32447
+ */
32448
+ strokes?: Array<{
32449
+ /**
32450
+ * Outline color in #RRGGBB or #RRGGBBAA notation.
32451
+ */
32452
+ color?: string;
32453
+ /**
32454
+ * Outline width in output pixels, from 0 to 40.
31567
32455
  */
31568
32456
  width?: number;
32457
+ }>;
32458
+ /**
32459
+ * Offset text shadows; at most 4 shadows. Offsets are non-negative output pixels; blur is 0 to 100 output pixels.
32460
+ */
32461
+ shadows?: Array<{
32462
+ /**
32463
+ * Shadow color in #RRGGBB or #RRGGBBAA notation.
32464
+ */
32465
+ color?: string;
32466
+ /**
32467
+ * Non-negative horizontal offset in output pixels.
32468
+ */
32469
+ x?: number;
32470
+ /**
32471
+ * Non-negative vertical offset in output pixels.
32472
+ */
32473
+ y?: number;
32474
+ /**
32475
+ * Blur radius in output pixels, from 0 to 100.
32476
+ */
32477
+ blur?: number;
32478
+ }>;
32479
+ /**
32480
+ * Colored glow around glyphs; radius is in output pixels, from 0 to 100, and strength is from 0 to 1.
32481
+ */
32482
+ glow?: {
32483
+ /**
32484
+ * Glow color in #RRGGBB or #RRGGBBAA notation.
32485
+ */
32486
+ color?: string;
32487
+ /**
32488
+ * Glow blur radius in output pixels, from 0 to 100.
32489
+ */
32490
+ radius?: number;
32491
+ /**
32492
+ * Glow opacity multiplier from 0 to 1.
32493
+ */
32494
+ strength?: number;
31569
32495
  };
31570
32496
  /**
31571
32497
  * Optional text background color as hexadecimal RGB or RGBA.
@@ -31772,6 +32698,70 @@ export type CutJoinEffect = {
31772
32698
  * Blur radius in pixels at a reference frame height of 1080 pixels.
31773
32699
  */
31774
32700
  radius?: number;
32701
+ } | {
32702
+ /**
32703
+ * Zoom transition.
32704
+ */
32705
+ kind: 'zoom';
32706
+ /**
32707
+ * Zoom in or out.
32708
+ */
32709
+ direction?: 'in' | 'out';
32710
+ /**
32711
+ * Peak scale increase as a multiple of the original scale.
32712
+ */
32713
+ amount?: number;
32714
+ /**
32715
+ * Radial blur strength; zero disables blur sampling.
32716
+ */
32717
+ blur?: number;
32718
+ } | {
32719
+ /**
32720
+ * Clock transition.
32721
+ */
32722
+ kind: 'clock';
32723
+ /**
32724
+ * Sweep direction.
32725
+ */
32726
+ direction?: 'clockwise' | 'counterclockwise';
32727
+ /**
32728
+ * Start angle in degrees, with zero at twelve o'clock.
32729
+ */
32730
+ start_angle?: number;
32731
+ /**
32732
+ * Angular feather width.
32733
+ */
32734
+ softness?: number;
32735
+ } | {
32736
+ /**
32737
+ * Flash transition.
32738
+ */
32739
+ kind: 'flash';
32740
+ /**
32741
+ * Flash color.
32742
+ */
32743
+ color?: 'white' | 'black';
32744
+ /**
32745
+ * Flash strength.
32746
+ */
32747
+ intensity?: number;
32748
+ } | {
32749
+ /**
32750
+ * Luma transition.
32751
+ */
32752
+ kind: 'luma';
32753
+ /**
32754
+ * Built-in map. User maps are not available yet.
32755
+ */
32756
+ map?: 'radial' | 'diagonal' | 'clouds' | 'spiral' | 'honeycomb' | 'bars';
32757
+ /**
32758
+ * Edge feather width.
32759
+ */
32760
+ softness?: number;
32761
+ /**
32762
+ * Reveal order.
32763
+ */
32764
+ invert?: 'normal' | 'inverted';
31775
32765
  };
31776
32766
  export type KnowledgeStaticChunking = {
31777
32767
  /**
@@ -32013,6 +33003,51 @@ export type AnthropicCitationsConfig = {
32013
33003
  */
32014
33004
  enabled: boolean;
32015
33005
  };
33006
+ /**
33007
+ * Solid color or a gradient over the styled text box.
33008
+ */
33009
+ export type CutFill = string | {
33010
+ /**
33011
+ * Linear gradient; angle is in degrees and stop positions range from 0 to 1.
33012
+ */
33013
+ linear?: {
33014
+ /**
33015
+ * Gradient angle in degrees; 0 runs left to right.
33016
+ */
33017
+ angle?: number;
33018
+ /**
33019
+ * Gradient color stops; each position is a fraction from 0 to 1.
33020
+ */
33021
+ stops?: Array<{
33022
+ /**
33023
+ * Stop position as a fraction from 0 to 1.
33024
+ */
33025
+ at?: number;
33026
+ /**
33027
+ * Stop color in #RRGGBB or #RRGGBBAA notation.
33028
+ */
33029
+ color?: string;
33030
+ }>;
33031
+ };
33032
+ /**
33033
+ * Radial gradient with stop positions as fractions from 0 to 1.
33034
+ */
33035
+ radial?: {
33036
+ /**
33037
+ * Gradient color stops; each position is a fraction from 0 to 1.
33038
+ */
33039
+ stops?: Array<{
33040
+ /**
33041
+ * Stop position as a fraction from 0 to 1.
33042
+ */
33043
+ at?: number;
33044
+ /**
33045
+ * Stop color in #RRGGBB or #RRGGBBAA notation.
33046
+ */
33047
+ color?: string;
33048
+ }>;
33049
+ };
33050
+ };
32016
33051
  /**
32017
33052
  * Visual placement; coordinates are normalized canvas centers.
32018
33053
  */
@@ -32645,6 +33680,10 @@ export type MediaAssetWritable = {
32645
33680
  * Resource status; active identifies an asset that has not been deleted.
32646
33681
  */
32647
33682
  status: 'active';
33683
+ /**
33684
+ * True when the source header declares an alpha channel: a PNG color type 4 or 6 or a tRNS chunk, a WebP VP8X alpha flag or VP8L alpha bit, a WebM or MKV video track AlphaMode of 1, or a GIF transparent-color flag. False when a known container has no alpha channel. Omitted when the format is unknown, the header could not be parsed, or the asset was stored before this field existed; absence does not mean the source is opaque.
33685
+ */
33686
+ has_alpha?: boolean;
32648
33687
  /**
32649
33688
  * Search-vector status: pending awaits vector generation or reprocessing; ready has searchable vectors; unavailable indicates disabled, unsupported or failed embedding. Existing vectors may still serve searches while reprocessing is pending.
32650
33689
  */
@@ -32701,6 +33740,27 @@ export type MediaAssetWritable = {
32701
33740
  };
32702
33741
  };
32703
33742
  };
33743
+ /**
33744
+ * Source details for the video-generation job that created this asset.
33745
+ */
33746
+ generation?: {
33747
+ /**
33748
+ * Job id that generated this asset.
33749
+ */
33750
+ job_id: MediaJobId;
33751
+ /**
33752
+ * Generation intent used to create the asset; v1 supports video.generate.
33753
+ */
33754
+ intent: string;
33755
+ /**
33756
+ * Text prompt submitted for the generation job.
33757
+ */
33758
+ prompt: string;
33759
+ /**
33760
+ * Router video-generation model that produced the asset.
33761
+ */
33762
+ model: string;
33763
+ };
32704
33764
  };
32705
33765
  /**
32706
33766
  * Understanding results in this page, ordered by creation time ascending.
@@ -33017,7 +34077,7 @@ export type MediaChunkCompleteWritable = MediaCloudinaryResourceWritable & {
33017
34077
  done: true;
33018
34078
  };
33019
34079
  /**
33020
- * Per-task processing progress and its aggregate state for the asset. For understanding, Media generates proxies for video sources of 25 MB or more and audio-only sources of 100 MB or more; originals remain available unchanged. The duration limit is 10 minutes. A video proxy still above 95 MB after recompression, or a source exceeding the duration limit, is reported as UNSUPPORTED with the limit in the failure message. Proxy preparation uses the organization’s metered sandbox resources.
34080
+ * Per-task processing progress and its aggregate state for the asset. For understanding, Media generates proxies for video sources of 25 MB or more or longer than 10 minutes, and for audio-only sources of 100 MB or more; originals remain available unchanged. Long videos are supported. When a video proxy is needed and is still above 95 MB after recompression, the source is reported as UNSUPPORTED with the limit in the failure message. Proxy preparation uses the organization’s metered sandbox resources.
33021
34081
  */
33022
34082
  export type MediaProcessingWritable = {
33023
34083
  state: MediaProcessingState;
@@ -33246,6 +34306,10 @@ export type MediaSearchAssetWritable = {
33246
34306
  * Resource status; active identifies an asset that has not been deleted.
33247
34307
  */
33248
34308
  status: 'active';
34309
+ /**
34310
+ * True when the source header declares an alpha channel: a PNG color type 4 or 6 or a tRNS chunk, a WebP VP8X alpha flag or VP8L alpha bit, a WebM or MKV video track AlphaMode of 1, or a GIF transparent-color flag. False when a known container has no alpha channel. Omitted when the format is unknown, the header could not be parsed, or the asset was stored before this field existed; absence does not mean the source is opaque.
34311
+ */
34312
+ has_alpha?: boolean;
33249
34313
  /**
33250
34314
  * Search-vector status: pending awaits vector generation or reprocessing; ready has searchable vectors; unavailable indicates disabled, unsupported or failed embedding. Existing vectors may still serve searches while reprocessing is pending.
33251
34315
  */
@@ -33302,6 +34366,27 @@ export type MediaSearchAssetWritable = {
33302
34366
  };
33303
34367
  };
33304
34368
  };
34369
+ /**
34370
+ * Source details for the video-generation job that created this asset.
34371
+ */
34372
+ generation?: {
34373
+ /**
34374
+ * Job id that generated this asset.
34375
+ */
34376
+ job_id: MediaJobId;
34377
+ /**
34378
+ * Generation intent used to create the asset; v1 supports video.generate.
34379
+ */
34380
+ intent: string;
34381
+ /**
34382
+ * Text prompt submitted for the generation job.
34383
+ */
34384
+ prompt: string;
34385
+ /**
34386
+ * Router video-generation model that produced the asset.
34387
+ */
34388
+ model: string;
34389
+ };
33305
34390
  };
33306
34391
  /**
33307
34392
  * A matching asset with its ranking score and supporting matches.
@@ -33358,6 +34443,26 @@ export type CutExportId = string;
33358
34443
  * Version identifier returned by its create or list operation; use the id, not a display name.
33359
34444
  */
33360
34445
  export type CutVersionId = string;
34446
+ /**
34447
+ * A type name from types.list, with its dots preserved — a display label is not accepted.
34448
+ */
34449
+ export type OntologyTypeName = string;
34450
+ /**
34451
+ * Maximum items to return per page, from 1 to 100; defaults to 50 when omitted. Values above 100 are clamped to 100.
34452
+ */
34453
+ export type OntologyLimit = number;
34454
+ /**
34455
+ * Opaque next_cursor from the preceding list response; omit for the first page and stop when next_cursor is null.
34456
+ */
34457
+ export type OntologyCursor = string;
34458
+ /**
34459
+ * Node id returned by nodes.list, nodes.create or a changeset, in the form ond_ followed by 32 lowercase letters or digits; a name or an external record id is not accepted.
34460
+ */
34461
+ export type OntologyNodeId = string;
34462
+ /**
34463
+ * Relation id returned by relations.list, relations.create or a changeset, in the form oed_ followed by 32 lowercase letters or digits; a node id is not accepted.
34464
+ */
34465
+ export type OntologyRelationId = string;
33361
34466
  /**
33362
34467
  * Cursor to start the list from
33363
34468
  */
@@ -33547,7 +34652,7 @@ export type ApplyAgentVersionResponses = {
33547
34652
  */
33548
34653
  note: string | null;
33549
34654
  /**
33550
- * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
34655
+ * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search, browser, ticket, crm, canvas or cut. There is no binding by default; enabling one opens every public method of that service. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
33551
34656
  */
33552
34657
  bindings: Array<{
33553
34658
  /**
@@ -33578,7 +34683,7 @@ export type ApplyAgentVersionResponses = {
33578
34683
  /**
33579
34684
  * Service type. Opens the whole service to codemode; there is no per-resource id.
33580
34685
  */
33581
- type: 'search' | 'browser';
34686
+ type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
33582
34687
  /**
33583
34688
  * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
33584
34689
  */
@@ -34764,7 +35869,7 @@ export type UnarchiveAgentResponses = {
34764
35869
  */
34765
35870
  note: string | null;
34766
35871
  /**
34767
- * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
35872
+ * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search, browser, ticket, crm, canvas or cut. There is no binding by default; enabling one opens every public method of that service. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
34768
35873
  */
34769
35874
  bindings: Array<{
34770
35875
  /**
@@ -34795,7 +35900,7 @@ export type UnarchiveAgentResponses = {
34795
35900
  /**
34796
35901
  * Service type. Opens the whole service to codemode; there is no per-resource id.
34797
35902
  */
34798
- type: 'search' | 'browser';
35903
+ type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
34799
35904
  /**
34800
35905
  * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
34801
35906
  */
@@ -38905,6 +40010,280 @@ export type ComputersFilesContentResponses = {
38905
40010
  206: Blob | File;
38906
40011
  };
38907
40012
  export type ComputersFilesContentResponse = ComputersFilesContentResponses[keyof ComputersFilesContentResponses];
40013
+ export type ComputersFilesConvertData = {
40014
+ body: {
40015
+ /**
40016
+ * Name of the entry or object.
40017
+ */
40018
+ name: string;
40019
+ };
40020
+ path: {
40021
+ /**
40022
+ * Computer id (cmp_...), as returned by computers.create or computers.list.
40023
+ */
40024
+ computer_id: string;
40025
+ };
40026
+ query?: never;
40027
+ url: '/agent/v1/computers/{computer_id}/files/convert';
40028
+ };
40029
+ export type ComputersFilesConvertErrors = {
40030
+ /**
40031
+ * Platform error in the one /agent/v1 error body; computer failures add error.hint
40032
+ */
40033
+ 400: {
40034
+ type: 'error';
40035
+ error: {
40036
+ /**
40037
+ * Anthropic error type, such as invalid_request_error or not_found_error.
40038
+ */
40039
+ type: string;
40040
+ message: string;
40041
+ code: string;
40042
+ retryable: boolean;
40043
+ /**
40044
+ * How to recover, for computer failures.
40045
+ */
40046
+ hint?: string;
40047
+ };
40048
+ /**
40049
+ * Equals the X-Request-Id response header.
40050
+ */
40051
+ request_id: string;
40052
+ };
40053
+ /**
40054
+ * Platform error in the one /agent/v1 error body; computer failures add error.hint
40055
+ */
40056
+ 401: {
40057
+ type: 'error';
40058
+ error: {
40059
+ /**
40060
+ * Anthropic error type, such as invalid_request_error or not_found_error.
40061
+ */
40062
+ type: string;
40063
+ message: string;
40064
+ code: string;
40065
+ retryable: boolean;
40066
+ /**
40067
+ * How to recover, for computer failures.
40068
+ */
40069
+ hint?: string;
40070
+ };
40071
+ /**
40072
+ * Equals the X-Request-Id response header.
40073
+ */
40074
+ request_id: string;
40075
+ };
40076
+ /**
40077
+ * Platform error in the one /agent/v1 error body; computer failures add error.hint
40078
+ */
40079
+ 403: {
40080
+ type: 'error';
40081
+ error: {
40082
+ /**
40083
+ * Anthropic error type, such as invalid_request_error or not_found_error.
40084
+ */
40085
+ type: string;
40086
+ message: string;
40087
+ code: string;
40088
+ retryable: boolean;
40089
+ /**
40090
+ * How to recover, for computer failures.
40091
+ */
40092
+ hint?: string;
40093
+ };
40094
+ /**
40095
+ * Equals the X-Request-Id response header.
40096
+ */
40097
+ request_id: string;
40098
+ };
40099
+ /**
40100
+ * Computer or path not found; foreign computers are indistinguishable from absent computers.
40101
+ */
40102
+ 404: {
40103
+ type: 'error';
40104
+ error: {
40105
+ /**
40106
+ * Anthropic error type, such as invalid_request_error or not_found_error.
40107
+ */
40108
+ type: string;
40109
+ message: string;
40110
+ code: string;
40111
+ retryable: boolean;
40112
+ /**
40113
+ * How to recover, for computer failures.
40114
+ */
40115
+ hint?: string;
40116
+ };
40117
+ /**
40118
+ * Equals the X-Request-Id response header.
40119
+ */
40120
+ request_id: string;
40121
+ };
40122
+ /**
40123
+ * Platform error in the one /agent/v1 error body; computer failures add error.hint
40124
+ */
40125
+ 409: {
40126
+ type: 'error';
40127
+ error: {
40128
+ /**
40129
+ * Anthropic error type, such as invalid_request_error or not_found_error.
40130
+ */
40131
+ type: string;
40132
+ message: string;
40133
+ code: string;
40134
+ retryable: boolean;
40135
+ /**
40136
+ * How to recover, for computer failures.
40137
+ */
40138
+ hint?: string;
40139
+ };
40140
+ /**
40141
+ * Equals the X-Request-Id response header.
40142
+ */
40143
+ request_id: string;
40144
+ };
40145
+ /**
40146
+ * Platform error in the one /agent/v1 error body; computer failures add error.hint
40147
+ */
40148
+ 413: {
40149
+ type: 'error';
40150
+ error: {
40151
+ /**
40152
+ * Anthropic error type, such as invalid_request_error or not_found_error.
40153
+ */
40154
+ type: string;
40155
+ message: string;
40156
+ code: string;
40157
+ retryable: boolean;
40158
+ /**
40159
+ * How to recover, for computer failures.
40160
+ */
40161
+ hint?: string;
40162
+ };
40163
+ /**
40164
+ * Equals the X-Request-Id response header.
40165
+ */
40166
+ request_id: string;
40167
+ };
40168
+ /**
40169
+ * Platform error in the one /agent/v1 error body; computer failures add error.hint
40170
+ */
40171
+ 429: {
40172
+ type: 'error';
40173
+ error: {
40174
+ /**
40175
+ * Anthropic error type, such as invalid_request_error or not_found_error.
40176
+ */
40177
+ type: string;
40178
+ message: string;
40179
+ code: string;
40180
+ retryable: boolean;
40181
+ /**
40182
+ * How to recover, for computer failures.
40183
+ */
40184
+ hint?: string;
40185
+ };
40186
+ /**
40187
+ * Equals the X-Request-Id response header.
40188
+ */
40189
+ request_id: string;
40190
+ };
40191
+ /**
40192
+ * Platform error in the one /agent/v1 error body; computer failures add error.hint
40193
+ */
40194
+ 500: {
40195
+ type: 'error';
40196
+ error: {
40197
+ /**
40198
+ * Anthropic error type, such as invalid_request_error or not_found_error.
40199
+ */
40200
+ type: string;
40201
+ message: string;
40202
+ code: string;
40203
+ retryable: boolean;
40204
+ /**
40205
+ * How to recover, for computer failures.
40206
+ */
40207
+ hint?: string;
40208
+ };
40209
+ /**
40210
+ * Equals the X-Request-Id response header.
40211
+ */
40212
+ request_id: string;
40213
+ };
40214
+ /**
40215
+ * Platform error in the one /agent/v1 error body; computer failures add error.hint
40216
+ */
40217
+ 503: {
40218
+ type: 'error';
40219
+ error: {
40220
+ /**
40221
+ * Anthropic error type, such as invalid_request_error or not_found_error.
40222
+ */
40223
+ type: string;
40224
+ message: string;
40225
+ code: string;
40226
+ retryable: boolean;
40227
+ /**
40228
+ * How to recover, for computer failures.
40229
+ */
40230
+ hint?: string;
40231
+ };
40232
+ /**
40233
+ * Equals the X-Request-Id response header.
40234
+ */
40235
+ request_id: string;
40236
+ };
40237
+ };
40238
+ export type ComputersFilesConvertError = ComputersFilesConvertErrors[keyof ComputersFilesConvertErrors];
40239
+ export type ComputersFilesConvertResponses = {
40240
+ /**
40241
+ * Computer result
40242
+ */
40243
+ 200: {
40244
+ /**
40245
+ * Always `computer`. A computer.
40246
+ */
40247
+ type: 'computer';
40248
+ /**
40249
+ * Computer id (cmp_...), the computer_id of computer calls.
40250
+ */
40251
+ id: string;
40252
+ /**
40253
+ * Display name of the computer, 1 to 255 characters.
40254
+ */
40255
+ name: string;
40256
+ /**
40257
+ * Public id of the sandbox that backs the computer, usable with the sandbox API; null while none has been created.
40258
+ */
40259
+ sandbox_id: string | null;
40260
+ /**
40261
+ * not_started means the machine has not been created; first use provisions it. provisioned means a machine has been created, whether running or paused.
40262
+ */
40263
+ machine_state: 'not_started' | 'provisioned';
40264
+ /**
40265
+ * Environment recipe the computer was created with; null when none.
40266
+ */
40267
+ environment_id: string | null;
40268
+ /**
40269
+ * active computers can be used by new sessions; archived ones keep their files readable but cannot start new sessions.
40270
+ */
40271
+ status: 'active' | 'archived';
40272
+ /**
40273
+ * RFC 3339 time at which the computer was created.
40274
+ */
40275
+ created_at: string;
40276
+ /**
40277
+ * RFC 3339 time at which the computer was last modified.
40278
+ */
40279
+ updated_at: string;
40280
+ /**
40281
+ * RFC 3339 time at which the computer was archived; null while active.
40282
+ */
40283
+ archived_at: string | null;
40284
+ };
40285
+ };
40286
+ export type ComputersFilesConvertResponse = ComputersFilesConvertResponses[keyof ComputersFilesConvertResponses];
38908
40287
  export type ConnectComputerData = {
38909
40288
  body?: {
38910
40289
  /**
@@ -43902,6 +45281,42 @@ export type FileCancelUploadResponses = {
43902
45281
  200: OwnFilePraxisUpload;
43903
45282
  };
43904
45283
  export type FileCancelUploadResponse = FileCancelUploadResponses[keyof FileCancelUploadResponses];
45284
+ export type FileRetrieveUploadData = {
45285
+ body?: never;
45286
+ path: {
45287
+ /**
45288
+ * Upload identifier returned by create on this face; the upload belongs to your organization.
45289
+ */
45290
+ upload_id: string;
45291
+ };
45292
+ query?: never;
45293
+ url: '/file/v1/uploads/{upload_id}';
45294
+ };
45295
+ export type FileRetrieveUploadErrors = {
45296
+ /**
45297
+ * INVALID_PARAMS: correct the upload_id before retrying.
45298
+ */
45299
+ 400: unknown;
45300
+ /**
45301
+ * UNAUTHENTICATED: supply a valid organization API key or signed-in session.
45302
+ */
45303
+ 401: unknown;
45304
+ /**
45305
+ * UPLOAD_NOT_FOUND: the upload is missing or belongs to another organization; create a new upload and send its parts.
45306
+ */
45307
+ 404: unknown;
45308
+ /**
45309
+ * UPLOAD_INVALID_STATE: the upload was cancelled or expired; create a new upload and send its parts again.
45310
+ */
45311
+ 409: unknown;
45312
+ };
45313
+ export type FileRetrieveUploadResponses = {
45314
+ /**
45315
+ * The upload state plus part_size and the received_parts list; complete once every part is present.
45316
+ */
45317
+ 200: OwnFilePraxisUpload;
45318
+ };
45319
+ export type FileRetrieveUploadResponse = FileRetrieveUploadResponses[keyof FileRetrieveUploadResponses];
43905
45320
  export type FileCreateSignedUploadData = {
43906
45321
  body: OwnFileSignedUploadRequest;
43907
45322
  path?: never;
@@ -51338,7 +52753,7 @@ export type AgentsListResponses = {
51338
52753
  */
51339
52754
  note: string | null;
51340
52755
  /**
51341
- * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
52756
+ * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search, browser, ticket, crm, canvas or cut. There is no binding by default; enabling one opens every public method of that service. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
51342
52757
  */
51343
52758
  bindings: Array<{
51344
52759
  /**
@@ -51369,7 +52784,7 @@ export type AgentsListResponses = {
51369
52784
  /**
51370
52785
  * Service type. Opens the whole service to codemode; there is no per-resource id.
51371
52786
  */
51372
- type: 'search' | 'browser';
52787
+ type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
51373
52788
  /**
51374
52789
  * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
51375
52790
  */
@@ -51877,7 +53292,7 @@ export type AgentsCreateData = {
51877
53292
  */
51878
53293
  tools?: Array<AgentManaged15 | AgentManaged29 | AgentManaged32>;
51879
53294
  /**
51880
- * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
53295
+ * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search, browser, ticket, crm, canvas or cut. There is no binding by default; enabling one opens every public method of that service. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
51881
53296
  */
51882
53297
  bindings?: Array<{
51883
53298
  /**
@@ -51908,7 +53323,7 @@ export type AgentsCreateData = {
51908
53323
  /**
51909
53324
  * Service type. Opens the whole service to codemode; there is no per-resource id.
51910
53325
  */
51911
- type: 'search' | 'browser';
53326
+ type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
51912
53327
  /**
51913
53328
  * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
51914
53329
  */
@@ -52478,7 +53893,7 @@ export type AgentsCreateResponses = {
52478
53893
  */
52479
53894
  note: string | null;
52480
53895
  /**
52481
- * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
53896
+ * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search, browser, ticket, crm, canvas or cut. There is no binding by default; enabling one opens every public method of that service. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
52482
53897
  */
52483
53898
  bindings: Array<{
52484
53899
  /**
@@ -52509,7 +53924,7 @@ export type AgentsCreateResponses = {
52509
53924
  /**
52510
53925
  * Service type. Opens the whole service to codemode; there is no per-resource id.
52511
53926
  */
52512
- type: 'search' | 'browser';
53927
+ type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
52513
53928
  /**
52514
53929
  * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
52515
53930
  */
@@ -53106,7 +54521,7 @@ export type AgentsRetrieveResponses = {
53106
54521
  */
53107
54522
  note: string | null;
53108
54523
  /**
53109
- * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
54524
+ * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search, browser, ticket, crm, canvas or cut. There is no binding by default; enabling one opens every public method of that service. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
53110
54525
  */
53111
54526
  bindings: Array<{
53112
54527
  /**
@@ -53137,7 +54552,7 @@ export type AgentsRetrieveResponses = {
53137
54552
  /**
53138
54553
  * Service type. Opens the whole service to codemode; there is no per-resource id.
53139
54554
  */
53140
- type: 'search' | 'browser';
54555
+ type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
53141
54556
  /**
53142
54557
  * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
53143
54558
  */
@@ -53685,7 +55100,7 @@ export type AgentsUpdateData = {
53685
55100
  /**
53686
55101
  * Service type. Opens the whole service to codemode; there is no per-resource id.
53687
55102
  */
53688
- type: 'search' | 'browser';
55103
+ type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
53689
55104
  /**
53690
55105
  * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
53691
55106
  */
@@ -54268,7 +55683,7 @@ export type AgentsUpdateResponses = {
54268
55683
  */
54269
55684
  note: string | null;
54270
55685
  /**
54271
- * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
55686
+ * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search, browser, ticket, crm, canvas or cut. There is no binding by default; enabling one opens every public method of that service. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
54272
55687
  */
54273
55688
  bindings: Array<{
54274
55689
  /**
@@ -54299,7 +55714,7 @@ export type AgentsUpdateResponses = {
54299
55714
  /**
54300
55715
  * Service type. Opens the whole service to codemode; there is no per-resource id.
54301
55716
  */
54302
- type: 'search' | 'browser';
55717
+ type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
54303
55718
  /**
54304
55719
  * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
54305
55720
  */
@@ -54882,7 +56297,7 @@ export type AgentsArchiveResponses = {
54882
56297
  */
54883
56298
  note: string | null;
54884
56299
  /**
54885
- * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
56300
+ * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search, browser, ticket, crm, canvas or cut. There is no binding by default; enabling one opens every public method of that service. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
54886
56301
  */
54887
56302
  bindings: Array<{
54888
56303
  /**
@@ -54913,7 +56328,7 @@ export type AgentsArchiveResponses = {
54913
56328
  /**
54914
56329
  * Service type. Opens the whole service to codemode; there is no per-resource id.
54915
56330
  */
54916
- type: 'search' | 'browser';
56331
+ type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
54917
56332
  /**
54918
56333
  * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
54919
56334
  */
@@ -55514,7 +56929,7 @@ export type AgentsVersionsListResponses = {
55514
56929
  */
55515
56930
  note: string | null;
55516
56931
  /**
55517
- * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
56932
+ * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search, browser, ticket, crm, canvas or cut. There is no binding by default; enabling one opens every public method of that service. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
55518
56933
  */
55519
56934
  bindings: Array<{
55520
56935
  /**
@@ -55545,7 +56960,7 @@ export type AgentsVersionsListResponses = {
55545
56960
  /**
55546
56961
  * Service type. Opens the whole service to codemode; there is no per-resource id.
55547
56962
  */
55548
- type: 'search' | 'browser';
56963
+ type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
55549
56964
  /**
55550
56965
  * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
55551
56966
  */
@@ -65522,7 +66937,7 @@ export type AutomationTriggersCreateData = {
65522
66937
  */
65523
66938
  end_at?: string | null;
65524
66939
  /**
65525
- * skip (default) skips when a previous run is still active; allow permits overlapping runs.
66940
+ * skip skips while a previous run is still active; allow permits overlapping runs. When omitted, schedule triggers use skip and webhook triggers use allow.
65526
66941
  */
65527
66942
  overlap?: 'skip' | 'allow';
65528
66943
  /**
@@ -65721,7 +67136,7 @@ export type AutomationTriggersPatchData = {
65721
67136
  */
65722
67137
  end_at?: string | null;
65723
67138
  /**
65724
- * skip (default) skips when a previous run is still active; allow permits overlapping runs.
67139
+ * skip skips while a previous run is still active; allow permits overlapping runs. When omitted, schedule triggers use skip and webhook triggers use allow.
65725
67140
  */
65726
67141
  overlap?: 'skip' | 'allow';
65727
67142
  /**
@@ -69306,7 +70721,7 @@ export type CutExecuteData = {
69306
70721
  };
69307
70722
  export type CutExecuteErrors = {
69308
70723
  /**
69309
- * SCRIPT_ERROR, SCRIPT_LIMIT or OPS_REJECTED means the script failed and its writes rolled back; correct the source using error.details.edit_id and edits when provided. EDIT_EXPIRED means the saved source is older than ten minutes; resubmit corrected script source.
70724
+ * SCRIPT_ERROR, SCRIPT_LIMIT, OPS_REJECTED or INVALID_CAPTION_FILE means the script failed and its writes rolled back; correct the source using error.details.edit_id and edits when provided. EDIT_EXPIRED means the saved source is older than ten minutes; resubmit corrected script source.
69310
70725
  */
69311
70726
  400: CutCutError;
69312
70727
  /**
@@ -72614,6 +74029,10 @@ export type MediaListLibrariesErrors = {
72614
74029
  * Request failed; see the error code reference.
72615
74030
  */
72616
74031
  415: MediaMediaError;
74032
+ /**
74033
+ * Request failed; see the error code reference.
74034
+ */
74035
+ 422: MediaMediaError;
72617
74036
  /**
72618
74037
  * Request failed; see the error code reference.
72619
74038
  */
@@ -72705,6 +74124,10 @@ export type MediaCreateLibraryErrors = {
72705
74124
  * Request failed; see the error code reference.
72706
74125
  */
72707
74126
  415: MediaMediaError;
74127
+ /**
74128
+ * Request failed; see the error code reference.
74129
+ */
74130
+ 422: MediaMediaError;
72708
74131
  /**
72709
74132
  * Request failed; see the error code reference.
72710
74133
  */
@@ -72779,6 +74202,10 @@ export type MediaCreateFrameUrlsErrors = {
72779
74202
  * This media format is unsupported; provide a supported format.
72780
74203
  */
72781
74204
  415: MediaMediaError;
74205
+ /**
74206
+ * Request failed; see the error code reference.
74207
+ */
74208
+ 422: MediaMediaError;
72782
74209
  /**
72783
74210
  * A rate limit was reached; wait before retrying.
72784
74211
  */
@@ -72840,6 +74267,10 @@ export type MediaDeleteLibraryErrors = {
72840
74267
  * Request failed; see the error code reference.
72841
74268
  */
72842
74269
  415: MediaMediaError;
74270
+ /**
74271
+ * Request failed; see the error code reference.
74272
+ */
74273
+ 422: MediaMediaError;
72843
74274
  /**
72844
74275
  * Request failed; see the error code reference.
72845
74276
  */
@@ -72901,6 +74332,10 @@ export type MediaGetLibraryErrors = {
72901
74332
  * Request failed; see the error code reference.
72902
74333
  */
72903
74334
  415: MediaMediaError;
74335
+ /**
74336
+ * Request failed; see the error code reference.
74337
+ */
74338
+ 422: MediaMediaError;
72904
74339
  /**
72905
74340
  * Request failed; see the error code reference.
72906
74341
  */
@@ -73001,6 +74436,10 @@ export type MediaUpdateLibraryErrors = {
73001
74436
  * Request failed; see the error code reference.
73002
74437
  */
73003
74438
  415: MediaMediaError;
74439
+ /**
74440
+ * Request failed; see the error code reference.
74441
+ */
74442
+ 422: MediaMediaError;
73004
74443
  /**
73005
74444
  * Request failed; see the error code reference.
73006
74445
  */
@@ -73062,6 +74501,10 @@ export type MediaRestoreLibraryErrors = {
73062
74501
  * Request failed; see the error code reference.
73063
74502
  */
73064
74503
  415: MediaMediaError;
74504
+ /**
74505
+ * Request failed; see the error code reference.
74506
+ */
74507
+ 422: MediaMediaError;
73065
74508
  /**
73066
74509
  * Request failed; see the error code reference.
73067
74510
  */
@@ -73123,6 +74566,10 @@ export type MediaPurgeLibraryErrors = {
73123
74566
  * Request failed; see the error code reference.
73124
74567
  */
73125
74568
  415: MediaMediaError;
74569
+ /**
74570
+ * Request failed; see the error code reference.
74571
+ */
74572
+ 422: MediaMediaError;
73126
74573
  /**
73127
74574
  * Request failed; see the error code reference.
73128
74575
  */
@@ -73201,6 +74648,10 @@ export type MediaListAssetsErrors = {
73201
74648
  * Request failed; see the error code reference.
73202
74649
  */
73203
74650
  415: MediaMediaError;
74651
+ /**
74652
+ * Request failed; see the error code reference.
74653
+ */
74654
+ 422: MediaMediaError;
73204
74655
  /**
73205
74656
  * Request failed; see the error code reference.
73206
74657
  */
@@ -73338,6 +74789,10 @@ export type MediaUploadAssetErrors = {
73338
74789
  * Request failed; see the error code reference.
73339
74790
  */
73340
74791
  415: MediaMediaError;
74792
+ /**
74793
+ * Request failed; see the error code reference.
74794
+ */
74795
+ 422: MediaMediaError;
73341
74796
  /**
73342
74797
  * Request failed; see the error code reference.
73343
74798
  */
@@ -73465,6 +74920,10 @@ export type MediaImportAssetErrors = {
73465
74920
  * Request failed; see the error code reference.
73466
74921
  */
73467
74922
  415: MediaMediaError;
74923
+ /**
74924
+ * Request failed; see the error code reference.
74925
+ */
74926
+ 422: MediaMediaError;
73468
74927
  /**
73469
74928
  * Request failed; see the error code reference.
73470
74929
  */
@@ -73530,6 +74989,10 @@ export type MediaDeleteAssetErrors = {
73530
74989
  * Request failed; see the error code reference.
73531
74990
  */
73532
74991
  415: MediaMediaError;
74992
+ /**
74993
+ * Request failed; see the error code reference.
74994
+ */
74995
+ 422: MediaMediaError;
73533
74996
  /**
73534
74997
  * Request failed; see the error code reference.
73535
74998
  */
@@ -73595,6 +75058,10 @@ export type MediaGetAssetErrors = {
73595
75058
  * Request failed; see the error code reference.
73596
75059
  */
73597
75060
  415: MediaMediaError;
75061
+ /**
75062
+ * Request failed; see the error code reference.
75063
+ */
75064
+ 422: MediaMediaError;
73598
75065
  /**
73599
75066
  * Request failed; see the error code reference.
73600
75067
  */
@@ -73682,6 +75149,10 @@ export type MediaUpdateAssetErrors = {
73682
75149
  * Request failed; see the error code reference.
73683
75150
  */
73684
75151
  415: MediaMediaError;
75152
+ /**
75153
+ * Request failed; see the error code reference.
75154
+ */
75155
+ 422: MediaMediaError;
73685
75156
  /**
73686
75157
  * Request failed; see the error code reference.
73687
75158
  */
@@ -73755,6 +75226,10 @@ export type MediaReprocessAssetErrors = {
73755
75226
  * Request failed; see the error code reference.
73756
75227
  */
73757
75228
  415: MediaMediaError;
75229
+ /**
75230
+ * Request failed; see the error code reference.
75231
+ */
75232
+ 422: MediaMediaError;
73758
75233
  /**
73759
75234
  * Request failed; see the error code reference.
73760
75235
  */
@@ -73837,6 +75312,10 @@ export type MediaListUnderstandingsErrors = {
73837
75312
  * Request failed; see the error code reference.
73838
75313
  */
73839
75314
  415: MediaMediaError;
75315
+ /**
75316
+ * Request failed; see the error code reference.
75317
+ */
75318
+ 422: MediaMediaError;
73840
75319
  /**
73841
75320
  * Request failed; see the error code reference.
73842
75321
  */
@@ -73928,6 +75407,10 @@ export type MediaExpressionSearchErrors = {
73928
75407
  * Request failed; see the error code reference.
73929
75408
  */
73930
75409
  415: MediaMediaError;
75410
+ /**
75411
+ * Request failed; see the error code reference.
75412
+ */
75413
+ 422: MediaMediaError;
73931
75414
  /**
73932
75415
  * Request failed; see the error code reference.
73933
75416
  */
@@ -74015,6 +75498,10 @@ export type MediaVisualSearchErrors = {
74015
75498
  * Request failed; see the error code reference.
74016
75499
  */
74017
75500
  415: MediaMediaError;
75501
+ /**
75502
+ * Request failed; see the error code reference.
75503
+ */
75504
+ 422: MediaMediaError;
74018
75505
  /**
74019
75506
  * Request failed; see the error code reference.
74020
75507
  */
@@ -74096,6 +75583,10 @@ export type MediaSemanticSearchErrors = {
74096
75583
  * Request failed; see the error code reference.
74097
75584
  */
74098
75585
  415: MediaMediaError;
75586
+ /**
75587
+ * Request failed; see the error code reference.
75588
+ */
75589
+ 422: MediaMediaError;
74099
75590
  /**
74100
75591
  * Request failed; see the error code reference.
74101
75592
  */
@@ -74177,6 +75668,10 @@ export type MediaSearchErrors = {
74177
75668
  * Request failed; see the error code reference.
74178
75669
  */
74179
75670
  415: MediaMediaError;
75671
+ /**
75672
+ * Request failed; see the error code reference.
75673
+ */
75674
+ 422: MediaMediaError;
74180
75675
  /**
74181
75676
  * Request failed; see the error code reference.
74182
75677
  */
@@ -74243,6 +75738,10 @@ export type MediaListFoldersErrors = {
74243
75738
  * Request failed; see the error code reference.
74244
75739
  */
74245
75740
  415: MediaMediaError;
75741
+ /**
75742
+ * Request failed; see the error code reference.
75743
+ */
75744
+ 422: MediaMediaError;
74246
75745
  /**
74247
75746
  * Request failed; see the error code reference.
74248
75747
  */
@@ -74316,6 +75815,10 @@ export type MediaCreateBatchErrors = {
74316
75815
  * Request failed; see the error code reference.
74317
75816
  */
74318
75817
  415: MediaMediaError;
75818
+ /**
75819
+ * Request failed; see the error code reference.
75820
+ */
75821
+ 422: MediaMediaError;
74319
75822
  /**
74320
75823
  * Request failed; see the error code reference.
74321
75824
  */
@@ -74381,6 +75884,10 @@ export type MediaGetBatchErrors = {
74381
75884
  * Request failed; see the error code reference.
74382
75885
  */
74383
75886
  415: MediaMediaError;
75887
+ /**
75888
+ * Request failed; see the error code reference.
75889
+ */
75890
+ 422: MediaMediaError;
74384
75891
  /**
74385
75892
  * Request failed; see the error code reference.
74386
75893
  */
@@ -74454,6 +75961,10 @@ export type MediaBatchAssetsErrors = {
74454
75961
  * Request failed; see the error code reference.
74455
75962
  */
74456
75963
  415: MediaMediaError;
75964
+ /**
75965
+ * Request failed; see the error code reference.
75966
+ */
75967
+ 422: MediaMediaError;
74457
75968
  /**
74458
75969
  * Request failed; see the error code reference.
74459
75970
  */
@@ -74487,7 +75998,7 @@ export type MediaGetJobData = {
74487
75998
  */
74488
75999
  library_id: string;
74489
76000
  /**
74490
- * Batch identifier returned by createBatch or batchAssets; resolved within this library.
76001
+ * Job identifier returned by batch creation, video-generation creation or job listing; resolved within this library.
74491
76002
  */
74492
76003
  job_id: string;
74493
76004
  };
@@ -74495,218 +76006,6 @@ export type MediaGetJobData = {
74495
76006
  url: '/media/v1/libraries/{library_id}/jobs/{job_id}';
74496
76007
  };
74497
76008
  export type MediaGetJobErrors = {
74498
- /**
74499
- * Request failed; see the error code reference.
74500
- */
74501
- 400: MediaMediaError;
74502
- /**
74503
- * Request failed; see the error code reference.
74504
- */
74505
- 403: MediaMediaError;
74506
- /**
74507
- * Request failed; see the error code reference.
74508
- */
74509
- 404: MediaMediaError;
74510
- /**
74511
- * Request failed; see the error code reference.
74512
- */
74513
- 409: MediaMediaError;
74514
- /**
74515
- * Request failed; see the error code reference.
74516
- */
74517
- 413: MediaMediaError;
74518
- /**
74519
- * Request failed; see the error code reference.
74520
- */
74521
- 415: MediaMediaError;
74522
- /**
74523
- * Request failed; see the error code reference.
74524
- */
74525
- 429: MediaMediaError;
74526
- /**
74527
- * Request failed; see the error code reference.
74528
- */
74529
- 501: MediaMediaError;
74530
- /**
74531
- * Request failed; see the error code reference.
74532
- */
74533
- 502: MediaMediaError;
74534
- /**
74535
- * Request failed; see the error code reference.
74536
- */
74537
- 503: MediaMediaError;
74538
- };
74539
- export type MediaGetJobError = MediaGetJobErrors[keyof MediaGetJobErrors];
74540
- export type MediaGetJobResponses = {
74541
- /**
74542
- * Successful response.
74543
- */
74544
- 200: MediaJob;
74545
- };
74546
- export type MediaGetJobResponse = MediaGetJobResponses[keyof MediaGetJobResponses];
74547
- export type MediaListEventsData = {
74548
- body?: never;
74549
- path: {
74550
- /**
74551
- * Library ID returned by creation.
74552
- */
74553
- library_id: string;
74554
- };
74555
- query?: {
74556
- /**
74557
- * Events with a larger sequence. Use with asc; cannot combine with before_seq.
74558
- */
74559
- after_seq?: number;
74560
- /**
74561
- * Events with a smaller sequence. Use with desc; cannot combine with after_seq.
74562
- */
74563
- before_seq?: number;
74564
- /**
74565
- * Sequence order: asc is increasing; desc is decreasing.
74566
- */
74567
- order?: 'asc' | 'desc';
74568
- /**
74569
- * Maximum items per page, from 1 to 200; defaults to 50.
74570
- */
74571
- limit?: number;
74572
- };
74573
- url: '/media/v1/libraries/{library_id}/events';
74574
- };
74575
- export type MediaListEventsErrors = {
74576
- /**
74577
- * Request failed; see the error code reference.
74578
- */
74579
- 400: MediaMediaError;
74580
- /**
74581
- * Request failed; see the error code reference.
74582
- */
74583
- 403: MediaMediaError;
74584
- /**
74585
- * Request failed; see the error code reference.
74586
- */
74587
- 404: MediaMediaError;
74588
- /**
74589
- * Request failed; see the error code reference.
74590
- */
74591
- 409: MediaMediaError;
74592
- /**
74593
- * Request failed; see the error code reference.
74594
- */
74595
- 413: MediaMediaError;
74596
- /**
74597
- * Request failed; see the error code reference.
74598
- */
74599
- 415: MediaMediaError;
74600
- /**
74601
- * Request failed; see the error code reference.
74602
- */
74603
- 429: MediaMediaError;
74604
- /**
74605
- * Request failed; see the error code reference.
74606
- */
74607
- 501: MediaMediaError;
74608
- /**
74609
- * Request failed; see the error code reference.
74610
- */
74611
- 502: MediaMediaError;
74612
- /**
74613
- * Request failed; see the error code reference.
74614
- */
74615
- 503: MediaMediaError;
74616
- };
74617
- export type MediaListEventsError = MediaListEventsErrors[keyof MediaListEventsErrors];
74618
- export type MediaListEventsResponses = {
74619
- /**
74620
- * Successful response.
74621
- */
74622
- 200: MediaMediaEventPage;
74623
- };
74624
- export type MediaListEventsResponse = MediaListEventsResponses[keyof MediaListEventsResponses];
74625
- export type MediaCreateDeliveryTokenData = {
74626
- /**
74627
- * Options for authorizing private asset delivery within one active library.
74628
- */
74629
- body: {
74630
- /**
74631
- * Delivery path glob restricted to the library path prefix (a slash, library_id, then a slash). Defaults to that prefix followed by *; * matches any path text. Tildes and control characters are rejected.
74632
- */
74633
- acl?: string;
74634
- /**
74635
- * Token lifetime in seconds, from 1 to 604800 inclusive; defaults to 900.
74636
- */
74637
- expires_in?: number;
74638
- };
74639
- path: {
74640
- /**
74641
- * Library ID returned by creation.
74642
- */
74643
- library_id: string;
74644
- };
74645
- query?: never;
74646
- url: '/media/v1/libraries/{library_id}/delivery_tokens';
74647
- };
74648
- export type MediaCreateDeliveryTokenErrors = {
74649
- /**
74650
- * Request failed; see the error code reference.
74651
- */
74652
- 400: MediaMediaError;
74653
- /**
74654
- * Request failed; see the error code reference.
74655
- */
74656
- 403: MediaMediaError;
74657
- /**
74658
- * Request failed; see the error code reference.
74659
- */
74660
- 404: MediaMediaError;
74661
- /**
74662
- * Request failed; see the error code reference.
74663
- */
74664
- 409: MediaMediaError;
74665
- /**
74666
- * Request failed; see the error code reference.
74667
- */
74668
- 413: MediaMediaError;
74669
- /**
74670
- * Request failed; see the error code reference.
74671
- */
74672
- 415: MediaMediaError;
74673
- /**
74674
- * Request failed; see the error code reference.
74675
- */
74676
- 429: MediaMediaError;
74677
- /**
74678
- * Request failed; see the error code reference.
74679
- */
74680
- 501: MediaMediaError;
74681
- /**
74682
- * Request failed; see the error code reference.
74683
- */
74684
- 502: MediaMediaError;
74685
- /**
74686
- * Request failed; see the error code reference.
74687
- */
74688
- 503: MediaMediaError;
74689
- };
74690
- export type MediaCreateDeliveryTokenError = MediaCreateDeliveryTokenErrors[keyof MediaCreateDeliveryTokenErrors];
74691
- export type MediaCreateDeliveryTokenResponses = {
74692
- /**
74693
- * Successful response.
74694
- */
74695
- 200: MediaDeliveryToken;
74696
- };
74697
- export type MediaCreateDeliveryTokenResponse = MediaCreateDeliveryTokenResponses[keyof MediaCreateDeliveryTokenResponses];
74698
- export type MediaUnderstandingFailureSummaryData = {
74699
- body?: never;
74700
- path: {
74701
- /**
74702
- * Library ID returned by creation.
74703
- */
74704
- library_id: string;
74705
- };
74706
- query?: never;
74707
- url: '/media/v1/libraries/{library_id}/understandings/failure_summary';
74708
- };
74709
- export type MediaUnderstandingFailureSummaryErrors = {
74710
76009
  /**
74711
76010
  * A selector, cursor, limit or other parameter is invalid; correct the reported field before retrying.
74712
76011
  */
@@ -74731,6 +76030,234 @@ export type MediaUnderstandingFailureSummaryErrors = {
74731
76030
  * This media format is unsupported; provide a supported format.
74732
76031
  */
74733
76032
  415: MediaMediaError;
76033
+ /**
76034
+ * Request failed; see the error code reference.
76035
+ */
76036
+ 422: MediaMediaError;
76037
+ /**
76038
+ * A rate limit was reached; wait before retrying.
76039
+ */
76040
+ 429: MediaMediaError;
76041
+ /**
76042
+ * The requested operation is unsupported; choose a supported method.
76043
+ */
76044
+ 501: MediaMediaError;
76045
+ /**
76046
+ * Request failed; see the error code reference.
76047
+ */
76048
+ 502: MediaMediaError;
76049
+ /**
76050
+ * Historical projections are still being initialized, or library storage is temporarily unavailable; retry shortly and check failureSummary counts_complete.
76051
+ */
76052
+ 503: MediaMediaError;
76053
+ };
76054
+ export type MediaGetJobError = MediaGetJobErrors[keyof MediaGetJobErrors];
76055
+ export type MediaGetJobResponses = {
76056
+ /**
76057
+ * Successful response.
76058
+ */
76059
+ 200: MediaJob;
76060
+ };
76061
+ export type MediaGetJobResponse = MediaGetJobResponses[keyof MediaGetJobResponses];
76062
+ export type MediaListEventsData = {
76063
+ body?: never;
76064
+ path: {
76065
+ /**
76066
+ * Library ID returned by creation.
76067
+ */
76068
+ library_id: string;
76069
+ };
76070
+ query?: {
76071
+ /**
76072
+ * Events with a larger sequence. Use with asc; cannot combine with before_seq.
76073
+ */
76074
+ after_seq?: number;
76075
+ /**
76076
+ * Events with a smaller sequence. Use with desc; cannot combine with after_seq.
76077
+ */
76078
+ before_seq?: number;
76079
+ /**
76080
+ * Sequence order: asc is increasing; desc is decreasing.
76081
+ */
76082
+ order?: 'asc' | 'desc';
76083
+ /**
76084
+ * Maximum items per page, from 1 to 200; defaults to 50.
76085
+ */
76086
+ limit?: number;
76087
+ };
76088
+ url: '/media/v1/libraries/{library_id}/events';
76089
+ };
76090
+ export type MediaListEventsErrors = {
76091
+ /**
76092
+ * Request failed; see the error code reference.
76093
+ */
76094
+ 400: MediaMediaError;
76095
+ /**
76096
+ * Request failed; see the error code reference.
76097
+ */
76098
+ 403: MediaMediaError;
76099
+ /**
76100
+ * Request failed; see the error code reference.
76101
+ */
76102
+ 404: MediaMediaError;
76103
+ /**
76104
+ * Request failed; see the error code reference.
76105
+ */
76106
+ 409: MediaMediaError;
76107
+ /**
76108
+ * Request failed; see the error code reference.
76109
+ */
76110
+ 413: MediaMediaError;
76111
+ /**
76112
+ * Request failed; see the error code reference.
76113
+ */
76114
+ 415: MediaMediaError;
76115
+ /**
76116
+ * Request failed; see the error code reference.
76117
+ */
76118
+ 422: MediaMediaError;
76119
+ /**
76120
+ * Request failed; see the error code reference.
76121
+ */
76122
+ 429: MediaMediaError;
76123
+ /**
76124
+ * Request failed; see the error code reference.
76125
+ */
76126
+ 501: MediaMediaError;
76127
+ /**
76128
+ * Request failed; see the error code reference.
76129
+ */
76130
+ 502: MediaMediaError;
76131
+ /**
76132
+ * Request failed; see the error code reference.
76133
+ */
76134
+ 503: MediaMediaError;
76135
+ };
76136
+ export type MediaListEventsError = MediaListEventsErrors[keyof MediaListEventsErrors];
76137
+ export type MediaListEventsResponses = {
76138
+ /**
76139
+ * Successful response.
76140
+ */
76141
+ 200: MediaMediaEventPage;
76142
+ };
76143
+ export type MediaListEventsResponse = MediaListEventsResponses[keyof MediaListEventsResponses];
76144
+ export type MediaCreateDeliveryTokenData = {
76145
+ /**
76146
+ * Options for authorizing private asset delivery within one active library.
76147
+ */
76148
+ body: {
76149
+ /**
76150
+ * Delivery path glob restricted to the library path prefix (a slash, library_id, then a slash). Defaults to that prefix followed by *; * matches any path text. Tildes and control characters are rejected.
76151
+ */
76152
+ acl?: string;
76153
+ /**
76154
+ * Token lifetime in seconds, from 1 to 604800 inclusive; defaults to 900.
76155
+ */
76156
+ expires_in?: number;
76157
+ };
76158
+ path: {
76159
+ /**
76160
+ * Library ID returned by creation.
76161
+ */
76162
+ library_id: string;
76163
+ };
76164
+ query?: never;
76165
+ url: '/media/v1/libraries/{library_id}/delivery_tokens';
76166
+ };
76167
+ export type MediaCreateDeliveryTokenErrors = {
76168
+ /**
76169
+ * Request failed; see the error code reference.
76170
+ */
76171
+ 400: MediaMediaError;
76172
+ /**
76173
+ * Request failed; see the error code reference.
76174
+ */
76175
+ 403: MediaMediaError;
76176
+ /**
76177
+ * Request failed; see the error code reference.
76178
+ */
76179
+ 404: MediaMediaError;
76180
+ /**
76181
+ * Request failed; see the error code reference.
76182
+ */
76183
+ 409: MediaMediaError;
76184
+ /**
76185
+ * Request failed; see the error code reference.
76186
+ */
76187
+ 413: MediaMediaError;
76188
+ /**
76189
+ * Request failed; see the error code reference.
76190
+ */
76191
+ 415: MediaMediaError;
76192
+ /**
76193
+ * Request failed; see the error code reference.
76194
+ */
76195
+ 422: MediaMediaError;
76196
+ /**
76197
+ * Request failed; see the error code reference.
76198
+ */
76199
+ 429: MediaMediaError;
76200
+ /**
76201
+ * Request failed; see the error code reference.
76202
+ */
76203
+ 501: MediaMediaError;
76204
+ /**
76205
+ * Request failed; see the error code reference.
76206
+ */
76207
+ 502: MediaMediaError;
76208
+ /**
76209
+ * Request failed; see the error code reference.
76210
+ */
76211
+ 503: MediaMediaError;
76212
+ };
76213
+ export type MediaCreateDeliveryTokenError = MediaCreateDeliveryTokenErrors[keyof MediaCreateDeliveryTokenErrors];
76214
+ export type MediaCreateDeliveryTokenResponses = {
76215
+ /**
76216
+ * Successful response.
76217
+ */
76218
+ 200: MediaDeliveryToken;
76219
+ };
76220
+ export type MediaCreateDeliveryTokenResponse = MediaCreateDeliveryTokenResponses[keyof MediaCreateDeliveryTokenResponses];
76221
+ export type MediaUnderstandingFailureSummaryData = {
76222
+ body?: never;
76223
+ path: {
76224
+ /**
76225
+ * Library ID returned by creation.
76226
+ */
76227
+ library_id: string;
76228
+ };
76229
+ query?: never;
76230
+ url: '/media/v1/libraries/{library_id}/understandings/failure_summary';
76231
+ };
76232
+ export type MediaUnderstandingFailureSummaryErrors = {
76233
+ /**
76234
+ * A selector, cursor, limit or other parameter is invalid; correct the reported field before retrying.
76235
+ */
76236
+ 400: MediaMediaError;
76237
+ /**
76238
+ * This credential has read-only access to the library; use a write-capable binding for mutations.
76239
+ */
76240
+ 403: MediaMediaError;
76241
+ /**
76242
+ * The library or asset is missing, deleted or belongs to another tenant; verify its identifier and owner.
76243
+ */
76244
+ 404: MediaMediaError;
76245
+ /**
76246
+ * Request failed; see the error code reference.
76247
+ */
76248
+ 409: MediaMediaError;
76249
+ /**
76250
+ * The file exceeds an input limit; provide a smaller source file.
76251
+ */
76252
+ 413: MediaMediaError;
76253
+ /**
76254
+ * This media format is unsupported; provide a supported format.
76255
+ */
76256
+ 415: MediaMediaError;
76257
+ /**
76258
+ * Request failed; see the error code reference.
76259
+ */
76260
+ 422: MediaMediaError;
74734
76261
  /**
74735
76262
  * A rate limit was reached; wait before retrying.
74736
76263
  */
@@ -74809,6 +76336,10 @@ export type MediaListUnderstandingsByLibraryErrors = {
74809
76336
  * This media format is unsupported; provide a supported format.
74810
76337
  */
74811
76338
  415: MediaMediaError;
76339
+ /**
76340
+ * Request failed; see the error code reference.
76341
+ */
76342
+ 422: MediaMediaError;
74812
76343
  /**
74813
76344
  * A rate limit was reached; wait before retrying.
74814
76345
  */
@@ -74834,6 +76365,1065 @@ export type MediaListUnderstandingsByLibraryResponses = {
74834
76365
  200: MediaUnderstandingPage;
74835
76366
  };
74836
76367
  export type MediaListUnderstandingsByLibraryResponse = MediaListUnderstandingsByLibraryResponses[keyof MediaListUnderstandingsByLibraryResponses];
76368
+ export type MediaCreateGenerationData = {
76369
+ /**
76370
+ * Text-to-video request. Generation is charged per second; unsaved candidates expire after 7 days.
76371
+ */
76372
+ body: {
76373
+ /**
76374
+ * Generation operation; v1 accepts only video.generate text-to-video requests.
76375
+ */
76376
+ intent: 'video.generate';
76377
+ /**
76378
+ * Text prompt describing the video to generate.
76379
+ */
76380
+ prompt: string;
76381
+ /**
76382
+ * Number of videos to generate; defaults to 1 and must be from 1 to 4.
76383
+ */
76384
+ count?: number;
76385
+ /**
76386
+ * Requested video duration in seconds; Router validates the model-specific supported durations.
76387
+ */
76388
+ duration_seconds?: number;
76389
+ /**
76390
+ * Requested output aspect ratio; defaults to 16:9 and Router validates model support.
76391
+ */
76392
+ aspect_ratio?: string;
76393
+ /**
76394
+ * Router model with video_generation capability; defaults to wan2.7-t2v.
76395
+ */
76396
+ model?: string;
76397
+ /**
76398
+ * candidate keeps outputs temporary for explicit save calls; library saves successful outputs automatically.
76399
+ */
76400
+ save?: 'candidate' | 'library';
76401
+ /**
76402
+ * Folder for assets saved automatically or by later save calls; defaults to the library root. New path segments containing U+FFFD or consisting only of question marks are rejected with INVALID_PARAMS; send UTF-8 names. Existing affected folders remain readable and assets can be moved out.
76403
+ */
76404
+ asset_folder?: string;
76405
+ /**
76406
+ * Tags applied when an output becomes a library asset.
76407
+ */
76408
+ tags?: Array<string>;
76409
+ /**
76410
+ * Understanding behavior when a candidate is saved as an asset; defaults to auto.
76411
+ */
76412
+ understanding?: 'auto' | 'skip';
76413
+ /**
76414
+ * Not supported in v1; omit this field. Only text-to-video is currently available.
76415
+ */
76416
+ references?: Array<unknown>;
76417
+ };
76418
+ headers?: {
76419
+ /**
76420
+ * Stable key for retrying the same request without creating or charging for another job; reusing it with different request content is rejected.
76421
+ */
76422
+ 'Idempotency-Key'?: string;
76423
+ };
76424
+ path: {
76425
+ /**
76426
+ * Library ID returned by creation.
76427
+ */
76428
+ library_id: string;
76429
+ };
76430
+ query?: never;
76431
+ url: '/media/v1/libraries/{library_id}/generations';
76432
+ };
76433
+ export type MediaCreateGenerationErrors = {
76434
+ /**
76435
+ * A selector, cursor, limit or other parameter is invalid; correct the reported field before retrying.
76436
+ */
76437
+ 400: MediaMediaError;
76438
+ /**
76439
+ * This credential has read-only access to the library; use a write-capable binding for mutations.
76440
+ */
76441
+ 403: MediaMediaError;
76442
+ /**
76443
+ * The library or asset is missing, deleted or belongs to another tenant; verify its identifier and owner.
76444
+ */
76445
+ 404: MediaMediaError;
76446
+ /**
76447
+ * Request failed; see the error code reference.
76448
+ */
76449
+ 409: MediaMediaError;
76450
+ /**
76451
+ * The file exceeds an input limit; provide a smaller source file.
76452
+ */
76453
+ 413: MediaMediaError;
76454
+ /**
76455
+ * This media format is unsupported; provide a supported format.
76456
+ */
76457
+ 415: MediaMediaError;
76458
+ /**
76459
+ * Request failed; see the error code reference.
76460
+ */
76461
+ 422: MediaMediaError;
76462
+ /**
76463
+ * This library already has five queued or running generation jobs; wait until one finishes and retry.
76464
+ */
76465
+ 429: MediaMediaError;
76466
+ /**
76467
+ * The requested operation is unsupported; choose a supported method.
76468
+ */
76469
+ 501: MediaMediaError;
76470
+ /**
76471
+ * Request failed; see the error code reference.
76472
+ */
76473
+ 502: MediaMediaError;
76474
+ /**
76475
+ * Historical projections are still being initialized, or library storage is temporarily unavailable; retry shortly and check failureSummary counts_complete.
76476
+ */
76477
+ 503: MediaMediaError;
76478
+ };
76479
+ export type MediaCreateGenerationError = MediaCreateGenerationErrors[keyof MediaCreateGenerationErrors];
76480
+ export type MediaCreateGenerationResponses = {
76481
+ /**
76482
+ * Successful response.
76483
+ */
76484
+ 202: MediaJob;
76485
+ };
76486
+ export type MediaCreateGenerationResponse = MediaCreateGenerationResponses[keyof MediaCreateGenerationResponses];
76487
+ export type MediaListJobsData = {
76488
+ body?: never;
76489
+ path: {
76490
+ /**
76491
+ * Library ID returned by creation.
76492
+ */
76493
+ library_id: string;
76494
+ };
76495
+ query?: {
76496
+ /**
76497
+ * Filter jobs by their current status.
76498
+ */
76499
+ status?: MediaJobStatus;
76500
+ /**
76501
+ * Maximum entries in this page, from 1 through 100; defaults to 100.
76502
+ */
76503
+ limit?: number;
76504
+ /**
76505
+ * Job id from the previous page’s next_cursor; omit for the first page.
76506
+ */
76507
+ cursor?: MediaJobId;
76508
+ };
76509
+ url: '/media/v1/libraries/{library_id}/jobs';
76510
+ };
76511
+ export type MediaListJobsErrors = {
76512
+ /**
76513
+ * A selector, cursor, limit or other parameter is invalid; correct the reported field before retrying.
76514
+ */
76515
+ 400: MediaMediaError;
76516
+ /**
76517
+ * This credential has read-only access to the library; use a write-capable binding for mutations.
76518
+ */
76519
+ 403: MediaMediaError;
76520
+ /**
76521
+ * The library or asset is missing, deleted or belongs to another tenant; verify its identifier and owner.
76522
+ */
76523
+ 404: MediaMediaError;
76524
+ /**
76525
+ * Request failed; see the error code reference.
76526
+ */
76527
+ 409: MediaMediaError;
76528
+ /**
76529
+ * The file exceeds an input limit; provide a smaller source file.
76530
+ */
76531
+ 413: MediaMediaError;
76532
+ /**
76533
+ * This media format is unsupported; provide a supported format.
76534
+ */
76535
+ 415: MediaMediaError;
76536
+ /**
76537
+ * Request failed; see the error code reference.
76538
+ */
76539
+ 422: MediaMediaError;
76540
+ /**
76541
+ * A rate limit was reached; wait before retrying.
76542
+ */
76543
+ 429: MediaMediaError;
76544
+ /**
76545
+ * The requested operation is unsupported; choose a supported method.
76546
+ */
76547
+ 501: MediaMediaError;
76548
+ /**
76549
+ * Request failed; see the error code reference.
76550
+ */
76551
+ 502: MediaMediaError;
76552
+ /**
76553
+ * Historical projections are still being initialized, or library storage is temporarily unavailable; retry shortly and check failureSummary counts_complete.
76554
+ */
76555
+ 503: MediaMediaError;
76556
+ };
76557
+ export type MediaListJobsError = MediaListJobsErrors[keyof MediaListJobsErrors];
76558
+ export type MediaListJobsResponses = {
76559
+ /**
76560
+ * Successful response.
76561
+ */
76562
+ 200: MediaJobPage;
76563
+ };
76564
+ export type MediaListJobsResponse = MediaListJobsResponses[keyof MediaListJobsResponses];
76565
+ export type MediaCancelJobData = {
76566
+ body?: never;
76567
+ path: {
76568
+ /**
76569
+ * Library ID returned by creation.
76570
+ */
76571
+ library_id: string;
76572
+ /**
76573
+ * Job identifier returned by batch or generation creation; the job is resolved within the specified library.
76574
+ */
76575
+ job_id: string;
76576
+ };
76577
+ query?: never;
76578
+ url: '/media/v1/libraries/{library_id}/jobs/{job_id}/cancel';
76579
+ };
76580
+ export type MediaCancelJobErrors = {
76581
+ /**
76582
+ * A selector, cursor, limit or other parameter is invalid; correct the reported field before retrying.
76583
+ */
76584
+ 400: MediaMediaError;
76585
+ /**
76586
+ * This credential has read-only access to the library; use a write-capable binding for mutations.
76587
+ */
76588
+ 403: MediaMediaError;
76589
+ /**
76590
+ * The library or asset is missing, deleted or belongs to another tenant; verify its identifier and owner.
76591
+ */
76592
+ 404: MediaMediaError;
76593
+ /**
76594
+ * Request failed; see the error code reference.
76595
+ */
76596
+ 409: MediaMediaError;
76597
+ /**
76598
+ * The file exceeds an input limit; provide a smaller source file.
76599
+ */
76600
+ 413: MediaMediaError;
76601
+ /**
76602
+ * This media format is unsupported; provide a supported format.
76603
+ */
76604
+ 415: MediaMediaError;
76605
+ /**
76606
+ * Request failed; see the error code reference.
76607
+ */
76608
+ 422: MediaMediaError;
76609
+ /**
76610
+ * A rate limit was reached; wait before retrying.
76611
+ */
76612
+ 429: MediaMediaError;
76613
+ /**
76614
+ * The requested operation is unsupported; choose a supported method.
76615
+ */
76616
+ 501: MediaMediaError;
76617
+ /**
76618
+ * Request failed; see the error code reference.
76619
+ */
76620
+ 502: MediaMediaError;
76621
+ /**
76622
+ * Historical projections are still being initialized, or library storage is temporarily unavailable; retry shortly and check failureSummary counts_complete.
76623
+ */
76624
+ 503: MediaMediaError;
76625
+ };
76626
+ export type MediaCancelJobError = MediaCancelJobErrors[keyof MediaCancelJobErrors];
76627
+ export type MediaCancelJobResponses = {
76628
+ /**
76629
+ * Successful response.
76630
+ */
76631
+ 200: MediaJob;
76632
+ };
76633
+ export type MediaCancelJobResponse = MediaCancelJobResponses[keyof MediaCancelJobResponses];
76634
+ export type MediaSaveGenerationOutputData = {
76635
+ /**
76636
+ * Optional asset metadata and understanding behavior for a successful candidate.
76637
+ */
76638
+ body?: {
76639
+ /**
76640
+ * Delivery identifier for the saved asset; defaults to gen_<job_id>_<index> and is idempotent.
76641
+ */
76642
+ public_id?: string;
76643
+ /**
76644
+ * Destination folder for the saved asset; defaults to the library root. New path segments containing U+FFFD or consisting only of question marks are rejected with INVALID_PARAMS; send UTF-8 names. Existing affected folders remain readable and assets can be moved out.
76645
+ */
76646
+ asset_folder?: string;
76647
+ /**
76648
+ * Tags to apply to the saved asset.
76649
+ */
76650
+ tags?: Array<string>;
76651
+ /**
76652
+ * Understanding behavior for the saved asset; defaults to auto.
76653
+ */
76654
+ understanding?: 'auto' | 'skip';
76655
+ };
76656
+ path: {
76657
+ /**
76658
+ * Library ID returned by creation.
76659
+ */
76660
+ library_id: string;
76661
+ /**
76662
+ * Job identifier returned by batch or generation creation; the job is resolved within the specified library.
76663
+ */
76664
+ job_id: string;
76665
+ /**
76666
+ * Zero-based position of the candidate in the Job outputs array.
76667
+ */
76668
+ index: string;
76669
+ };
76670
+ query?: never;
76671
+ url: '/media/v1/libraries/{library_id}/jobs/{job_id}/outputs/{index}/save';
76672
+ };
76673
+ export type MediaSaveGenerationOutputErrors = {
76674
+ /**
76675
+ * A selector, cursor, limit or other parameter is invalid; correct the reported field before retrying.
76676
+ */
76677
+ 400: MediaMediaError;
76678
+ /**
76679
+ * This credential has read-only access to the library; use a write-capable binding for mutations.
76680
+ */
76681
+ 403: MediaMediaError;
76682
+ /**
76683
+ * The job or output is inaccessible, missing, or the candidate has expired; verify library ownership and create a new job for an expired candidate.
76684
+ */
76685
+ 404: MediaMediaError;
76686
+ /**
76687
+ * Request failed; see the error code reference.
76688
+ */
76689
+ 409: MediaMediaError;
76690
+ /**
76691
+ * The file exceeds an input limit; provide a smaller source file.
76692
+ */
76693
+ 413: MediaMediaError;
76694
+ /**
76695
+ * This media format is unsupported; provide a supported format.
76696
+ */
76697
+ 415: MediaMediaError;
76698
+ /**
76699
+ * Request failed; see the error code reference.
76700
+ */
76701
+ 422: MediaMediaError;
76702
+ /**
76703
+ * A rate limit was reached; wait before retrying.
76704
+ */
76705
+ 429: MediaMediaError;
76706
+ /**
76707
+ * The requested operation is unsupported; choose a supported method.
76708
+ */
76709
+ 501: MediaMediaError;
76710
+ /**
76711
+ * Request failed; see the error code reference.
76712
+ */
76713
+ 502: MediaMediaError;
76714
+ /**
76715
+ * Historical projections are still being initialized, or library storage is temporarily unavailable; retry shortly and check failureSummary counts_complete.
76716
+ */
76717
+ 503: MediaMediaError;
76718
+ };
76719
+ export type MediaSaveGenerationOutputError = MediaSaveGenerationOutputErrors[keyof MediaSaveGenerationOutputErrors];
76720
+ export type MediaSaveGenerationOutputResponses = {
76721
+ /**
76722
+ * Successful response.
76723
+ */
76724
+ 200: MediaAsset;
76725
+ };
76726
+ export type MediaSaveGenerationOutputResponse = MediaSaveGenerationOutputResponses[keyof MediaSaveGenerationOutputResponses];
76727
+ export type MediaGetGenerationCapabilitiesData = {
76728
+ body?: never;
76729
+ path?: never;
76730
+ query?: never;
76731
+ url: '/media/v1/generation/capabilities';
76732
+ };
76733
+ export type MediaGetGenerationCapabilitiesErrors = {
76734
+ /**
76735
+ * A selector, cursor, limit or other parameter is invalid; correct the reported field before retrying.
76736
+ */
76737
+ 400: MediaMediaError;
76738
+ /**
76739
+ * This credential has read-only access to the library; use a write-capable binding for mutations.
76740
+ */
76741
+ 403: MediaMediaError;
76742
+ /**
76743
+ * The library or asset is missing, deleted or belongs to another tenant; verify its identifier and owner.
76744
+ */
76745
+ 404: MediaMediaError;
76746
+ /**
76747
+ * Request failed; see the error code reference.
76748
+ */
76749
+ 409: MediaMediaError;
76750
+ /**
76751
+ * The file exceeds an input limit; provide a smaller source file.
76752
+ */
76753
+ 413: MediaMediaError;
76754
+ /**
76755
+ * This media format is unsupported; provide a supported format.
76756
+ */
76757
+ 415: MediaMediaError;
76758
+ /**
76759
+ * Request failed; see the error code reference.
76760
+ */
76761
+ 422: MediaMediaError;
76762
+ /**
76763
+ * A rate limit was reached; wait before retrying.
76764
+ */
76765
+ 429: MediaMediaError;
76766
+ /**
76767
+ * The requested operation is unsupported; choose a supported method.
76768
+ */
76769
+ 501: MediaMediaError;
76770
+ /**
76771
+ * Request failed; see the error code reference.
76772
+ */
76773
+ 502: MediaMediaError;
76774
+ /**
76775
+ * Historical projections are still being initialized, or library storage is temporarily unavailable; retry shortly and check failureSummary counts_complete.
76776
+ */
76777
+ 503: MediaMediaError;
76778
+ };
76779
+ export type MediaGetGenerationCapabilitiesError = MediaGetGenerationCapabilitiesErrors[keyof MediaGetGenerationCapabilitiesErrors];
76780
+ export type MediaGetGenerationCapabilitiesResponses = {
76781
+ /**
76782
+ * Successful response.
76783
+ */
76784
+ 200: MediaGenerationCapabilities;
76785
+ };
76786
+ export type MediaGetGenerationCapabilitiesResponse = MediaGetGenerationCapabilitiesResponses[keyof MediaGetGenerationCapabilitiesResponses];
76787
+ export type OntologyListTypesData = {
76788
+ body?: never;
76789
+ path?: never;
76790
+ query?: never;
76791
+ url: '/ontology/v1/types';
76792
+ };
76793
+ export type OntologyListTypesErrors = {
76794
+ /**
76795
+ * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
76796
+ */
76797
+ 401: OntologyOntologyError;
76798
+ /**
76799
+ * The API key lacks permission for this operation, or carries no organization; use a key with the required ontology access in the owning organization.
76800
+ */
76801
+ 403: OntologyOntologyError;
76802
+ /**
76803
+ * INTERNAL means the service could not complete the request; before retrying a write, read the graph back so a partially applied change is not sent twice.
76804
+ */
76805
+ 500: OntologyOntologyError;
76806
+ };
76807
+ export type OntologyListTypesError = OntologyListTypesErrors[keyof OntologyListTypesErrors];
76808
+ export type OntologyListTypesResponses = {
76809
+ /**
76810
+ * Every registration in force for this organization, in registration order.
76811
+ */
76812
+ 200: OntologyTypeRegistrationPage;
76813
+ };
76814
+ export type OntologyListTypesResponse = OntologyListTypesResponses[keyof OntologyListTypesResponses];
76815
+ export type OntologyRegisterTypeData = {
76816
+ /**
76817
+ * The registration to add; the same shape one registrant ships as its ontology.types.json.
76818
+ */
76819
+ body: OntologyTypeRegistration;
76820
+ path?: never;
76821
+ query?: never;
76822
+ url: '/ontology/v1/types';
76823
+ };
76824
+ export type OntologyRegisterTypeErrors = {
76825
+ /**
76826
+ * INVALID_PARAMS means a field, query value, header or identifier violates the documented format or range — a missing Idempotency-Key, an unknown direction, a non-numeric limit. Correct the indicated input; the message names what was wrong.
76827
+ */
76828
+ 400: OntologyOntologyError;
76829
+ /**
76830
+ * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
76831
+ */
76832
+ 401: OntologyOntologyError;
76833
+ /**
76834
+ * The API key lacks permission for this operation, or carries no organization; use a key with the required ontology access in the owning organization.
76835
+ */
76836
+ 403: OntologyOntologyError;
76837
+ /**
76838
+ * INTERNAL means the service could not complete the request; before retrying a write, read the graph back so a partially applied change is not sent twice.
76839
+ */
76840
+ 500: OntologyOntologyError;
76841
+ /**
76842
+ * NOT_IMPLEMENTED means runtime registration is not open; the deploy gate registers types. Nothing was written.
76843
+ */
76844
+ 501: OntologyOntologyError;
76845
+ };
76846
+ export type OntologyRegisterTypeError = OntologyRegisterTypeErrors[keyof OntologyRegisterTypeErrors];
76847
+ export type OntologyRetrieveTypeData = {
76848
+ body?: never;
76849
+ path: {
76850
+ /**
76851
+ * A type name from types.list, with its dots preserved — a display label is not accepted.
76852
+ */
76853
+ name: string;
76854
+ };
76855
+ query?: never;
76856
+ url: '/ontology/v1/types/{name}';
76857
+ };
76858
+ export type OntologyRetrieveTypeErrors = {
76859
+ /**
76860
+ * ONTOLOGY_TYPE_UNKNOWN means the named type is not registered for this organization; call types.list for the names in force before writing records of it.
76861
+ */
76862
+ 400: OntologyOntologyError;
76863
+ /**
76864
+ * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
76865
+ */
76866
+ 401: OntologyOntologyError;
76867
+ /**
76868
+ * The API key lacks permission for this operation, or carries no organization; use a key with the required ontology access in the owning organization.
76869
+ */
76870
+ 403: OntologyOntologyError;
76871
+ /**
76872
+ * INTERNAL means the service could not complete the request; before retrying a write, read the graph back so a partially applied change is not sent twice.
76873
+ */
76874
+ 500: OntologyOntologyError;
76875
+ };
76876
+ export type OntologyRetrieveTypeError = OntologyRetrieveTypeErrors[keyof OntologyRetrieveTypeErrors];
76877
+ export type OntologyRetrieveTypeResponses = {
76878
+ /**
76879
+ * The registration that carries this type, with its kind and definition.
76880
+ */
76881
+ 200: OntologyTypeLookup;
76882
+ };
76883
+ export type OntologyRetrieveTypeResponse = OntologyRetrieveTypeResponses[keyof OntologyRetrieveTypeResponses];
76884
+ export type OntologyListNodesData = {
76885
+ body?: never;
76886
+ path?: never;
76887
+ query?: {
76888
+ /**
76889
+ * Repeat to filter to any of several registered node type names, for example type=file&type=ticket; omit to list every type.
76890
+ */
76891
+ type?: Array<string>;
76892
+ /**
76893
+ * Free text matched against node names, aliases and descriptions; omit to list without a text filter.
76894
+ */
76895
+ q?: string;
76896
+ /**
76897
+ * Filter to nodes owned by this member id, or omit to list nodes of every owner; organization-wide nodes carry no owner.
76898
+ */
76899
+ owner?: string;
76900
+ /**
76901
+ * ISO 8601 timestamp; return the graph as it was then, so a node recorded later is absent. Omit to read current state.
76902
+ */
76903
+ as_of?: string;
76904
+ /**
76905
+ * Maximum items to return per page, from 1 to 100; defaults to 50 when omitted. Values above 100 are clamped to 100.
76906
+ */
76907
+ limit?: number;
76908
+ /**
76909
+ * Opaque next_cursor from the preceding list response; omit for the first page and stop when next_cursor is null.
76910
+ */
76911
+ cursor?: string;
76912
+ };
76913
+ url: '/ontology/v1/nodes';
76914
+ };
76915
+ export type OntologyListNodesErrors = {
76916
+ /**
76917
+ * INVALID_PARAMS means a field, query value, header or identifier violates the documented format or range — a missing Idempotency-Key, an unknown direction, a non-numeric limit. Correct the indicated input; the message names what was wrong.
76918
+ */
76919
+ 400: OntologyOntologyError;
76920
+ /**
76921
+ * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
76922
+ */
76923
+ 401: OntologyOntologyError;
76924
+ /**
76925
+ * The API key lacks permission for this operation, or carries no organization; use a key with the required ontology access in the owning organization.
76926
+ */
76927
+ 403: OntologyOntologyError;
76928
+ /**
76929
+ * INTERNAL means the service could not complete the request; before retrying a write, read the graph back so a partially applied change is not sent twice.
76930
+ */
76931
+ 500: OntologyOntologyError;
76932
+ };
76933
+ export type OntologyListNodesError = OntologyListNodesErrors[keyof OntologyListNodesErrors];
76934
+ export type OntologyListNodesResponses = {
76935
+ /**
76936
+ * One page of nodes, ordered by node id, with next_cursor null on the last page.
76937
+ */
76938
+ 200: OntologyNodePage;
76939
+ };
76940
+ export type OntologyListNodesResponse = OntologyListNodesResponses[keyof OntologyListNodesResponses];
76941
+ export type OntologyCreateNodeData = {
76942
+ /**
76943
+ * The entity to record; name, type and the optional identity of the mirrored record.
76944
+ */
76945
+ body: OntologyCreateNodeInput;
76946
+ headers: {
76947
+ /**
76948
+ * Unique key for this write, at most 255 characters; resend the same key to replay the first result instead of writing twice. A missing or blank key is refused 400.
76949
+ */
76950
+ 'Idempotency-Key': string;
76951
+ };
76952
+ path?: never;
76953
+ query?: never;
76954
+ url: '/ontology/v1/nodes';
76955
+ };
76956
+ export type OntologyCreateNodeErrors = {
76957
+ /**
76958
+ * INVALID_PARAMS means a field, query value, header or identifier violates the documented format or range — a missing Idempotency-Key, an unknown direction, a non-numeric limit. Correct the indicated input; the message names what was wrong.
76959
+ */
76960
+ 400: OntologyOntologyError;
76961
+ /**
76962
+ * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
76963
+ */
76964
+ 401: OntologyOntologyError;
76965
+ /**
76966
+ * The API key lacks permission for this operation, or carries no organization; use a key with the required ontology access in the owning organization.
76967
+ */
76968
+ 403: OntologyOntologyError;
76969
+ /**
76970
+ * ONTOLOGY_CONFLICT means the Idempotency-Key was already used with different content; reuse the original request for that key or send a new key for a different write.
76971
+ */
76972
+ 409: OntologyOntologyError;
76973
+ /**
76974
+ * ONTOLOGY_CAPACITY means this organization's graph is at its size budget; free space by invalidating facts that are no longer true before retrying.
76975
+ */
76976
+ 429: OntologyOntologyError;
76977
+ /**
76978
+ * INTERNAL means the service could not complete the request; before retrying a write, read the graph back so a partially applied change is not sent twice.
76979
+ */
76980
+ 500: OntologyOntologyError;
76981
+ };
76982
+ export type OntologyCreateNodeError = OntologyCreateNodeErrors[keyof OntologyCreateNodeErrors];
76983
+ export type OntologyCreateNodeResponses = {
76984
+ /**
76985
+ * The recorded node, with the id later reads, updates and relations use.
76986
+ */
76987
+ 201: OntologyNode;
76988
+ };
76989
+ export type OntologyCreateNodeResponse = OntologyCreateNodeResponses[keyof OntologyCreateNodeResponses];
76990
+ export type OntologyRetrieveNodeData = {
76991
+ body?: never;
76992
+ path: {
76993
+ /**
76994
+ * Node id returned by nodes.list, nodes.create or a changeset, in the form ond_ followed by 32 lowercase letters or digits; a name or an external record id is not accepted.
76995
+ */
76996
+ node_id: string;
76997
+ };
76998
+ query?: {
76999
+ /**
77000
+ * Set to relations to include the node's incoming and outgoing relations in the same response; omit for the node alone.
77001
+ */
77002
+ expand?: 'relations';
77003
+ /**
77004
+ * ISO 8601 timestamp; read the node and its relations as they were then, including relations invalidated since. Omit to read current state.
77005
+ */
77006
+ as_of?: string;
77007
+ };
77008
+ url: '/ontology/v1/nodes/{node_id}';
77009
+ };
77010
+ export type OntologyRetrieveNodeErrors = {
77011
+ /**
77012
+ * INVALID_PARAMS means a field, query value, header or identifier violates the documented format or range — a missing Idempotency-Key, an unknown direction, a non-numeric limit. Correct the indicated input; the message names what was wrong.
77013
+ */
77014
+ 400: OntologyOntologyError;
77015
+ /**
77016
+ * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
77017
+ */
77018
+ 401: OntologyOntologyError;
77019
+ /**
77020
+ * The API key lacks permission for this operation, or carries no organization; use a key with the required ontology access in the owning organization.
77021
+ */
77022
+ 403: OntologyOntologyError;
77023
+ /**
77024
+ * ONTOLOGY_NODE_NOT_FOUND means the node does not exist in this organization — never created, or owned by another organization; list nodes to find an id you can read.
77025
+ */
77026
+ 404: OntologyOntologyError;
77027
+ /**
77028
+ * INTERNAL means the service could not complete the request; before retrying a write, read the graph back so a partially applied change is not sent twice.
77029
+ */
77030
+ 500: OntologyOntologyError;
77031
+ };
77032
+ export type OntologyRetrieveNodeError = OntologyRetrieveNodeErrors[keyof OntologyRetrieveNodeErrors];
77033
+ export type OntologyRetrieveNodeResponses = {
77034
+ /**
77035
+ * The node, plus a relations array when expand=relations was requested.
77036
+ */
77037
+ 200: OntologyNodeWithRelations;
77038
+ };
77039
+ export type OntologyRetrieveNodeResponse = OntologyRetrieveNodeResponses[keyof OntologyRetrieveNodeResponses];
77040
+ export type OntologyUpdateNodeData = {
77041
+ /**
77042
+ * The fields to change; at least one of name, aliases or description.
77043
+ */
77044
+ body: OntologyUpdateNodeInput;
77045
+ path: {
77046
+ /**
77047
+ * Node id returned by nodes.list, nodes.create or a changeset, in the form ond_ followed by 32 lowercase letters or digits; a name or an external record id is not accepted.
77048
+ */
77049
+ node_id: string;
77050
+ };
77051
+ query?: never;
77052
+ url: '/ontology/v1/nodes/{node_id}';
77053
+ };
77054
+ export type OntologyUpdateNodeErrors = {
77055
+ /**
77056
+ * INVALID_PARAMS means a field, query value, header or identifier violates the documented format or range — a missing Idempotency-Key, an unknown direction, a non-numeric limit. Correct the indicated input; the message names what was wrong.
77057
+ */
77058
+ 400: OntologyOntologyError;
77059
+ /**
77060
+ * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
77061
+ */
77062
+ 401: OntologyOntologyError;
77063
+ /**
77064
+ * The API key lacks permission for this operation, or carries no organization; use a key with the required ontology access in the owning organization.
77065
+ */
77066
+ 403: OntologyOntologyError;
77067
+ /**
77068
+ * ONTOLOGY_NODE_NOT_FOUND means the node does not exist in this organization — never created, or owned by another organization; list nodes to find an id you can read.
77069
+ */
77070
+ 404: OntologyOntologyError;
77071
+ /**
77072
+ * INTERNAL means the service could not complete the request; before retrying a write, read the graph back so a partially applied change is not sent twice.
77073
+ */
77074
+ 500: OntologyOntologyError;
77075
+ };
77076
+ export type OntologyUpdateNodeError = OntologyUpdateNodeErrors[keyof OntologyUpdateNodeErrors];
77077
+ export type OntologyUpdateNodeResponses = {
77078
+ /**
77079
+ * The node after the update, with its new updated_at.
77080
+ */
77081
+ 200: OntologyNode;
77082
+ };
77083
+ export type OntologyUpdateNodeResponse = OntologyUpdateNodeResponses[keyof OntologyUpdateNodeResponses];
77084
+ export type OntologyMergeNodeData = {
77085
+ /**
77086
+ * The node the merged one folds into.
77087
+ */
77088
+ body: OntologyMergeNodeInput;
77089
+ headers: {
77090
+ /**
77091
+ * Unique key for this merge, at most 255 characters; resend the same key to replay the first result instead of merging twice.
77092
+ */
77093
+ 'Idempotency-Key': string;
77094
+ };
77095
+ path: {
77096
+ /**
77097
+ * Node id returned by nodes.list, nodes.create or a changeset, in the form ond_ followed by 32 lowercase letters or digits; a name or an external record id is not accepted.
77098
+ */
77099
+ node_id: string;
77100
+ };
77101
+ query?: never;
77102
+ url: '/ontology/v1/nodes/{node_id}/merge';
77103
+ };
77104
+ export type OntologyMergeNodeErrors = {
77105
+ /**
77106
+ * INVALID_PARAMS means a field, query value, header or identifier violates the documented format or range — a missing Idempotency-Key, an unknown direction, a non-numeric limit. Correct the indicated input; the message names what was wrong.
77107
+ */
77108
+ 400: OntologyOntologyError;
77109
+ /**
77110
+ * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
77111
+ */
77112
+ 401: OntologyOntologyError;
77113
+ /**
77114
+ * The API key lacks permission for this operation, or carries no organization; use a key with the required ontology access in the owning organization.
77115
+ */
77116
+ 403: OntologyOntologyError;
77117
+ /**
77118
+ * ONTOLOGY_NODE_NOT_FOUND means the node does not exist in this organization — never created, or owned by another organization; list nodes to find an id you can read.
77119
+ */
77120
+ 404: OntologyOntologyError;
77121
+ /**
77122
+ * ONTOLOGY_CONFLICT means the Idempotency-Key was already used with different content; reuse the original request for that key or send a new key for a different write.
77123
+ */
77124
+ 409: OntologyOntologyError;
77125
+ /**
77126
+ * INTERNAL means the service could not complete the request; before retrying a write, read the graph back so a partially applied change is not sent twice.
77127
+ */
77128
+ 500: OntologyOntologyError;
77129
+ };
77130
+ export type OntologyMergeNodeError = OntologyMergeNodeErrors[keyof OntologyMergeNodeErrors];
77131
+ export type OntologyMergeNodeResponses = {
77132
+ /**
77133
+ * The surviving node that the merged id now resolves to.
77134
+ */
77135
+ 200: OntologyNode;
77136
+ };
77137
+ export type OntologyMergeNodeResponse = OntologyMergeNodeResponses[keyof OntologyMergeNodeResponses];
77138
+ export type OntologyListRelationsData = {
77139
+ body?: never;
77140
+ path?: never;
77141
+ query?: {
77142
+ /**
77143
+ * A node id from nodes.list or nodes.create; returns the relations this node takes part in, narrowed by direction. Omit to list relations between every node.
77144
+ */
77145
+ node?: string;
77146
+ /**
77147
+ * Repeat to filter to any of several registered relation type names, for example type=references&type=serves; omit to list every type.
77148
+ */
77149
+ type?: Array<string>;
77150
+ /**
77151
+ * Which side of node to follow; out returns relations the node is the source of, in returns those it is the target of. Only meaningful together with node.
77152
+ */
77153
+ direction?: 'out' | 'in' | 'both';
77154
+ /**
77155
+ * ISO 8601 timestamp; read relations as they were then, so one recorded or invalidated later is judged by that time. Omit to read current state.
77156
+ */
77157
+ as_of?: string;
77158
+ /**
77159
+ * Set true to include relations whose invalid_at has passed, which is how a relation that stopped being true stays readable. Omit or false for currently valid relations only.
77160
+ */
77161
+ include_invalid?: boolean;
77162
+ /**
77163
+ * Maximum items to return per page, from 1 to 100; defaults to 50 when omitted. Values above 100 are clamped to 100.
77164
+ */
77165
+ limit?: number;
77166
+ /**
77167
+ * Opaque next_cursor from the preceding list response; omit for the first page and stop when next_cursor is null.
77168
+ */
77169
+ cursor?: string;
77170
+ };
77171
+ url: '/ontology/v1/relations';
77172
+ };
77173
+ export type OntologyListRelationsErrors = {
77174
+ /**
77175
+ * INVALID_PARAMS means a field, query value, header or identifier violates the documented format or range — a missing Idempotency-Key, an unknown direction, a non-numeric limit. Correct the indicated input; the message names what was wrong.
77176
+ */
77177
+ 400: OntologyOntologyError;
77178
+ /**
77179
+ * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
77180
+ */
77181
+ 401: OntologyOntologyError;
77182
+ /**
77183
+ * The API key lacks permission for this operation, or carries no organization; use a key with the required ontology access in the owning organization.
77184
+ */
77185
+ 403: OntologyOntologyError;
77186
+ /**
77187
+ * INTERNAL means the service could not complete the request; before retrying a write, read the graph back so a partially applied change is not sent twice.
77188
+ */
77189
+ 500: OntologyOntologyError;
77190
+ };
77191
+ export type OntologyListRelationsError = OntologyListRelationsErrors[keyof OntologyListRelationsErrors];
77192
+ export type OntologyListRelationsResponses = {
77193
+ /**
77194
+ * One page of relations, ordered by relation id, with next_cursor null on the last page.
77195
+ */
77196
+ 200: OntologyRelationPage;
77197
+ };
77198
+ export type OntologyListRelationsResponse = OntologyListRelationsResponses[keyof OntologyListRelationsResponses];
77199
+ export type OntologyCreateRelationData = {
77200
+ /**
77201
+ * The fact to record, between two node ids from this organization's graph.
77202
+ */
77203
+ body: OntologyCreateRelationInput;
77204
+ headers: {
77205
+ /**
77206
+ * Unique key for this write, at most 255 characters; resend the same key to replay the first result instead of writing twice. A missing or blank key is refused 400.
77207
+ */
77208
+ 'Idempotency-Key': string;
77209
+ };
77210
+ path?: never;
77211
+ query?: never;
77212
+ url: '/ontology/v1/relations';
77213
+ };
77214
+ export type OntologyCreateRelationErrors = {
77215
+ /**
77216
+ * INVALID_PARAMS means a field, query value, header or identifier violates the documented format or range — a missing Idempotency-Key, an unknown direction, a non-numeric limit. Correct the indicated input; the message names what was wrong.
77217
+ */
77218
+ 400: OntologyOntologyError;
77219
+ /**
77220
+ * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
77221
+ */
77222
+ 401: OntologyOntologyError;
77223
+ /**
77224
+ * The API key lacks permission for this operation, or carries no organization; use a key with the required ontology access in the owning organization.
77225
+ */
77226
+ 403: OntologyOntologyError;
77227
+ /**
77228
+ * ONTOLOGY_CONFLICT means the Idempotency-Key was already used with different content; reuse the original request for that key or send a new key for a different write.
77229
+ */
77230
+ 409: OntologyOntologyError;
77231
+ /**
77232
+ * ONTOLOGY_CAPACITY means this organization's graph is at its size budget; free space by invalidating facts that are no longer true before retrying.
77233
+ */
77234
+ 429: OntologyOntologyError;
77235
+ /**
77236
+ * INTERNAL means the service could not complete the request; before retrying a write, read the graph back so a partially applied change is not sent twice.
77237
+ */
77238
+ 500: OntologyOntologyError;
77239
+ };
77240
+ export type OntologyCreateRelationError = OntologyCreateRelationErrors[keyof OntologyCreateRelationErrors];
77241
+ export type OntologyCreateRelationResponses = {
77242
+ /**
77243
+ * The recorded relation, with the id later reads and invalidation use.
77244
+ */
77245
+ 201: OntologyRelation;
77246
+ };
77247
+ export type OntologyCreateRelationResponse = OntologyCreateRelationResponses[keyof OntologyCreateRelationResponses];
77248
+ export type OntologyRetrieveRelationData = {
77249
+ body?: never;
77250
+ path: {
77251
+ /**
77252
+ * Relation id returned by relations.list, relations.create or a changeset, in the form oed_ followed by 32 lowercase letters or digits; a node id is not accepted.
77253
+ */
77254
+ relation_id: string;
77255
+ };
77256
+ query?: never;
77257
+ url: '/ontology/v1/relations/{relation_id}';
77258
+ };
77259
+ export type OntologyRetrieveRelationErrors = {
77260
+ /**
77261
+ * INVALID_PARAMS means a field, query value, header or identifier violates the documented format or range — a missing Idempotency-Key, an unknown direction, a non-numeric limit. Correct the indicated input; the message names what was wrong.
77262
+ */
77263
+ 400: OntologyOntologyError;
77264
+ /**
77265
+ * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
77266
+ */
77267
+ 401: OntologyOntologyError;
77268
+ /**
77269
+ * The API key lacks permission for this operation, or carries no organization; use a key with the required ontology access in the owning organization.
77270
+ */
77271
+ 403: OntologyOntologyError;
77272
+ /**
77273
+ * ONTOLOGY_EDGE_NOT_FOUND means the relation does not exist in this organization, or its content belongs to another member; list relations for the ids you may read.
77274
+ */
77275
+ 404: OntologyOntologyError;
77276
+ /**
77277
+ * INTERNAL means the service could not complete the request; before retrying a write, read the graph back so a partially applied change is not sent twice.
77278
+ */
77279
+ 500: OntologyOntologyError;
77280
+ };
77281
+ export type OntologyRetrieveRelationError = OntologyRetrieveRelationErrors[keyof OntologyRetrieveRelationErrors];
77282
+ export type OntologyRetrieveRelationResponses = {
77283
+ /**
77284
+ * The relation, including its fact, endpoints and both clocks.
77285
+ */
77286
+ 200: OntologyRelation;
77287
+ };
77288
+ export type OntologyRetrieveRelationResponse = OntologyRetrieveRelationResponses[keyof OntologyRetrieveRelationResponses];
77289
+ export type OntologyInvalidateRelationData = {
77290
+ /**
77291
+ * When the fact stopped being true, and optionally what replaced it and why.
77292
+ */
77293
+ body: OntologyInvalidateRelationInput;
77294
+ headers: {
77295
+ /**
77296
+ * Unique key for this invalidation, at most 255 characters; resend the same key to replay the first result instead of invalidating twice.
77297
+ */
77298
+ 'Idempotency-Key': string;
77299
+ };
77300
+ path: {
77301
+ /**
77302
+ * Relation id returned by relations.list, relations.create or a changeset, in the form oed_ followed by 32 lowercase letters or digits; a node id is not accepted.
77303
+ */
77304
+ relation_id: string;
77305
+ };
77306
+ query?: never;
77307
+ url: '/ontology/v1/relations/{relation_id}/invalidate';
77308
+ };
77309
+ export type OntologyInvalidateRelationErrors = {
77310
+ /**
77311
+ * INVALID_PARAMS means a field, query value, header or identifier violates the documented format or range — a missing Idempotency-Key, an unknown direction, a non-numeric limit. Correct the indicated input; the message names what was wrong.
77312
+ */
77313
+ 400: OntologyOntologyError;
77314
+ /**
77315
+ * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
77316
+ */
77317
+ 401: OntologyOntologyError;
77318
+ /**
77319
+ * The API key lacks permission for this operation, or carries no organization; use a key with the required ontology access in the owning organization.
77320
+ */
77321
+ 403: OntologyOntologyError;
77322
+ /**
77323
+ * ONTOLOGY_EDGE_NOT_FOUND means the relation does not exist in this organization, or its content belongs to another member; list relations for the ids you may read.
77324
+ */
77325
+ 404: OntologyOntologyError;
77326
+ /**
77327
+ * ONTOLOGY_CONFLICT means the Idempotency-Key was already used with different content; reuse the original request for that key or send a new key for a different write.
77328
+ */
77329
+ 409: OntologyOntologyError;
77330
+ /**
77331
+ * INTERNAL means the service could not complete the request; before retrying a write, read the graph back so a partially applied change is not sent twice.
77332
+ */
77333
+ 500: OntologyOntologyError;
77334
+ };
77335
+ export type OntologyInvalidateRelationError = OntologyInvalidateRelationErrors[keyof OntologyInvalidateRelationErrors];
77336
+ export type OntologyInvalidateRelationResponses = {
77337
+ /**
77338
+ * The relation after invalidation, with invalid_at set to the given time.
77339
+ */
77340
+ 200: OntologyRelation;
77341
+ };
77342
+ export type OntologyInvalidateRelationResponse = OntologyInvalidateRelationResponses[keyof OntologyInvalidateRelationResponses];
77343
+ export type OntologyApplyChangesetData = {
77344
+ /**
77345
+ * The operations to apply together, with the world time they describe.
77346
+ */
77347
+ body: OntologyChangesetInput;
77348
+ headers: {
77349
+ /**
77350
+ * Unique key for this batch, at most 255 characters; resend the same key to replay the first result instead of writing the batch twice.
77351
+ */
77352
+ 'Idempotency-Key': string;
77353
+ };
77354
+ path?: never;
77355
+ query?: never;
77356
+ url: '/ontology/v1/changesets';
77357
+ };
77358
+ export type OntologyApplyChangesetErrors = {
77359
+ /**
77360
+ * INVALID_PARAMS means a field, query value, header or identifier violates the documented format or range — a missing Idempotency-Key, an unknown direction, a non-numeric limit. Correct the indicated input; the message names what was wrong.
77361
+ */
77362
+ 400: OntologyOntologyError;
77363
+ /**
77364
+ * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
77365
+ */
77366
+ 401: OntologyOntologyError;
77367
+ /**
77368
+ * The API key lacks permission for this operation, or carries no organization; use a key with the required ontology access in the owning organization.
77369
+ */
77370
+ 403: OntologyOntologyError;
77371
+ /**
77372
+ * ONTOLOGY_CONFLICT means the Idempotency-Key was already used with different content; reuse the original request for that key or send a new key for a different write.
77373
+ */
77374
+ 409: OntologyOntologyError;
77375
+ /**
77376
+ * ONTOLOGY_CAPACITY means this organization's graph is at its size budget; free space by invalidating facts that are no longer true before retrying.
77377
+ */
77378
+ 429: OntologyOntologyError;
77379
+ /**
77380
+ * INTERNAL means the service could not complete the request; before retrying a write, read the graph back so a partially applied change is not sent twice.
77381
+ */
77382
+ 500: OntologyOntologyError;
77383
+ };
77384
+ export type OntologyApplyChangesetError = OntologyApplyChangesetErrors[keyof OntologyApplyChangesetErrors];
77385
+ export type OntologyApplyChangesetResponses = {
77386
+ /**
77387
+ * The applied count, the ids assigned to the batch's keys, and replayed true when the key had been seen before.
77388
+ */
77389
+ 200: OntologyChangesetResult;
77390
+ };
77391
+ export type OntologyApplyChangesetResponse = OntologyApplyChangesetResponses[keyof OntologyApplyChangesetResponses];
77392
+ export type OntologySearchData = {
77393
+ /**
77394
+ * The text to resolve, optionally narrowed to particular node types and a result count.
77395
+ */
77396
+ body: OntologySearchInput;
77397
+ path?: never;
77398
+ query?: never;
77399
+ url: '/ontology/v1/search';
77400
+ };
77401
+ export type OntologySearchErrors = {
77402
+ /**
77403
+ * INVALID_PARAMS means a field, query value, header or identifier violates the documented format or range — a missing Idempotency-Key, an unknown direction, a non-numeric limit. Correct the indicated input; the message names what was wrong.
77404
+ */
77405
+ 400: OntologyOntologyError;
77406
+ /**
77407
+ * The bearer API key is missing or invalid; provide a valid Praxis API key before retrying.
77408
+ */
77409
+ 401: OntologyOntologyError;
77410
+ /**
77411
+ * The API key lacks permission for this operation, or carries no organization; use a key with the required ontology access in the owning organization.
77412
+ */
77413
+ 403: OntologyOntologyError;
77414
+ /**
77415
+ * INTERNAL means the service could not complete the request; before retrying a write, read the graph back so a partially applied change is not sent twice.
77416
+ */
77417
+ 500: OntologyOntologyError;
77418
+ };
77419
+ export type OntologySearchError = OntologySearchErrors[keyof OntologySearchErrors];
77420
+ export type OntologySearchResponses = {
77421
+ /**
77422
+ * Ranked candidate nodes, best match first, with the field each one matched on.
77423
+ */
77424
+ 200: OntologySearchResult;
77425
+ };
77426
+ export type OntologySearchResponse = OntologySearchResponses[keyof OntologySearchResponses];
74837
77427
  export type GetSandboxV1SandboxesData = {
74838
77428
  body?: never;
74839
77429
  path?: never;
@@ -75226,6 +77816,10 @@ export type ListSandboxTemplatesResponses = {
75226
77816
  buildCount: number;
75227
77817
  envdVersion: SandboxEnvdVersion;
75228
77818
  buildStatus: SandboxTemplateBuildStatus;
77819
+ /**
77820
+ * Lifecycle classes this template can run as. ephemeral: cannot pause, snapshot or mount volumes and is deleted when it stops; persistent: can pause, resume and snapshot.
77821
+ */
77822
+ lifecycles?: Array<'ephemeral' | 'persistent'>;
75229
77823
  /**
75230
77824
  * True for an official catalog template; false for your organization's custom templates.
75231
77825
  */
@@ -77429,7 +80023,7 @@ export type TicketGetTicketsData = {
77429
80023
  */
77430
80024
  page_token?: string;
77431
80025
  /**
77432
- * Filter expression.
80026
+ * Filter expression using field:value qualifiers, such as is:open milestone:5.
77433
80027
  */
77434
80028
  filter?: string;
77435
80029
  };
@@ -79848,7 +82442,7 @@ export type TicketGetActivityData = {
79848
82442
  */
79849
82443
  page_token?: string;
79850
82444
  /**
79851
- * Filter expression.
82445
+ * Activity filter expression.
79852
82446
  */
79853
82447
  filter?: string;
79854
82448
  };