node-autotask 0.76.0 → 0.78.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/MCP_TOOL_CATALOG.json +265 -9
  3. package/README.md +1 -1
  4. package/capabilities.json +1224 -272
  5. package/dist/capabilities-data.js +1223 -271
  6. package/dist/capabilities.cjs +4 -4
  7. package/dist/capabilities.js +1 -1
  8. package/dist/{chunk-S7QPD6TR.js → chunk-3SYNF5QD.js} +2 -2
  9. package/dist/{chunk-C4S3EKIK.cjs → chunk-MVKI2AZX.cjs} +3 -3
  10. package/dist/{chunk-UFK7JYYC.js → chunk-S7BJNQ2X.js} +4 -2
  11. package/dist/{chunk-Y4BH5N6R.cjs → chunk-S7JH6K2Z.cjs} +331 -28
  12. package/dist/{chunk-YRTOAPWD.cjs → chunk-U7LVWEO4.cjs} +199 -199
  13. package/dist/{chunk-3SFIKG2R.js → chunk-XBT332X7.js} +326 -23
  14. package/dist/{chunk-ECSE6B3U.js → chunk-YH5UCY2X.js} +3 -3
  15. package/dist/{chunk-55BQEFBO.cjs → chunk-YONRIG6F.cjs} +32 -30
  16. package/dist/{index-BbAzrm2i.d.cts → index-BHqdOo_5.d.cts} +91 -1
  17. package/dist/{index-BbAzrm2i.d.ts → index-BHqdOo_5.d.ts} +91 -1
  18. package/dist/{index-MY7qYY5d.d.cts → index-DfcdtQO0.d.cts} +4 -2
  19. package/dist/{index-CY7exGOe.d.ts → index-ci3TSJrT.d.ts} +4 -2
  20. package/dist/index.cjs +84 -84
  21. package/dist/index.d.cts +3 -3
  22. package/dist/index.d.ts +3 -3
  23. package/dist/index.js +5 -5
  24. package/dist/operations/index.cjs +51 -51
  25. package/dist/operations/index.d.cts +4 -4
  26. package/dist/operations/index.d.ts +4 -4
  27. package/dist/operations/index.js +2 -2
  28. package/dist/pool.cjs +12 -12
  29. package/dist/pool.d.cts +1 -1
  30. package/dist/pool.d.ts +1 -1
  31. package/dist/pool.js +4 -4
  32. package/dist/resources/index.cjs +27 -27
  33. package/dist/resources/index.d.cts +2 -2
  34. package/dist/resources/index.d.ts +2 -2
  35. package/dist/resources/index.js +3 -3
  36. package/dist/types/index.d.cts +1 -1
  37. package/dist/types/index.d.ts +1 -1
  38. package/docs/API.md +4 -2
  39. package/package.json +1 -1
@@ -410,8 +410,8 @@ const CAPABILITY_DATA = {
410
410
  ],
411
411
  "groups": {
412
412
  "B": {
413
- "planHash": "ad752908bb8c2b868f1df63ba52fd308bd4eaec8e6c9c9182f97504ad79f5ca4",
414
- "builtAt": "2026-11-19T03:48:00.874Z",
413
+ "planHash": "a84c111cf8c415f470fc48dff7ad406f0f67ee9c2a8d75f963e4812e5a2577b2",
414
+ "builtAt": "2026-11-19T06:42:18.402Z",
415
415
  "records": [
416
416
  {
417
417
  "id": "appointments.count",
@@ -43326,8 +43326,8 @@ const CAPABILITY_DATA = {
43326
43326
  ]
43327
43327
  },
43328
43328
  "A": {
43329
- "planHash": "ad752908bb8c2b868f1df63ba52fd308bd4eaec8e6c9c9182f97504ad79f5ca4",
43330
- "builtAt": "2026-11-19T03:48:00.874Z",
43329
+ "planHash": "a84c111cf8c415f470fc48dff7ad406f0f67ee9c2a8d75f963e4812e5a2577b2",
43330
+ "builtAt": "2026-11-19T06:42:18.403Z",
43331
43331
  "records": [
43332
43332
  {
43333
43333
  "id": "attachment_info.count",
@@ -49633,12 +49633,12 @@ const CAPABILITY_DATA = {
49633
49633
  "status": "tested"
49634
49634
  },
49635
49635
  {
49636
- "id": "configuration_item_billing_product_associations.count",
49637
- "resource": "configuration_item_billing_product_associations",
49636
+ "id": "configuration_item_attachments.count",
49637
+ "resource": "configuration_item_attachments",
49638
49638
  "udfCapable": false,
49639
49639
  "operation": "count",
49640
49640
  "kind": "primitive",
49641
- "endpoint": "GET|POST /V1.0/ConfigurationItemBillingProductAssociations/query/count",
49641
+ "endpoint": "GET|POST /V1.0/ConfigurationItemAttachments/query/count",
49642
49642
  "effect": "read",
49643
49643
  "flags": [],
49644
49644
  "dryRun": false,
@@ -49668,7 +49668,7 @@ const CAPABILITY_DATA = {
49668
49668
  "drops": []
49669
49669
  },
49670
49670
  "examples": [
49671
- "await client.configurationItemBillingProductAssociations.count({ filter: [{ field: 'name', op: 'eq', value: 'example' }] })"
49671
+ "await invoke(client, 'configuration_item_attachments.count', [{ filter: [{ field: 'configurationItemID', op: 'eq', value: 7 }] }])"
49672
49672
  ],
49673
49673
  "permissions": "unknown",
49674
49674
  "pagination": {
@@ -49682,24 +49682,27 @@ const CAPABILITY_DATA = {
49682
49682
  "set": 0
49683
49683
  },
49684
49684
  "metadata": {
49685
- "purpose": "Count billing product association records matching a JSON filter. (under a configuration item)",
49686
- "usage": "Unwraps queryCount; returns a plain number.",
49685
+ "purpose": "Count configuration item attachment records matching a JSON filter. Use configurationItemID for item scope.",
49686
+ "usage": "Unwraps queryCount; returns a plain number. Include an object-specific configurationItemID filter. configurationItemNoteID is a separate read-only association; do not substitute it for the path parent. creatorType, data and fileSize are not queryable. Object-specific filters do not establish exact direct-parent attachment membership; an empty result is conditional on API-user permissions and visibility.",
49687
49687
  "preferredWhen": null,
49688
49688
  "related": [
49689
- "configuration_item_billing_product_associations.query"
49689
+ "configuration_item_attachments.query"
49690
49690
  ],
49691
- "args": "args[0] is a params object (CLOSED — unknown keys are refused pre-request): { filter?: FilterCondition[], fieldCheck?: boolean } — filter is the only parameter sent to the vendor (the count endpoint takes no MaxRecords/IncludeFields; fieldCheck is consumed by the invoke router — never sent to the vendor). Filter condition field names are name-checked pre-request the same way as the query bag: a refusal costs zero /query/count wire (the cold fieldCache may cost the one authority metadata GET first). fieldCheck: false disables the name check (a non-boolean is refused pre-request; the shape/grammar checks always run) — the opt-out works on the count verb too. Filter grammar: 13 operators: eq, noteq, gt, gte, lt, lte, beginsWith, endsWith, contains, exist, notExist, in, notIn (in/notIn: array or '1,2,3') + and/or grouping (no not-group). Field names in vendor API casing — get them via operations.fieldCatalog. Caps: 500 OR-conditions / 1 UDF / 8000 chars."
49691
+ "args": "args[0] is a params object (CLOSED — unknown keys are refused pre-request): { filter?: FilterCondition[], fieldCheck?: boolean } — filter is the only parameter sent to the vendor (the count endpoint takes no MaxRecords/IncludeFields; fieldCheck is consumed by the invoke router — never sent to the vendor). Filter condition field names are name-checked pre-request the same way as the query bag: a refusal costs zero /query/count wire (the cold fieldCache may cost the one authority metadata GET first). fieldCheck: false disables the name check (a non-boolean is refused pre-request; the shape/grammar checks always run) — the opt-out works on the count verb too. Filter grammar: 13 operators: eq, noteq, gt, gte, lt, lte, beginsWith, endsWith, contains, exist, notExist, in, notIn (in/notIn: array or '1,2,3') + and/or grouping (no not-group). Field names in vendor API casing — get them via operations.fieldCatalog. Caps: 500 OR-conditions / 1 UDF / 8000 chars.",
49692
+ "untrustedFields": [
49693
+ "title"
49694
+ ]
49692
49695
  },
49693
49696
  "compact": null,
49694
49697
  "status": "tested"
49695
49698
  },
49696
49699
  {
49697
- "id": "configuration_item_billing_product_associations.create",
49698
- "resource": "configuration_item_billing_product_associations",
49700
+ "id": "configuration_item_attachments.create",
49701
+ "resource": "configuration_item_attachments",
49699
49702
  "udfCapable": false,
49700
49703
  "operation": "create",
49701
49704
  "kind": "primitive",
49702
- "endpoint": "POST /V1.0/ConfigurationItems/{parentId}/BillingProductAssociations",
49705
+ "endpoint": "POST /V1.0/ConfigurationItems/{parentId}/Attachments",
49703
49706
  "effect": "write",
49704
49707
  "flags": [],
49705
49708
  "dryRun": true,
@@ -49722,7 +49725,7 @@ const CAPABILITY_DATA = {
49722
49725
  "drops": []
49723
49726
  },
49724
49727
  "examples": [
49725
- "await client.configurationItemBillingProductAssociations.create('example-value', { name: 'example' }, { dryRun: true })"
49728
+ "const fields = await client.configurationItemAttachments.getFieldInfo();\nconst values = fields.find(field => field.name === 'publish')?.picklistValues?.filter(value => value.isActive === true && /^-?\\d+$/.test(value.value) && Number.isSafeInteger(Number(value.value)));\nif (!values?.length) throw new Error('No active numeric publish value is exposed');\nawait client.configurationItemAttachments.create(7, { attachmentType: 'FILE_ATTACHMENT', fullPath: 'note.txt', title: 'Supporting note', publish: Number(values[0].value), data: 'bm90ZQ==' }, { dryRun: true });"
49726
49729
  ],
49727
49730
  "permissions": "unknown",
49728
49731
  "pagination": {
@@ -49736,30 +49739,58 @@ const CAPABILITY_DATA = {
49736
49739
  "set": 1
49737
49740
  },
49738
49741
  "metadata": {
49739
- "purpose": "Create a billing product association. (under a configuration item)",
49740
- "usage": "Returns OperationResultModel.itemId (the new id); the full record is not returned — follow up with get where needed. Parent-scoped: parentId is a path parameter.",
49741
- "preferredWhen": "Only for a record that does not exist yet; prefer update for an id you already have.",
49742
+ "purpose": "Create a file attachment under a configuration item.",
49743
+ "usage": "Create a file attachment under ConfigurationItems/{parentId}/Attachments. Required: attachmentType FILE_ATTACHMENT, title and fullPath (at most 255 characters), numeric publish from current metadata, and base64 data. Existing attachments cannot be updated. Read-only configurationItemNoteID is distinct from the configurationItemID path parent. Optional parentAttachmentID requests documented nesting; the vendor validates membership, permissions, impersonation and file limits. The API file limit is 6–7 MB and 10,000,000 bytes per five minutes, with a five-minute creation pause when exceeded. Exact-parent deduplication is unproven; createIfNotExists is unsupported. No live create is claimed.",
49744
+ "preferredWhen": "Add a new attachment; existing attachments cannot be updated. Replace through separately governed delete and create actions.",
49742
49745
  "related": [
49743
- "configuration_item_billing_product_associations.update"
49744
- ]
49746
+ "configuration_item_attachments.get"
49747
+ ],
49748
+ "argNotes": {
49749
+ "data": "File uploads only. Read-only audit, parent/note associations, contentType, creatorType and fileSize are not accepted create inputs. Contact impersonation is not documented for assets; resource impersonation uses configured ImpersonationResourceID header, not attachedByResourceID in this body. Optional parentAttachmentID requests documented nesting; the vendor validates membership. Other attachment types and UDF writes are unsupported."
49750
+ },
49751
+ "untrustedFields": [
49752
+ "title"
49753
+ ],
49754
+ "createRequirements": {
49755
+ "requires": {
49756
+ "allOf": [
49757
+ "attachmentType",
49758
+ "fullPath",
49759
+ "title",
49760
+ "publish",
49761
+ "data"
49762
+ ]
49763
+ },
49764
+ "requiresByValue": [
49765
+ {
49766
+ "field": "attachmentType",
49767
+ "value": "FILE_ATTACHMENT",
49768
+ "requires": {
49769
+ "allOf": [
49770
+ "data"
49771
+ ]
49772
+ }
49773
+ }
49774
+ ]
49775
+ }
49745
49776
  },
49746
49777
  "compact": null,
49747
49778
  "status": "tested"
49748
49779
  },
49749
49780
  {
49750
- "id": "configuration_item_billing_product_associations.delete",
49751
- "resource": "configuration_item_billing_product_associations",
49781
+ "id": "configuration_item_attachments.delete",
49782
+ "resource": "configuration_item_attachments",
49752
49783
  "udfCapable": false,
49753
49784
  "operation": "delete",
49754
49785
  "kind": "primitive",
49755
- "endpoint": "DELETE /V1.0/ConfigurationItems/{parentId}/BillingProductAssociations/{id}",
49786
+ "endpoint": "DELETE /V1.0/ConfigurationItems/{parentId}/Attachments/{id}",
49756
49787
  "effect": "destructive",
49757
49788
  "flags": [
49758
49789
  "idempotent",
49759
49790
  "requiresApproval"
49760
49791
  ],
49761
49792
  "dryRun": true,
49762
- "envelope": "OperationResultModel",
49793
+ "envelope": "OperationResultModel (attachment entities: the deleted attachment model is returned, not OperationResultModel)",
49763
49794
  "inputSchema": {
49764
49795
  "parentId": {
49765
49796
  "type": "string | number",
@@ -49774,11 +49805,11 @@ const CAPABILITY_DATA = {
49774
49805
  },
49775
49806
  "inputSchemaStrict": true,
49776
49807
  "outputSchema": {
49777
- "type": "OperationResultModel",
49808
+ "type": "OperationResultModel (attachment entities: the deleted attachment model is returned, not OperationResultModel)",
49778
49809
  "drops": []
49779
49810
  },
49780
49811
  "examples": [
49781
- "await invoke(client, 'configuration_item_billing_product_associations.delete', ['example-value', 'example-value'], { dryRun: false, confirm: 'configuration_item_billing_product_associations.delete' })"
49812
+ "await invoke(client, 'configuration_item_attachments.delete', [7, 3], { confirm: 'configuration_item_attachments.delete' })"
49782
49813
  ],
49783
49814
  "permissions": "unknown",
49784
49815
  "pagination": {
@@ -49792,27 +49823,30 @@ const CAPABILITY_DATA = {
49792
49823
  "set": 2
49793
49824
  },
49794
49825
  "metadata": {
49795
- "purpose": "Delete a billing product association. (under a configuration item)",
49826
+ "purpose": "Delete an attachment under a configuration item.",
49796
49827
  "usage": "Irreversible; dry-run validates the target id first. Parent-scoped: parentId + id.",
49797
49828
  "preferredWhen": null,
49798
49829
  "related": [
49799
- "configuration_item_billing_product_associations.get"
49830
+ "configuration_item_attachments.get"
49831
+ ],
49832
+ "untrustedFields": [
49833
+ "title"
49800
49834
  ]
49801
49835
  },
49802
49836
  "compact": null,
49803
49837
  "status": "tested"
49804
49838
  },
49805
49839
  {
49806
- "id": "configuration_item_billing_product_associations.get",
49807
- "resource": "configuration_item_billing_product_associations",
49840
+ "id": "configuration_item_attachments.get",
49841
+ "resource": "configuration_item_attachments",
49808
49842
  "udfCapable": false,
49809
49843
  "operation": "get",
49810
49844
  "kind": "primitive",
49811
- "endpoint": "GET /V1.0/ConfigurationItems/{parentId}/BillingProductAssociations/{id}",
49845
+ "endpoint": "GET /V1.0/ConfigurationItems/{parentId}/Attachments/{id}",
49812
49846
  "effect": "read",
49813
49847
  "flags": [],
49814
49848
  "dryRun": false,
49815
- "envelope": "ItemQueryResultModel[ConfigurationItemBillingProductAssociationModel,InstalledProductBillingProductAssociation]",
49849
+ "envelope": "ConfigurationItemAttachmentModel",
49816
49850
  "inputSchema": {
49817
49851
  "parentId": {
49818
49852
  "type": "string | number",
@@ -49839,11 +49873,11 @@ const CAPABILITY_DATA = {
49839
49873
  },
49840
49874
  "inputSchemaStrict": true,
49841
49875
  "outputSchema": {
49842
- "type": "ItemQueryResultModel[ConfigurationItemBillingProductAssociationModel,InstalledProductBillingProductAssociation]",
49876
+ "type": "ConfigurationItemAttachmentModel",
49843
49877
  "drops": []
49844
49878
  },
49845
49879
  "examples": [
49846
- "await client.configurationItemBillingProductAssociations.get('example-value', 'example-value')"
49880
+ "await client.configurationItemAttachments.get(7, 3)"
49847
49881
  ],
49848
49882
  "permissions": "unknown",
49849
49883
  "pagination": {
@@ -49857,24 +49891,27 @@ const CAPABILITY_DATA = {
49857
49891
  "set": 3
49858
49892
  },
49859
49893
  "metadata": {
49860
- "purpose": "Get one ConfigurationItemBillingProductAssociations by id.",
49861
- "usage": "item: null on the 200 body maps to NotFoundError (vendor not-found signal). Parent-scoped: parentId + id.",
49862
- "preferredWhen": "Preferred when the numeric id is already known; configuration_item_billing_product_associations.resolve is for a field value.",
49894
+ "purpose": "Get one ConfigurationItemAttachment by id.",
49895
+ "usage": "Returns the attachment model directly; item: null or an empty model is a typed not-found. Parent-scoped: parentId is the configuration-item id, followed by the attachment id.",
49896
+ "preferredWhen": "Use a known attachment id; query the scoped collection to discover ids.",
49863
49897
  "related": [
49864
- "configuration_item_billing_product_associations.resolve"
49898
+ "configuration_item_attachments.query"
49865
49899
  ],
49866
- "args": "args are (parentId: number, id: number) Item GET returns the FULL vendor model — the vendor documents no field selection on single-record reads. For a slim record use a configuration_item_billing_product_associations.query with includeFields."
49900
+ "args": "args are (parentId: number, id: number) Item GET returns the FULL vendor model — the vendor documents no field selection on single-record reads. For a slim record use a configuration_item_attachments.query with includeFields.",
49901
+ "untrustedFields": [
49902
+ "title"
49903
+ ]
49867
49904
  },
49868
49905
  "compact": null,
49869
49906
  "status": "tested"
49870
49907
  },
49871
49908
  {
49872
- "id": "configuration_item_billing_product_associations.getEntityInfo",
49873
- "resource": "configuration_item_billing_product_associations",
49909
+ "id": "configuration_item_attachments.getEntityInfo",
49910
+ "resource": "configuration_item_attachments",
49874
49911
  "udfCapable": false,
49875
49912
  "operation": "getEntityInfo",
49876
49913
  "kind": "primitive",
49877
- "endpoint": "GET /V1.0/ConfigurationItemBillingProductAssociations/entityInformation",
49914
+ "endpoint": "GET /V1.0/ConfigurationItemAttachments/entityInformation",
49878
49915
  "effect": "read",
49879
49916
  "flags": [],
49880
49917
  "dryRun": false,
@@ -49886,7 +49923,7 @@ const CAPABILITY_DATA = {
49886
49923
  "drops": []
49887
49924
  },
49888
49925
  "examples": [
49889
- "await client.configurationItemBillingProductAssociations.getEntityInfo()"
49926
+ "await client.configurationItemAttachments.getEntityInfo()"
49890
49927
  ],
49891
49928
  "permissions": "unknown",
49892
49929
  "pagination": {
@@ -49900,23 +49937,26 @@ const CAPABILITY_DATA = {
49900
49937
  "set": 0
49901
49938
  },
49902
49939
  "metadata": {
49903
- "purpose": "Get the ConfigurationItemBillingProductAssociations capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
49940
+ "purpose": "Get the ConfigurationItemAttachment capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
49904
49941
  "usage": "Unwraps info{}; drives client-side capability checks.",
49905
49942
  "preferredWhen": null,
49906
49943
  "related": [
49907
- "configuration_item_billing_product_associations.getFieldInfo"
49944
+ "configuration_item_attachments.getFieldInfo"
49945
+ ],
49946
+ "untrustedFields": [
49947
+ "title"
49908
49948
  ]
49909
49949
  },
49910
49950
  "compact": null,
49911
49951
  "status": "tested"
49912
49952
  },
49913
49953
  {
49914
- "id": "configuration_item_billing_product_associations.getFieldInfo",
49915
- "resource": "configuration_item_billing_product_associations",
49954
+ "id": "configuration_item_attachments.getFieldInfo",
49955
+ "resource": "configuration_item_attachments",
49916
49956
  "udfCapable": false,
49917
49957
  "operation": "getFieldInfo",
49918
49958
  "kind": "primitive",
49919
- "endpoint": "GET /V1.0/ConfigurationItemBillingProductAssociations/entityInformation/fields",
49959
+ "endpoint": "GET /V1.0/ConfigurationItemAttachments/entityInformation/fields",
49920
49960
  "effect": "read",
49921
49961
  "flags": [],
49922
49962
  "dryRun": false,
@@ -49928,7 +49968,7 @@ const CAPABILITY_DATA = {
49928
49968
  "drops": []
49929
49969
  },
49930
49970
  "examples": [
49931
- "await client.configurationItemBillingProductAssociations.getFieldInfo()"
49971
+ "await client.configurationItemAttachments.getFieldInfo()"
49932
49972
  ],
49933
49973
  "permissions": "unknown",
49934
49974
  "pagination": {
@@ -49942,66 +49982,26 @@ const CAPABILITY_DATA = {
49942
49982
  "set": 0
49943
49983
  },
49944
49984
  "metadata": {
49945
- "purpose": "Get the ConfigurationItemBillingProductAssociations field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
49985
+ "purpose": "Get the ConfigurationItemAttachment field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
49946
49986
  "usage": "Unwraps fields[]; full raw field dump — the largest read of the info trio (compact discovery: operations.fieldCatalog); the raw dump is also the basis for UDF handling.",
49947
49987
  "preferredWhen": null,
49948
49988
  "related": [
49949
- "configuration_item_billing_product_associations.getEntityInfo",
49950
- "configuration_item_billing_product_associations.getUdfInfo"
49951
- ]
49952
- },
49953
- "compact": null,
49954
- "status": "tested"
49955
- },
49956
- {
49957
- "id": "configuration_item_billing_product_associations.getUdfInfo",
49958
- "resource": "configuration_item_billing_product_associations",
49959
- "udfCapable": false,
49960
- "operation": "getUdfInfo",
49961
- "kind": "primitive",
49962
- "endpoint": "GET /V1.0/ConfigurationItemBillingProductAssociations/entityInformation/userDefinedFields",
49963
- "effect": "read",
49964
- "flags": [],
49965
- "dryRun": false,
49966
- "envelope": "UserDefinedFieldInformationResultModel",
49967
- "inputSchema": {},
49968
- "inputSchemaStrict": true,
49969
- "outputSchema": {
49970
- "type": "UserDefinedFieldInformationResultModel",
49971
- "drops": []
49972
- },
49973
- "examples": [
49974
- "await client.configurationItemBillingProductAssociations.getUdfInfo()"
49975
- ],
49976
- "permissions": "unknown",
49977
- "pagination": {
49978
- "mode": "none"
49979
- },
49980
- "resolution": null,
49981
- "retry": {
49982
- "preset": "retry-ffb3a9cb"
49983
- },
49984
- "errors": {
49985
- "set": 0
49986
- },
49987
- "metadata": {
49988
- "purpose": "Get the ConfigurationItemBillingProductAssociations user-defined-field catalog.",
49989
- "usage": "Unwraps fields[]; only meaningful where the entity is UDF-capable. (entity is not UDF-capable; catalog is expected empty).",
49990
- "preferredWhen": null,
49991
- "related": [
49992
- "configuration_item_billing_product_associations.getFieldInfo"
49989
+ "configuration_item_attachments.getEntityInfo"
49990
+ ],
49991
+ "untrustedFields": [
49992
+ "title"
49993
49993
  ]
49994
49994
  },
49995
49995
  "compact": null,
49996
49996
  "status": "tested"
49997
49997
  },
49998
49998
  {
49999
- "id": "configuration_item_billing_product_associations.query",
50000
- "resource": "configuration_item_billing_product_associations",
49999
+ "id": "configuration_item_attachments.query",
50000
+ "resource": "configuration_item_attachments",
50001
50001
  "udfCapable": false,
50002
50002
  "operation": "query",
50003
50003
  "kind": "primitive",
50004
- "endpoint": "GET|POST /V1.0/ConfigurationItemBillingProductAssociations/query",
50004
+ "endpoint": "GET|POST /V1.0/ConfigurationItemAttachments/query",
50005
50005
  "effect": "read",
50006
50006
  "flags": [],
50007
50007
  "dryRun": false,
@@ -50073,7 +50073,7 @@ const CAPABILITY_DATA = {
50073
50073
  "drops": []
50074
50074
  },
50075
50075
  "examples": [
50076
- "await client.configurationItemBillingProductAssociations.query({ filter: [{ field: 'name', op: 'eq', value: 'example' }], limit: 500 })"
50076
+ "await invoke(client, 'configuration_item_attachments.query', [{ filter: [{ field: 'configurationItemID', op: 'eq', value: 7 }], limit: 25 }])"
50077
50077
  ],
50078
50078
  "permissions": "unknown",
50079
50079
  "pagination": {
@@ -50094,41 +50094,44 @@ const CAPABILITY_DATA = {
50094
50094
  "set": 4
50095
50095
  },
50096
50096
  "metadata": {
50097
- "purpose": "Query ConfigurationItemBillingProductAssociations records with a JSON filter.",
50098
- "usage": "Server-side pagination: one call walks the vendor cursor internally (page 1 POSTs the QueryModel body with MaxRecords = the walk's internal page size (at most 500; the default POST path — `via: 'get'` issues a GET on page 1); later pages POST the SAME body — IncludeFields, MaxRecords and the preserved filter — to the absolute vendor cursor, rebased to the client base URL; the vendor honours IncludeFields on a continuation and ignores MaxRecords there, so a later page carries the vendor's own page size) until the limit is met or the cursor is null; 1000-page guard (hasMore stays true at the guard). queryAll is the unbounded raw walk — only when you need the ENTIRE set and accept a large payload; default to the bounded query op. noteChars: N (integer >= 1) is an opt-in per-field char cap on the untrusted-class free-text fields of the resource (notes/descriptions/UDF prose — the same set the server wraps): each capped value = the first N chars + the explicit marker … [+N chars truncated] (N = chars removed), applied at result-build BEFORE the server-side untrusted wrapper; absent = the raw, untruncated result (zero wire — response-side only). latest: N returns the N highest-id rows (id-descending): the vendor has no sort parameter — this is the only ordering channel, and a date window in `filter` narrows the cost; count-anchored — C ≤ 2500 → one count + a ≤6-page walk of the matching set, C > 2500 → count probes + an id-threshold window (≤64 probes; LATEST_THRESHOLD_UNRESOLVED on budget exhaustion), a blind count → a bounded walk with the blind-surface stamp (LATEST_WINDOW_INCOMPLETE on a truncated walk). Parent-scoped entity: the query stays global (filter with configurationItemID eq <parentId> where the parent is known). Explicit walk.maxRows independently sets the TOTAL returned-row cap (including export-sized walks); the ordinary limit is still validated in 1..2500 and only bounds the internal page size for this form. hasMore and truncated remain true at the page guard or while a cursor or unserved fetched rows remain. Self-resource prefixes are accepted in filter fields and includeFields; dotted UDF names are always refused before metadata or vendor requests, never rewritten to another tenant UDF.",
50097
+ "purpose": "Query ConfigurationItemAttachment records with a JSON filter.",
50098
+ "usage": "Server-side pagination: one call walks the vendor cursor internally (page 1 POSTs the QueryModel body with MaxRecords = the walk's internal page size (at most 500; the default POST path — `via: 'get'` issues a GET on page 1); later pages POST the SAME body — IncludeFields, MaxRecords and the preserved filter — to the absolute vendor cursor, rebased to the client base URL; the vendor honours IncludeFields on a continuation and ignores MaxRecords there, so a later page carries the vendor's own page size) until the limit is met or the cursor is null; 1000-page guard (hasMore stays true at the guard). queryAll is the unbounded raw walk — only when you need the ENTIRE set and accept a large payload; default to the bounded query op. noteChars: N (integer >= 1) is an opt-in per-field char cap on the untrusted-class free-text fields of the resource (notes/descriptions/UDF prose — the same set the server wraps): each capped value = the first N chars + the explicit marker … [+N chars truncated] (N = chars removed), applied at result-build BEFORE the server-side untrusted wrapper; absent = the raw, untruncated result (zero wire — response-side only). latest: N returns the N highest-id rows (id-descending): the vendor has no sort parameter — this is the only ordering channel, and a date window in `filter` narrows the cost; count-anchored — C ≤ 2500 → one count + a ≤6-page walk of the matching set, C > 2500 → count probes + an id-threshold window (≤64 probes; LATEST_THRESHOLD_UNRESOLVED on budget exhaustion), a blind count → a bounded walk with the blind-surface stamp (LATEST_WINDOW_INCOMPLETE on a truncated walk). Parent-scoped entity: the query stays global (filter with configurationItemID eq <parentId> where the parent is known). Explicit walk.maxRows independently sets the TOTAL returned-row cap (including export-sized walks); the ordinary limit is still validated in 1..2500 and only bounds the internal page size for this form. hasMore and truncated remain true at the page guard or while a cursor or unserved fetched rows remain. Self-resource prefixes are accepted in filter fields and includeFields; dotted UDF names are always refused before metadata or vendor requests, never rewritten to another tenant UDF. Include an object-specific configurationItemID filter. configurationItemNoteID is a separate read-only association; do not substitute it for the path parent. creatorType, data and fileSize are not queryable. Object-specific filters do not establish exact direct-parent attachment membership; an empty result is conditional on API-user permissions and visibility. The Swagger query response names an attachment model, while this collection uses the existing SDK attachment query contract { items, pageDetails }; a bare-model response is rejected as INVALID_RESPONSE rather than guessed into a collection.",
50099
50099
  "preferredWhen": "Default for filtered reads (the bounded query op). queryAll is the unbounded raw walk — only when you need the ENTIRE set and accept a large payload; default to the bounded query op. Prefer an includeFields subset over the full model (field names via operations.fieldCatalog). latest: N is the latest-N rows (id-descending) when the newest rows are the goal (the vendor has no sort — count-anchored, docs/API.md §4). Prefer a hand-listed includeFields for common narrow reads (removed the closed fieldsPreset presets — the v1 billing_join field list for billing_items.query, if you need it, is: companyID, ticketID, projectID, timeEntryID, contractServiceID, contractID, billingCodeID, expenseItemID, itemDate, quantity, rate, extendedPrice, totalAmount, nonBillable); noteChars: N caps the untrusted-class free-text fields of the resource (notes/descriptions/UDF prose) to N chars each with the explicit … [+N chars truncated] marker (opt-in; the raw result when absent).",
50100
50100
  "related": [
50101
- "configuration_item_billing_product_associations.resolve"
50101
+ "configuration_item_attachments.get"
50102
50102
  ],
50103
- "args": "args[0] is a params object: { filter?: FilterCondition[], limit?: total cap (default 500, max 2500; server-side pagination), latest?: number (1-2500 — the N highest-id rows; the vendor has no sort parameter, so this is a count-anchored mechanism — see docs/API.md §4; coexists with limit only when limit >= latest), noteChars?: number (integer >= 1 — opt-in per-field char cap on the untrusted-class free-text fields of the resource (notes/descriptions/UDF prose): each capped value = the first N chars + the explicit marker … [+N chars truncated] (N = chars removed), applied at result-build BEFORE the server-side untrusted wrapper; absent = the raw, untruncated result) maxRecords?: page size — raw SDK `queryAll`/`query` walks only (this bounded query ignores it; the invoke bag refuses it — pass limit), includeFields?: string[], fieldCheck?: boolean (default true — the pre-request field-name check on includeFields names and filter condition fields; false disables it — consumed by the invoke router, never sent to the vendor), via?: \"post\" | \"get\" (the wire method; the vendor GET has a 2048-char cap), acknowledgeUnscoped?: boolean (query verb only; a walk expected over 500 rows with no id scope in the filter is guarded — one pre-flight <resource>.count, and a count over 500 refuses with the typed SCOPE_REQUIRED before the walk; true walks the unscoped set anyway; a count that fails or is blind lets the walk run and the result’s scopeNote says so), walk?: { maxRows: positive integer (D6: the walk’s TOTAL row cap — serves at most maxRows rows in total; the page size stays min(500, limit), so one vendor page may fetch more rows than maxRows and the surplus is sliced off (fetched, not served); the result’s truncated flag — false only when the cursor is exhausted, true iff more rows exist past the cap (so an exact-multiple count with a live next page reports true); not combinable with latest) } }. Filter grammar: 13 operators: eq, noteq, gt, gte, lt, lte, beginsWith, endsWith, contains, exist, notExist, in, notIn (in/notIn: array or '1,2,3') + and/or grouping (no not-group). Field names in vendor API casing — get them via operations.fieldCatalog. Caps: 500 OR-conditions / 1 UDF / 8000 chars. By default the FULL vendor model is returned (all fields). To slim the payload for context savings pass includeFields with the exact vendor field names you need (discover them via operations.fieldCatalog); only those fields + id come back. The subset persists across the internal page walk."
50103
+ "args": "args[0] is a params object: { filter?: FilterCondition[], limit?: total cap (default 500, max 2500; server-side pagination), latest?: number (1-2500 — the N highest-id rows; the vendor has no sort parameter, so this is a count-anchored mechanism — see docs/API.md §4; coexists with limit only when limit >= latest), noteChars?: number (integer >= 1 — opt-in per-field char cap on the untrusted-class free-text fields of the resource (notes/descriptions/UDF prose): each capped value = the first N chars + the explicit marker … [+N chars truncated] (N = chars removed), applied at result-build BEFORE the server-side untrusted wrapper; absent = the raw, untruncated result) maxRecords?: page size — raw SDK `queryAll`/`query` walks only (this bounded query ignores it; the invoke bag refuses it — pass limit), includeFields?: string[], fieldCheck?: boolean (default true — the pre-request field-name check on includeFields names and filter condition fields; false disables it — consumed by the invoke router, never sent to the vendor), via?: \"post\" | \"get\" (the wire method; the vendor GET has a 2048-char cap), acknowledgeUnscoped?: boolean (query verb only; a walk expected over 500 rows with no id scope in the filter is guarded — one pre-flight <resource>.count, and a count over 500 refuses with the typed SCOPE_REQUIRED before the walk; true walks the unscoped set anyway; a count that fails or is blind lets the walk run and the result’s scopeNote says so), walk?: { maxRows: positive integer (D6: the walk’s TOTAL row cap — serves at most maxRows rows in total; the page size stays min(500, limit), so one vendor page may fetch more rows than maxRows and the surplus is sliced off (fetched, not served); the result’s truncated flag — false only when the cursor is exhausted, true iff more rows exist past the cap (so an exact-multiple count with a live next page reports true); not combinable with latest) } }. Filter grammar: 13 operators: eq, noteq, gt, gte, lt, lte, beginsWith, endsWith, contains, exist, notExist, in, notIn (in/notIn: array or '1,2,3') + and/or grouping (no not-group). Field names in vendor API casing — get them via operations.fieldCatalog. Caps: 500 OR-conditions / 1 UDF / 8000 chars. By default the FULL vendor model is returned (all fields). To slim the payload for context savings pass includeFields with the exact vendor field names you need (discover them via operations.fieldCatalog); only those fields + id come back. The subset persists across the internal page walk.",
50104
+ "untrustedFields": [
50105
+ "title"
50106
+ ]
50104
50107
  },
50105
50108
  "compact": null,
50106
50109
  "status": "tested"
50107
50110
  },
50108
50111
  {
50109
- "id": "configuration_item_billing_product_associations.resolve",
50112
+ "id": "configuration_item_billing_product_associations.count",
50110
50113
  "resource": "configuration_item_billing_product_associations",
50111
50114
  "udfCapable": false,
50112
- "operation": "resolve",
50113
- "kind": "helper",
50114
- "endpoint": null,
50115
+ "operation": "count",
50116
+ "kind": "primitive",
50117
+ "endpoint": "GET|POST /V1.0/ConfigurationItemBillingProductAssociations/query/count",
50115
50118
  "effect": "read",
50116
50119
  "flags": [],
50117
50120
  "dryRun": false,
50118
- "envelope": null,
50121
+ "envelope": "QueryCountResultModel",
50119
50122
  "inputSchema": {
50120
- "identifier": {
50121
- "type": "string | number",
50122
- "required": true,
50123
- "description": "A numeric id (the direct fetch, tried first) or an exact value of the primary text field(s) of this resource (exact match only — a complete non-match returns null (resolve never widens to contains; the resource's search op is the contains-candidates channel) — other identifier forms, e.g. an email address, are NOT tried; use the dedicated lookup op for the resource where one exists)."
50124
- },
50125
- "opts": {
50123
+ "params": {
50126
50124
  "type": "object",
50127
50125
  "required": false,
50128
- "description": "ResolutionOpts — { expand?: boolean } (return the full record; a no-op where the Summary is a structural alias).",
50126
+ "description": "The query params object (CLOSED — unknown keys are refused pre-request): { filter?: FilterCondition[], fieldCheck?: boolean } — filter is the only wire parameter (the count endpoint takes no MaxRecords/IncludeFields; fieldCheck is consumed by the invoke router — never sent to the vendor). Filter condition field names are name-checked pre-request the same way as the query bag: a refusal costs zero /query/count wire (the cold fieldCache may cost the one authority metadata GET first). fieldCheck: false disables the name check (a non-boolean is refused pre-request; the shape/grammar checks always run) — the opt-out works on the count verb too.",
50129
50127
  "properties": [
50130
50128
  {
50131
- "name": "expand",
50129
+ "name": "filter",
50130
+ "type": "FilterCondition[]",
50131
+ "optional": true
50132
+ },
50133
+ {
50134
+ "name": "fieldCheck",
50132
50135
  "type": "boolean",
50133
50136
  "optional": true
50134
50137
  }
@@ -50137,49 +50140,44 @@ const CAPABILITY_DATA = {
50137
50140
  },
50138
50141
  "inputSchemaStrict": true,
50139
50142
  "outputSchema": {
50140
- "type": "ConfigurationItemBillingProductAssociationsSummary",
50143
+ "type": "QueryCountResultModel",
50141
50144
  "drops": []
50142
50145
  },
50143
50146
  "examples": [
50144
- "await client.configurationItemBillingProductAssociations.resolve('example-value')"
50147
+ "await client.configurationItemBillingProductAssociations.count({ filter: [{ field: 'name', op: 'eq', value: 'example' }] })"
50145
50148
  ],
50146
50149
  "permissions": "unknown",
50147
50150
  "pagination": {
50148
50151
  "mode": "none"
50149
50152
  },
50150
- "resolution": {
50151
- "basis": "server-filter",
50152
- "maxScanRecords": 500,
50153
- "maxScanPages": 4
50154
- },
50153
+ "resolution": null,
50155
50154
  "retry": {
50156
50155
  "preset": "retry-ffb3a9cb"
50157
50156
  },
50158
50157
  "errors": {
50159
- "set": 5
50158
+ "set": 0
50160
50159
  },
50161
50160
  "metadata": {
50162
- "purpose": "Resolve a billing product association from a numeric id (the direct fetch) only — this resource has no searchable text field, so a non-numeric identifier throws a config error. (under a configuration item)",
50163
- "usage": "Bare values are read in the order: numeric id, then the resource primary text field (see searchCovers), exact match only. { id } miss throws NOT_FOUND.",
50161
+ "purpose": "Count billing product association records matching a JSON filter. (under a configuration item)",
50162
+ "usage": "Unwraps queryCount; returns a plain number.",
50164
50163
  "preferredWhen": null,
50165
50164
  "related": [
50166
- "configuration_item_billing_product_associations.get"
50167
- ]
50165
+ "configuration_item_billing_product_associations.query"
50166
+ ],
50167
+ "args": "args[0] is a params object (CLOSED — unknown keys are refused pre-request): { filter?: FilterCondition[], fieldCheck?: boolean } — filter is the only parameter sent to the vendor (the count endpoint takes no MaxRecords/IncludeFields; fieldCheck is consumed by the invoke router — never sent to the vendor). Filter condition field names are name-checked pre-request the same way as the query bag: a refusal costs zero /query/count wire (the cold fieldCache may cost the one authority metadata GET first). fieldCheck: false disables the name check (a non-boolean is refused pre-request; the shape/grammar checks always run) — the opt-out works on the count verb too. Filter grammar: 13 operators: eq, noteq, gt, gte, lt, lte, beginsWith, endsWith, contains, exist, notExist, in, notIn (in/notIn: array or '1,2,3') + and/or grouping (no not-group). Field names in vendor API casing — get them via operations.fieldCatalog. Caps: 500 OR-conditions / 1 UDF / 8000 chars."
50168
50168
  },
50169
- "compact": "ConfigurationItemBillingProductAssociationsSummary",
50169
+ "compact": null,
50170
50170
  "status": "tested"
50171
50171
  },
50172
50172
  {
50173
- "id": "configuration_item_billing_product_associations.update",
50173
+ "id": "configuration_item_billing_product_associations.create",
50174
50174
  "resource": "configuration_item_billing_product_associations",
50175
50175
  "udfCapable": false,
50176
- "operation": "update",
50176
+ "operation": "create",
50177
50177
  "kind": "primitive",
50178
- "endpoint": "PUT|PATCH /V1.0/ConfigurationItems/{parentId}/BillingProductAssociations",
50178
+ "endpoint": "POST /V1.0/ConfigurationItems/{parentId}/BillingProductAssociations",
50179
50179
  "effect": "write",
50180
- "flags": [
50181
- "idempotent"
50182
- ],
50180
+ "flags": [],
50183
50181
  "dryRun": true,
50184
50182
  "envelope": "OperationResultModel",
50185
50183
  "inputSchema": {
@@ -50188,11 +50186,6 @@ const CAPABILITY_DATA = {
50188
50186
  "required": true,
50189
50187
  "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
50190
50188
  },
50191
- "id": {
50192
- "type": "string | number",
50193
- "required": true,
50194
- "description": "The record id (number, or a canonical integer string — ids beyond 2^53 are supported via the string form)."
50195
- },
50196
50189
  "data": {
50197
50190
  "type": "object",
50198
50191
  "required": true,
@@ -50205,7 +50198,7 @@ const CAPABILITY_DATA = {
50205
50198
  "drops": []
50206
50199
  },
50207
50200
  "examples": [
50208
- "await client.configurationItemBillingProductAssociations.update('example-value', 'example-value', { name: 'example' }, { dryRun: true })"
50201
+ "await client.configurationItemBillingProductAssociations.create('example-value', { name: 'example' }, { dryRun: true })"
50209
50202
  ],
50210
50203
  "permissions": "unknown",
50211
50204
  "pagination": {
@@ -50213,94 +50206,29 @@ const CAPABILITY_DATA = {
50213
50206
  },
50214
50207
  "resolution": null,
50215
50208
  "retry": {
50216
- "preset": "retry-85897a3a"
50209
+ "preset": "retry-c5657094"
50217
50210
  },
50218
50211
  "errors": {
50219
50212
  "set": 1
50220
50213
  },
50221
50214
  "metadata": {
50222
- "purpose": "Update a billing product association. (under a configuration item)",
50223
- "usage": "Issues PATCH on the collection (swagger documents put+patch there; the node strips the id from the path and the vendor keys the record by the id in the body). Stale check via lastModifiedDate where present. Parent-scoped: parentId + id.",
50224
- "preferredWhen": "Preferred over create or delete when the record exists and only some fields change.",
50225
- "related": [
50226
- "configuration_item_billing_product_associations.get"
50227
- ]
50228
- },
50229
- "compact": null,
50230
- "status": "tested"
50231
- },
50232
- {
50233
- "id": "configuration_item_dns_records.count",
50234
- "resource": "configuration_item_dns_records",
50235
- "udfCapable": false,
50236
- "operation": "count",
50237
- "kind": "primitive",
50238
- "endpoint": "GET|POST /V1.0/ConfigurationItemDnsRecords/query/count",
50239
- "effect": "read",
50240
- "flags": [],
50241
- "dryRun": false,
50242
- "envelope": "QueryCountResultModel",
50243
- "inputSchema": {
50244
- "params": {
50245
- "type": "object",
50246
- "required": false,
50247
- "description": "The query params object (CLOSED — unknown keys are refused pre-request): { filter?: FilterCondition[], fieldCheck?: boolean } — filter is the only wire parameter (the count endpoint takes no MaxRecords/IncludeFields; fieldCheck is consumed by the invoke router — never sent to the vendor). Filter condition field names are name-checked pre-request the same way as the query bag: a refusal costs zero /query/count wire (the cold fieldCache may cost the one authority metadata GET first). fieldCheck: false disables the name check (a non-boolean is refused pre-request; the shape/grammar checks always run) — the opt-out works on the count verb too.",
50248
- "properties": [
50249
- {
50250
- "name": "filter",
50251
- "type": "FilterCondition[]",
50252
- "optional": true
50253
- },
50254
- {
50255
- "name": "fieldCheck",
50256
- "type": "boolean",
50257
- "optional": true
50258
- }
50259
- ]
50260
- }
50261
- },
50262
- "inputSchemaStrict": true,
50263
- "outputSchema": {
50264
- "type": "QueryCountResultModel",
50265
- "drops": []
50266
- },
50267
- "examples": [
50268
- "await invoke(client, 'configuration_item_dns_records.count', [{ filter: [{ field: 'installedProductID', op: 'eq', value: 7 }] }])"
50269
- ],
50270
- "permissions": "unknown",
50271
- "pagination": {
50272
- "mode": "none"
50273
- },
50274
- "resolution": null,
50275
- "retry": {
50276
- "preset": "retry-ffb3a9cb"
50277
- },
50278
- "errors": {
50279
- "set": 0
50280
- },
50281
- "metadata": {
50282
- "purpose": "Count configuration item DNS records matching a JSON filter.",
50283
- "usage": "Unwraps queryCount; returns a plain number.",
50284
- "preferredWhen": null,
50215
+ "purpose": "Create a billing product association. (under a configuration item)",
50216
+ "usage": "Returns OperationResultModel.itemId (the new id); the full record is not returned — follow up with get where needed. Parent-scoped: parentId is a path parameter.",
50217
+ "preferredWhen": "Only for a record that does not exist yet; prefer update for an id you already have.",
50285
50218
  "related": [
50286
- "configuration_item_dns_records.query"
50287
- ],
50288
- "args": "args[0] is a params object (CLOSED — unknown keys are refused pre-request): { filter?: FilterCondition[], fieldCheck?: boolean } — filter is the only parameter sent to the vendor (the count endpoint takes no MaxRecords/IncludeFields; fieldCheck is consumed by the invoke router — never sent to the vendor). Filter condition field names are name-checked pre-request the same way as the query bag: a refusal costs zero /query/count wire (the cold fieldCache may cost the one authority metadata GET first). fieldCheck: false disables the name check (a non-boolean is refused pre-request; the shape/grammar checks always run) — the opt-out works on the count verb too. Filter grammar: 13 operators: eq, noteq, gt, gte, lt, lte, beginsWith, endsWith, contains, exist, notExist, in, notIn (in/notIn: array or '1,2,3') + and/or grouping (no not-group). Field names in vendor API casing — get them via operations.fieldCatalog. Caps: 500 OR-conditions / 1 UDF / 8000 chars.",
50289
- "untrustedFields": [
50290
- "data",
50291
- "dnsType"
50219
+ "configuration_item_billing_product_associations.update"
50292
50220
  ]
50293
50221
  },
50294
50222
  "compact": null,
50295
50223
  "status": "tested"
50296
50224
  },
50297
50225
  {
50298
- "id": "configuration_item_dns_records.delete",
50299
- "resource": "configuration_item_dns_records",
50226
+ "id": "configuration_item_billing_product_associations.delete",
50227
+ "resource": "configuration_item_billing_product_associations",
50300
50228
  "udfCapable": false,
50301
50229
  "operation": "delete",
50302
50230
  "kind": "primitive",
50303
- "endpoint": "DELETE /V1.0/ConfigurationItems/{parentId}/DnsRecords/{id}",
50231
+ "endpoint": "DELETE /V1.0/ConfigurationItems/{parentId}/BillingProductAssociations/{id}",
50304
50232
  "effect": "destructive",
50305
50233
  "flags": [
50306
50234
  "idempotent",
@@ -50326,7 +50254,7 @@ const CAPABILITY_DATA = {
50326
50254
  "drops": []
50327
50255
  },
50328
50256
  "examples": [
50329
- "await invoke(client, 'configuration_item_dns_records.delete', ['example-value', 'example-value'], { dryRun: false, confirm: 'configuration_item_dns_records.delete' })"
50257
+ "await invoke(client, 'configuration_item_billing_product_associations.delete', ['example-value', 'example-value'], { dryRun: false, confirm: 'configuration_item_billing_product_associations.delete' })"
50330
50258
  ],
50331
50259
  "permissions": "unknown",
50332
50260
  "pagination": {
@@ -50340,31 +50268,27 @@ const CAPABILITY_DATA = {
50340
50268
  "set": 2
50341
50269
  },
50342
50270
  "metadata": {
50343
- "purpose": "Delete a configuration item DNS record.",
50271
+ "purpose": "Delete a billing product association. (under a configuration item)",
50344
50272
  "usage": "Irreversible; dry-run validates the target id first. Parent-scoped: parentId + id.",
50345
50273
  "preferredWhen": null,
50346
50274
  "related": [
50347
- "configuration_item_dns_records.get"
50348
- ],
50349
- "untrustedFields": [
50350
- "data",
50351
- "dnsType"
50275
+ "configuration_item_billing_product_associations.get"
50352
50276
  ]
50353
50277
  },
50354
50278
  "compact": null,
50355
50279
  "status": "tested"
50356
50280
  },
50357
50281
  {
50358
- "id": "configuration_item_dns_records.get",
50359
- "resource": "configuration_item_dns_records",
50282
+ "id": "configuration_item_billing_product_associations.get",
50283
+ "resource": "configuration_item_billing_product_associations",
50360
50284
  "udfCapable": false,
50361
50285
  "operation": "get",
50362
50286
  "kind": "primitive",
50363
- "endpoint": "GET /V1.0/ConfigurationItems/{parentId}/DnsRecords/{id}",
50287
+ "endpoint": "GET /V1.0/ConfigurationItems/{parentId}/BillingProductAssociations/{id}",
50364
50288
  "effect": "read",
50365
50289
  "flags": [],
50366
50290
  "dryRun": false,
50367
- "envelope": "ItemQueryResultModel[ConfigurationItemDnsRecordModel,InstalledProductDnsRecord]",
50291
+ "envelope": "ItemQueryResultModel[ConfigurationItemBillingProductAssociationModel,InstalledProductBillingProductAssociation]",
50368
50292
  "inputSchema": {
50369
50293
  "parentId": {
50370
50294
  "type": "string | number",
@@ -50391,11 +50315,11 @@ const CAPABILITY_DATA = {
50391
50315
  },
50392
50316
  "inputSchemaStrict": true,
50393
50317
  "outputSchema": {
50394
- "type": "ItemQueryResultModel[ConfigurationItemDnsRecordModel,InstalledProductDnsRecord]",
50318
+ "type": "ItemQueryResultModel[ConfigurationItemBillingProductAssociationModel,InstalledProductBillingProductAssociation]",
50395
50319
  "drops": []
50396
50320
  },
50397
50321
  "examples": [
50398
- "await client.configurationItemDnsRecords.get('example-value', 'example-value')"
50322
+ "await client.configurationItemBillingProductAssociations.get('example-value', 'example-value')"
50399
50323
  ],
50400
50324
  "permissions": "unknown",
50401
50325
  "pagination": {
@@ -50409,28 +50333,24 @@ const CAPABILITY_DATA = {
50409
50333
  "set": 3
50410
50334
  },
50411
50335
  "metadata": {
50412
- "purpose": "Get one ConfigurationItemDnsRecord by id.",
50336
+ "purpose": "Get one ConfigurationItemBillingProductAssociations by id.",
50413
50337
  "usage": "item: null on the 200 body maps to NotFoundError (vendor not-found signal). Parent-scoped: parentId + id.",
50414
- "preferredWhen": "Preferred when the numeric id is already known; configuration_item_dns_records.resolve is for a field value.",
50338
+ "preferredWhen": "Preferred when the numeric id is already known; configuration_item_billing_product_associations.resolve is for a field value.",
50415
50339
  "related": [
50416
- "configuration_item_dns_records.resolve"
50340
+ "configuration_item_billing_product_associations.resolve"
50417
50341
  ],
50418
- "args": "args are (parentId: number, id: number) Item GET returns the FULL vendor model — the vendor documents no field selection on single-record reads. For a slim record use a configuration_item_dns_records.query with includeFields.",
50419
- "untrustedFields": [
50420
- "data",
50421
- "dnsType"
50422
- ]
50342
+ "args": "args are (parentId: number, id: number) Item GET returns the FULL vendor model — the vendor documents no field selection on single-record reads. For a slim record use a configuration_item_billing_product_associations.query with includeFields."
50423
50343
  },
50424
50344
  "compact": null,
50425
50345
  "status": "tested"
50426
50346
  },
50427
50347
  {
50428
- "id": "configuration_item_dns_records.getEntityInfo",
50429
- "resource": "configuration_item_dns_records",
50348
+ "id": "configuration_item_billing_product_associations.getEntityInfo",
50349
+ "resource": "configuration_item_billing_product_associations",
50430
50350
  "udfCapable": false,
50431
50351
  "operation": "getEntityInfo",
50432
50352
  "kind": "primitive",
50433
- "endpoint": "GET /V1.0/ConfigurationItemDnsRecords/entityInformation",
50353
+ "endpoint": "GET /V1.0/ConfigurationItemBillingProductAssociations/entityInformation",
50434
50354
  "effect": "read",
50435
50355
  "flags": [],
50436
50356
  "dryRun": false,
@@ -50442,7 +50362,7 @@ const CAPABILITY_DATA = {
50442
50362
  "drops": []
50443
50363
  },
50444
50364
  "examples": [
50445
- "await client.configurationItemDnsRecords.getEntityInfo()"
50365
+ "await client.configurationItemBillingProductAssociations.getEntityInfo()"
50446
50366
  ],
50447
50367
  "permissions": "unknown",
50448
50368
  "pagination": {
@@ -50456,27 +50376,23 @@ const CAPABILITY_DATA = {
50456
50376
  "set": 0
50457
50377
  },
50458
50378
  "metadata": {
50459
- "purpose": "Get the ConfigurationItemDnsRecord capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
50379
+ "purpose": "Get the ConfigurationItemBillingProductAssociations capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
50460
50380
  "usage": "Unwraps info{}; drives client-side capability checks.",
50461
50381
  "preferredWhen": null,
50462
50382
  "related": [
50463
- "configuration_item_dns_records.getFieldInfo"
50464
- ],
50465
- "untrustedFields": [
50466
- "data",
50467
- "dnsType"
50383
+ "configuration_item_billing_product_associations.getFieldInfo"
50468
50384
  ]
50469
50385
  },
50470
50386
  "compact": null,
50471
50387
  "status": "tested"
50472
50388
  },
50473
50389
  {
50474
- "id": "configuration_item_dns_records.getFieldInfo",
50475
- "resource": "configuration_item_dns_records",
50390
+ "id": "configuration_item_billing_product_associations.getFieldInfo",
50391
+ "resource": "configuration_item_billing_product_associations",
50476
50392
  "udfCapable": false,
50477
50393
  "operation": "getFieldInfo",
50478
50394
  "kind": "primitive",
50479
- "endpoint": "GET /V1.0/ConfigurationItemDnsRecords/entityInformation/fields",
50395
+ "endpoint": "GET /V1.0/ConfigurationItemBillingProductAssociations/entityInformation/fields",
50480
50396
  "effect": "read",
50481
50397
  "flags": [],
50482
50398
  "dryRun": false,
@@ -50488,7 +50404,7 @@ const CAPABILITY_DATA = {
50488
50404
  "drops": []
50489
50405
  },
50490
50406
  "examples": [
50491
- "await client.configurationItemDnsRecords.getFieldInfo()"
50407
+ "await client.configurationItemBillingProductAssociations.getFieldInfo()"
50492
50408
  ],
50493
50409
  "permissions": "unknown",
50494
50410
  "pagination": {
@@ -50502,28 +50418,24 @@ const CAPABILITY_DATA = {
50502
50418
  "set": 0
50503
50419
  },
50504
50420
  "metadata": {
50505
- "purpose": "Get the ConfigurationItemDnsRecord field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
50421
+ "purpose": "Get the ConfigurationItemBillingProductAssociations field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
50506
50422
  "usage": "Unwraps fields[]; full raw field dump — the largest read of the info trio (compact discovery: operations.fieldCatalog); the raw dump is also the basis for UDF handling.",
50507
50423
  "preferredWhen": null,
50508
50424
  "related": [
50509
- "configuration_item_dns_records.getEntityInfo",
50510
- "configuration_item_dns_records.getUdfInfo"
50511
- ],
50512
- "untrustedFields": [
50513
- "data",
50514
- "dnsType"
50425
+ "configuration_item_billing_product_associations.getEntityInfo",
50426
+ "configuration_item_billing_product_associations.getUdfInfo"
50515
50427
  ]
50516
50428
  },
50517
50429
  "compact": null,
50518
50430
  "status": "tested"
50519
50431
  },
50520
50432
  {
50521
- "id": "configuration_item_dns_records.getUdfInfo",
50522
- "resource": "configuration_item_dns_records",
50433
+ "id": "configuration_item_billing_product_associations.getUdfInfo",
50434
+ "resource": "configuration_item_billing_product_associations",
50523
50435
  "udfCapable": false,
50524
50436
  "operation": "getUdfInfo",
50525
50437
  "kind": "primitive",
50526
- "endpoint": "GET /V1.0/ConfigurationItemDnsRecords/entityInformation/userDefinedFields",
50438
+ "endpoint": "GET /V1.0/ConfigurationItemBillingProductAssociations/entityInformation/userDefinedFields",
50527
50439
  "effect": "read",
50528
50440
  "flags": [],
50529
50441
  "dryRun": false,
@@ -50535,7 +50447,7 @@ const CAPABILITY_DATA = {
50535
50447
  "drops": []
50536
50448
  },
50537
50449
  "examples": [
50538
- "await client.configurationItemDnsRecords.getUdfInfo()"
50450
+ "await client.configurationItemBillingProductAssociations.getUdfInfo()"
50539
50451
  ],
50540
50452
  "permissions": "unknown",
50541
50453
  "pagination": {
@@ -50549,27 +50461,591 @@ const CAPABILITY_DATA = {
50549
50461
  "set": 0
50550
50462
  },
50551
50463
  "metadata": {
50552
- "purpose": "Get the ConfigurationItemDnsRecord user-defined-field catalog.",
50464
+ "purpose": "Get the ConfigurationItemBillingProductAssociations user-defined-field catalog.",
50553
50465
  "usage": "Unwraps fields[]; only meaningful where the entity is UDF-capable. (entity is not UDF-capable; catalog is expected empty).",
50554
50466
  "preferredWhen": null,
50555
50467
  "related": [
50556
- "configuration_item_dns_records.getFieldInfo"
50557
- ],
50558
- "untrustedFields": [
50559
- "data",
50560
- "dnsType"
50468
+ "configuration_item_billing_product_associations.getFieldInfo"
50561
50469
  ]
50562
50470
  },
50563
50471
  "compact": null,
50564
50472
  "status": "tested"
50565
50473
  },
50566
50474
  {
50567
- "id": "configuration_item_dns_records.query",
50568
- "resource": "configuration_item_dns_records",
50475
+ "id": "configuration_item_billing_product_associations.query",
50476
+ "resource": "configuration_item_billing_product_associations",
50569
50477
  "udfCapable": false,
50570
50478
  "operation": "query",
50571
50479
  "kind": "primitive",
50572
- "endpoint": "GET|POST /V1.0/ConfigurationItemDnsRecords/query",
50480
+ "endpoint": "GET|POST /V1.0/ConfigurationItemBillingProductAssociations/query",
50481
+ "effect": "read",
50482
+ "flags": [],
50483
+ "dryRun": false,
50484
+ "envelope": "QueryActionResult[<Model>,<Entity>]",
50485
+ "inputSchema": {
50486
+ "params": {
50487
+ "type": "object",
50488
+ "required": false,
50489
+ "description": "The query params object (CLOSED — unknown keys are refused pre-request with a typed error naming the key + the valid keys): { filter?: FilterCondition[], limit?: number (total cap, default 500, max 2500 — NOT a page size), latest?: number (1-2500; the N highest-id rows — the vendor has no sort; count-probe + id-threshold semantics, see docs/API.md §4; the same-process latest-walk count probes are briefly cached per client — a 30 s TTL, cleared on a write through this client (a probe in flight across the write is discarded by the cache's invalidation epoch); the plain count op and aggregate stay fresh; limit and latest may coexist only when limit >= latest), noteChars?: number (integer >= 1; opt-in per-field char cap on the untrusted-class free-text fields of the resource (notes/descriptions/UDF prose): each capped value = the first N chars + the explicit marker … [+N chars truncated] (N = chars removed), applied at result-build BEFORE the server-side untrusted wrapper; absent = the raw, untruncated result), includeFields?: string[], fieldCheck?: boolean (default true: every includeFields NAME and every filter condition FIELD NAME is checked pre-request against the live field set (the vendored spec when that read faults — the resource's plan-pinned live-only fields, metadata.liveOnlyFields, are exempt from the vendored refusal: the live entity carries them and the vendor model omits them (e.g. time_entries postedDate/postedOnTime) — a truly unknown name is still refused); a refusal costs zero QUERY wire — the query POST and the count probe that anchors latest are never issued, a COLD fieldCache performs one authority metadata GET first (zero on a warm one); the one udf:true condition per query is exempt (a tenant UDF name is absent from the vendored spec by definition); false disables both name checks, never the shape/grammar checks; the count verb's bag is name-checked the same way and carries the same fieldCheck opt-out; a direct queryBounded/queryAll call is not checked (no bag contract there)), names?: boolean (absent = the client's labels option — OFF by default (the label pass costs a field-catalog read + up to 20 cold name reads per call; the MCP server (iit-mcp-autotask) enables the client labels option when it re-pins to this version (downstream)); true adds the row label siblings: picklist <field>Label (statusLabel), <fk>Name for companyID/contractID/ticketID/roleID/billingCodeID/*ResourceID (contractIDName, assignedResourceIDName) — null, never missing, when the field is keyed with a null value, a 0 id or an unresolved value (a picklist 0 is labelled when the picklist defines it); a names summary appears only when something was left unlabelled (the 20 uncached name-read cap or an unresolved picklist value); false = raw ids, ~30% smaller on a full tickets row), via?: \"post\" | \"get\" (vendor GET has a 2048-char cap), acknowledgeUnscoped?: boolean (query verb only; a walk expected to read over 500 rows with no id scope in the filter is guarded — one pre-flight <resource>.count, and a count over 500 refuses with the typed SCOPE_REQUIRED before the walk; true walks the unscoped set anyway; a count that fails or is blind lets the walk run and the result's scopeNote says so), walk?: object (walk.maxRows: positive integer — (D6): the walk's TOTAL row cap — serves at most maxRows rows in total; the page size stays min(500, limit), so one vendor page may fetch more rows than maxRows and the surplus is sliced off (fetched, not served); the result's truncated flag — false only when the cursor is exhausted, true iff more rows exist past the cap (so an exact-multiple count with a live next page reports true); not combinable with latest) }. Filter grammar: 13 operators (eq, noteq, gt, gte, lt, lte, beginsWith, endsWith, contains, exist, notExist, in, notIn; in/notIn: array or \"1,2,3\") + and/or grouping (no not-group); field names in vendor API casing (via operations.fieldCatalog); caps: 500 OR-conditions / 1 UDF / 8000 chars.",
50490
+ "properties": [
50491
+ {
50492
+ "name": "filter",
50493
+ "type": "FilterCondition[]",
50494
+ "optional": true
50495
+ },
50496
+ {
50497
+ "name": "limit",
50498
+ "type": "number",
50499
+ "optional": true,
50500
+ "default": 500
50501
+ },
50502
+ {
50503
+ "name": "latest",
50504
+ "type": "number",
50505
+ "optional": true
50506
+ },
50507
+ {
50508
+ "name": "noteChars",
50509
+ "type": "number",
50510
+ "optional": true
50511
+ },
50512
+ {
50513
+ "name": "includeFields",
50514
+ "type": "string[]",
50515
+ "optional": true
50516
+ },
50517
+ {
50518
+ "name": "fieldCheck",
50519
+ "type": "boolean",
50520
+ "optional": true,
50521
+ "default": true
50522
+ },
50523
+ {
50524
+ "name": "names",
50525
+ "type": "boolean",
50526
+ "optional": true
50527
+ },
50528
+ {
50529
+ "name": "via",
50530
+ "type": "\"post\" | \"get\"",
50531
+ "optional": true
50532
+ },
50533
+ {
50534
+ "name": "acknowledgeUnscoped",
50535
+ "type": "boolean",
50536
+ "optional": true
50537
+ },
50538
+ {
50539
+ "name": "walk",
50540
+ "type": "object",
50541
+ "optional": true
50542
+ }
50543
+ ]
50544
+ }
50545
+ },
50546
+ "inputSchemaStrict": true,
50547
+ "outputSchema": {
50548
+ "type": "QueryActionResult[<Model>,<Entity>]",
50549
+ "drops": []
50550
+ },
50551
+ "examples": [
50552
+ "await client.configurationItemBillingProductAssociations.query({ filter: [{ field: 'name', op: 'eq', value: 'example' }], limit: 500 })"
50553
+ ],
50554
+ "permissions": "unknown",
50555
+ "pagination": {
50556
+ "mode": "cursor",
50557
+ "vendorDefault": 10,
50558
+ "vendorMax": 500,
50559
+ "pageGuard": 1000,
50560
+ "queryBounded": {
50561
+ "default": 500,
50562
+ "max": 2500
50563
+ }
50564
+ },
50565
+ "resolution": null,
50566
+ "retry": {
50567
+ "preset": "retry-ffb3a9cb"
50568
+ },
50569
+ "errors": {
50570
+ "set": 4
50571
+ },
50572
+ "metadata": {
50573
+ "purpose": "Query ConfigurationItemBillingProductAssociations records with a JSON filter.",
50574
+ "usage": "Server-side pagination: one call walks the vendor cursor internally (page 1 POSTs the QueryModel body with MaxRecords = the walk's internal page size (at most 500; the default POST path — `via: 'get'` issues a GET on page 1); later pages POST the SAME body — IncludeFields, MaxRecords and the preserved filter — to the absolute vendor cursor, rebased to the client base URL; the vendor honours IncludeFields on a continuation and ignores MaxRecords there, so a later page carries the vendor's own page size) until the limit is met or the cursor is null; 1000-page guard (hasMore stays true at the guard). queryAll is the unbounded raw walk — only when you need the ENTIRE set and accept a large payload; default to the bounded query op. noteChars: N (integer >= 1) is an opt-in per-field char cap on the untrusted-class free-text fields of the resource (notes/descriptions/UDF prose — the same set the server wraps): each capped value = the first N chars + the explicit marker … [+N chars truncated] (N = chars removed), applied at result-build BEFORE the server-side untrusted wrapper; absent = the raw, untruncated result (zero wire — response-side only). latest: N returns the N highest-id rows (id-descending): the vendor has no sort parameter — this is the only ordering channel, and a date window in `filter` narrows the cost; count-anchored — C ≤ 2500 → one count + a ≤6-page walk of the matching set, C > 2500 → count probes + an id-threshold window (≤64 probes; LATEST_THRESHOLD_UNRESOLVED on budget exhaustion), a blind count → a bounded walk with the blind-surface stamp (LATEST_WINDOW_INCOMPLETE on a truncated walk). Parent-scoped entity: the query stays global (filter with configurationItemID eq <parentId> where the parent is known). Explicit walk.maxRows independently sets the TOTAL returned-row cap (including export-sized walks); the ordinary limit is still validated in 1..2500 and only bounds the internal page size for this form. hasMore and truncated remain true at the page guard or while a cursor or unserved fetched rows remain. Self-resource prefixes are accepted in filter fields and includeFields; dotted UDF names are always refused before metadata or vendor requests, never rewritten to another tenant UDF.",
50575
+ "preferredWhen": "Default for filtered reads (the bounded query op). queryAll is the unbounded raw walk — only when you need the ENTIRE set and accept a large payload; default to the bounded query op. Prefer an includeFields subset over the full model (field names via operations.fieldCatalog). latest: N is the latest-N rows (id-descending) when the newest rows are the goal (the vendor has no sort — count-anchored, docs/API.md §4). Prefer a hand-listed includeFields for common narrow reads (removed the closed fieldsPreset presets — the v1 billing_join field list for billing_items.query, if you need it, is: companyID, ticketID, projectID, timeEntryID, contractServiceID, contractID, billingCodeID, expenseItemID, itemDate, quantity, rate, extendedPrice, totalAmount, nonBillable); noteChars: N caps the untrusted-class free-text fields of the resource (notes/descriptions/UDF prose) to N chars each with the explicit … [+N chars truncated] marker (opt-in; the raw result when absent).",
50576
+ "related": [
50577
+ "configuration_item_billing_product_associations.resolve"
50578
+ ],
50579
+ "args": "args[0] is a params object: { filter?: FilterCondition[], limit?: total cap (default 500, max 2500; server-side pagination), latest?: number (1-2500 — the N highest-id rows; the vendor has no sort parameter, so this is a count-anchored mechanism — see docs/API.md §4; coexists with limit only when limit >= latest), noteChars?: number (integer >= 1 — opt-in per-field char cap on the untrusted-class free-text fields of the resource (notes/descriptions/UDF prose): each capped value = the first N chars + the explicit marker … [+N chars truncated] (N = chars removed), applied at result-build BEFORE the server-side untrusted wrapper; absent = the raw, untruncated result) maxRecords?: page size — raw SDK `queryAll`/`query` walks only (this bounded query ignores it; the invoke bag refuses it — pass limit), includeFields?: string[], fieldCheck?: boolean (default true — the pre-request field-name check on includeFields names and filter condition fields; false disables it — consumed by the invoke router, never sent to the vendor), via?: \"post\" | \"get\" (the wire method; the vendor GET has a 2048-char cap), acknowledgeUnscoped?: boolean (query verb only; a walk expected over 500 rows with no id scope in the filter is guarded — one pre-flight <resource>.count, and a count over 500 refuses with the typed SCOPE_REQUIRED before the walk; true walks the unscoped set anyway; a count that fails or is blind lets the walk run and the result’s scopeNote says so), walk?: { maxRows: positive integer (D6: the walk’s TOTAL row cap — serves at most maxRows rows in total; the page size stays min(500, limit), so one vendor page may fetch more rows than maxRows and the surplus is sliced off (fetched, not served); the result’s truncated flag — false only when the cursor is exhausted, true iff more rows exist past the cap (so an exact-multiple count with a live next page reports true); not combinable with latest) } }. Filter grammar: 13 operators: eq, noteq, gt, gte, lt, lte, beginsWith, endsWith, contains, exist, notExist, in, notIn (in/notIn: array or '1,2,3') + and/or grouping (no not-group). Field names in vendor API casing — get them via operations.fieldCatalog. Caps: 500 OR-conditions / 1 UDF / 8000 chars. By default the FULL vendor model is returned (all fields). To slim the payload for context savings pass includeFields with the exact vendor field names you need (discover them via operations.fieldCatalog); only those fields + id come back. The subset persists across the internal page walk."
50580
+ },
50581
+ "compact": null,
50582
+ "status": "tested"
50583
+ },
50584
+ {
50585
+ "id": "configuration_item_billing_product_associations.resolve",
50586
+ "resource": "configuration_item_billing_product_associations",
50587
+ "udfCapable": false,
50588
+ "operation": "resolve",
50589
+ "kind": "helper",
50590
+ "endpoint": null,
50591
+ "effect": "read",
50592
+ "flags": [],
50593
+ "dryRun": false,
50594
+ "envelope": null,
50595
+ "inputSchema": {
50596
+ "identifier": {
50597
+ "type": "string | number",
50598
+ "required": true,
50599
+ "description": "A numeric id (the direct fetch, tried first) or an exact value of the primary text field(s) of this resource (exact match only — a complete non-match returns null (resolve never widens to contains; the resource's search op is the contains-candidates channel) — other identifier forms, e.g. an email address, are NOT tried; use the dedicated lookup op for the resource where one exists)."
50600
+ },
50601
+ "opts": {
50602
+ "type": "object",
50603
+ "required": false,
50604
+ "description": "ResolutionOpts — { expand?: boolean } (return the full record; a no-op where the Summary is a structural alias).",
50605
+ "properties": [
50606
+ {
50607
+ "name": "expand",
50608
+ "type": "boolean",
50609
+ "optional": true
50610
+ }
50611
+ ]
50612
+ }
50613
+ },
50614
+ "inputSchemaStrict": true,
50615
+ "outputSchema": {
50616
+ "type": "ConfigurationItemBillingProductAssociationsSummary",
50617
+ "drops": []
50618
+ },
50619
+ "examples": [
50620
+ "await client.configurationItemBillingProductAssociations.resolve('example-value')"
50621
+ ],
50622
+ "permissions": "unknown",
50623
+ "pagination": {
50624
+ "mode": "none"
50625
+ },
50626
+ "resolution": {
50627
+ "basis": "server-filter",
50628
+ "maxScanRecords": 500,
50629
+ "maxScanPages": 4
50630
+ },
50631
+ "retry": {
50632
+ "preset": "retry-ffb3a9cb"
50633
+ },
50634
+ "errors": {
50635
+ "set": 5
50636
+ },
50637
+ "metadata": {
50638
+ "purpose": "Resolve a billing product association from a numeric id (the direct fetch) only — this resource has no searchable text field, so a non-numeric identifier throws a config error. (under a configuration item)",
50639
+ "usage": "Bare values are read in the order: numeric id, then the resource primary text field (see searchCovers), exact match only. { id } miss throws NOT_FOUND.",
50640
+ "preferredWhen": null,
50641
+ "related": [
50642
+ "configuration_item_billing_product_associations.get"
50643
+ ]
50644
+ },
50645
+ "compact": "ConfigurationItemBillingProductAssociationsSummary",
50646
+ "status": "tested"
50647
+ },
50648
+ {
50649
+ "id": "configuration_item_billing_product_associations.update",
50650
+ "resource": "configuration_item_billing_product_associations",
50651
+ "udfCapable": false,
50652
+ "operation": "update",
50653
+ "kind": "primitive",
50654
+ "endpoint": "PUT|PATCH /V1.0/ConfigurationItems/{parentId}/BillingProductAssociations",
50655
+ "effect": "write",
50656
+ "flags": [
50657
+ "idempotent"
50658
+ ],
50659
+ "dryRun": true,
50660
+ "envelope": "OperationResultModel",
50661
+ "inputSchema": {
50662
+ "parentId": {
50663
+ "type": "string | number",
50664
+ "required": true,
50665
+ "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
50666
+ },
50667
+ "id": {
50668
+ "type": "string | number",
50669
+ "required": true,
50670
+ "description": "The record id (number, or a canonical integer string — ids beyond 2^53 are supported via the string form)."
50671
+ },
50672
+ "data": {
50673
+ "type": "object",
50674
+ "required": true,
50675
+ "description": "The record payload (vendor model fields)."
50676
+ }
50677
+ },
50678
+ "inputSchemaStrict": true,
50679
+ "outputSchema": {
50680
+ "type": "OperationResultModel",
50681
+ "drops": []
50682
+ },
50683
+ "examples": [
50684
+ "await client.configurationItemBillingProductAssociations.update('example-value', 'example-value', { name: 'example' }, { dryRun: true })"
50685
+ ],
50686
+ "permissions": "unknown",
50687
+ "pagination": {
50688
+ "mode": "none"
50689
+ },
50690
+ "resolution": null,
50691
+ "retry": {
50692
+ "preset": "retry-85897a3a"
50693
+ },
50694
+ "errors": {
50695
+ "set": 1
50696
+ },
50697
+ "metadata": {
50698
+ "purpose": "Update a billing product association. (under a configuration item)",
50699
+ "usage": "Issues PATCH on the collection (swagger documents put+patch there; the node strips the id from the path and the vendor keys the record by the id in the body). Stale check via lastModifiedDate where present. Parent-scoped: parentId + id.",
50700
+ "preferredWhen": "Preferred over create or delete when the record exists and only some fields change.",
50701
+ "related": [
50702
+ "configuration_item_billing_product_associations.get"
50703
+ ]
50704
+ },
50705
+ "compact": null,
50706
+ "status": "tested"
50707
+ },
50708
+ {
50709
+ "id": "configuration_item_dns_records.count",
50710
+ "resource": "configuration_item_dns_records",
50711
+ "udfCapable": false,
50712
+ "operation": "count",
50713
+ "kind": "primitive",
50714
+ "endpoint": "GET|POST /V1.0/ConfigurationItemDnsRecords/query/count",
50715
+ "effect": "read",
50716
+ "flags": [],
50717
+ "dryRun": false,
50718
+ "envelope": "QueryCountResultModel",
50719
+ "inputSchema": {
50720
+ "params": {
50721
+ "type": "object",
50722
+ "required": false,
50723
+ "description": "The query params object (CLOSED — unknown keys are refused pre-request): { filter?: FilterCondition[], fieldCheck?: boolean } — filter is the only wire parameter (the count endpoint takes no MaxRecords/IncludeFields; fieldCheck is consumed by the invoke router — never sent to the vendor). Filter condition field names are name-checked pre-request the same way as the query bag: a refusal costs zero /query/count wire (the cold fieldCache may cost the one authority metadata GET first). fieldCheck: false disables the name check (a non-boolean is refused pre-request; the shape/grammar checks always run) — the opt-out works on the count verb too.",
50724
+ "properties": [
50725
+ {
50726
+ "name": "filter",
50727
+ "type": "FilterCondition[]",
50728
+ "optional": true
50729
+ },
50730
+ {
50731
+ "name": "fieldCheck",
50732
+ "type": "boolean",
50733
+ "optional": true
50734
+ }
50735
+ ]
50736
+ }
50737
+ },
50738
+ "inputSchemaStrict": true,
50739
+ "outputSchema": {
50740
+ "type": "QueryCountResultModel",
50741
+ "drops": []
50742
+ },
50743
+ "examples": [
50744
+ "await invoke(client, 'configuration_item_dns_records.count', [{ filter: [{ field: 'installedProductID', op: 'eq', value: 7 }] }])"
50745
+ ],
50746
+ "permissions": "unknown",
50747
+ "pagination": {
50748
+ "mode": "none"
50749
+ },
50750
+ "resolution": null,
50751
+ "retry": {
50752
+ "preset": "retry-ffb3a9cb"
50753
+ },
50754
+ "errors": {
50755
+ "set": 0
50756
+ },
50757
+ "metadata": {
50758
+ "purpose": "Count configuration item DNS records matching a JSON filter.",
50759
+ "usage": "Unwraps queryCount; returns a plain number.",
50760
+ "preferredWhen": null,
50761
+ "related": [
50762
+ "configuration_item_dns_records.query"
50763
+ ],
50764
+ "args": "args[0] is a params object (CLOSED — unknown keys are refused pre-request): { filter?: FilterCondition[], fieldCheck?: boolean } — filter is the only parameter sent to the vendor (the count endpoint takes no MaxRecords/IncludeFields; fieldCheck is consumed by the invoke router — never sent to the vendor). Filter condition field names are name-checked pre-request the same way as the query bag: a refusal costs zero /query/count wire (the cold fieldCache may cost the one authority metadata GET first). fieldCheck: false disables the name check (a non-boolean is refused pre-request; the shape/grammar checks always run) — the opt-out works on the count verb too. Filter grammar: 13 operators: eq, noteq, gt, gte, lt, lte, beginsWith, endsWith, contains, exist, notExist, in, notIn (in/notIn: array or '1,2,3') + and/or grouping (no not-group). Field names in vendor API casing — get them via operations.fieldCatalog. Caps: 500 OR-conditions / 1 UDF / 8000 chars.",
50765
+ "untrustedFields": [
50766
+ "data",
50767
+ "dnsType"
50768
+ ]
50769
+ },
50770
+ "compact": null,
50771
+ "status": "tested"
50772
+ },
50773
+ {
50774
+ "id": "configuration_item_dns_records.delete",
50775
+ "resource": "configuration_item_dns_records",
50776
+ "udfCapable": false,
50777
+ "operation": "delete",
50778
+ "kind": "primitive",
50779
+ "endpoint": "DELETE /V1.0/ConfigurationItems/{parentId}/DnsRecords/{id}",
50780
+ "effect": "destructive",
50781
+ "flags": [
50782
+ "idempotent",
50783
+ "requiresApproval"
50784
+ ],
50785
+ "dryRun": true,
50786
+ "envelope": "OperationResultModel",
50787
+ "inputSchema": {
50788
+ "parentId": {
50789
+ "type": "string | number",
50790
+ "required": true,
50791
+ "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
50792
+ },
50793
+ "id": {
50794
+ "type": "string | number",
50795
+ "required": true,
50796
+ "description": "The record id (number, or a canonical integer string — ids beyond 2^53 are supported via the string form)."
50797
+ }
50798
+ },
50799
+ "inputSchemaStrict": true,
50800
+ "outputSchema": {
50801
+ "type": "OperationResultModel",
50802
+ "drops": []
50803
+ },
50804
+ "examples": [
50805
+ "await invoke(client, 'configuration_item_dns_records.delete', ['example-value', 'example-value'], { dryRun: false, confirm: 'configuration_item_dns_records.delete' })"
50806
+ ],
50807
+ "permissions": "unknown",
50808
+ "pagination": {
50809
+ "mode": "none"
50810
+ },
50811
+ "resolution": null,
50812
+ "retry": {
50813
+ "preset": "retry-1849870d"
50814
+ },
50815
+ "errors": {
50816
+ "set": 2
50817
+ },
50818
+ "metadata": {
50819
+ "purpose": "Delete a configuration item DNS record.",
50820
+ "usage": "Irreversible; dry-run validates the target id first. Parent-scoped: parentId + id.",
50821
+ "preferredWhen": null,
50822
+ "related": [
50823
+ "configuration_item_dns_records.get"
50824
+ ],
50825
+ "untrustedFields": [
50826
+ "data",
50827
+ "dnsType"
50828
+ ]
50829
+ },
50830
+ "compact": null,
50831
+ "status": "tested"
50832
+ },
50833
+ {
50834
+ "id": "configuration_item_dns_records.get",
50835
+ "resource": "configuration_item_dns_records",
50836
+ "udfCapable": false,
50837
+ "operation": "get",
50838
+ "kind": "primitive",
50839
+ "endpoint": "GET /V1.0/ConfigurationItems/{parentId}/DnsRecords/{id}",
50840
+ "effect": "read",
50841
+ "flags": [],
50842
+ "dryRun": false,
50843
+ "envelope": "ItemQueryResultModel[ConfigurationItemDnsRecordModel,InstalledProductDnsRecord]",
50844
+ "inputSchema": {
50845
+ "parentId": {
50846
+ "type": "string | number",
50847
+ "required": true,
50848
+ "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
50849
+ },
50850
+ "id": {
50851
+ "type": "string | number",
50852
+ "required": true,
50853
+ "description": "The record id (number, or a canonical integer string — ids beyond 2^53 are supported via the string form)."
50854
+ },
50855
+ "opts": {
50856
+ "type": "object",
50857
+ "required": false,
50858
+ "description": "The read options bag (CLOSED): { fresh?: boolean } — fresh: true bypasses the read-cache lookup and refreshes the entry with the live response. Omitted: the cached read (default unchanged). A positional fresh via invoke is REFUSED (typed error, zero wire — the fresh invoke option is the only spelling); the typed method get(id, { fresh: true }) is unchanged.",
50859
+ "properties": [
50860
+ {
50861
+ "name": "fresh",
50862
+ "type": "boolean",
50863
+ "optional": true
50864
+ }
50865
+ ]
50866
+ }
50867
+ },
50868
+ "inputSchemaStrict": true,
50869
+ "outputSchema": {
50870
+ "type": "ItemQueryResultModel[ConfigurationItemDnsRecordModel,InstalledProductDnsRecord]",
50871
+ "drops": []
50872
+ },
50873
+ "examples": [
50874
+ "await client.configurationItemDnsRecords.get('example-value', 'example-value')"
50875
+ ],
50876
+ "permissions": "unknown",
50877
+ "pagination": {
50878
+ "mode": "none"
50879
+ },
50880
+ "resolution": null,
50881
+ "retry": {
50882
+ "preset": "retry-ffb3a9cb"
50883
+ },
50884
+ "errors": {
50885
+ "set": 3
50886
+ },
50887
+ "metadata": {
50888
+ "purpose": "Get one ConfigurationItemDnsRecord by id.",
50889
+ "usage": "item: null on the 200 body maps to NotFoundError (vendor not-found signal). Parent-scoped: parentId + id.",
50890
+ "preferredWhen": "Preferred when the numeric id is already known; configuration_item_dns_records.resolve is for a field value.",
50891
+ "related": [
50892
+ "configuration_item_dns_records.resolve"
50893
+ ],
50894
+ "args": "args are (parentId: number, id: number) Item GET returns the FULL vendor model — the vendor documents no field selection on single-record reads. For a slim record use a configuration_item_dns_records.query with includeFields.",
50895
+ "untrustedFields": [
50896
+ "data",
50897
+ "dnsType"
50898
+ ]
50899
+ },
50900
+ "compact": null,
50901
+ "status": "tested"
50902
+ },
50903
+ {
50904
+ "id": "configuration_item_dns_records.getEntityInfo",
50905
+ "resource": "configuration_item_dns_records",
50906
+ "udfCapable": false,
50907
+ "operation": "getEntityInfo",
50908
+ "kind": "primitive",
50909
+ "endpoint": "GET /V1.0/ConfigurationItemDnsRecords/entityInformation",
50910
+ "effect": "read",
50911
+ "flags": [],
50912
+ "dryRun": false,
50913
+ "envelope": "EntityInformationResultModel",
50914
+ "inputSchema": {},
50915
+ "inputSchemaStrict": true,
50916
+ "outputSchema": {
50917
+ "type": "EntityInformationResultModel",
50918
+ "drops": []
50919
+ },
50920
+ "examples": [
50921
+ "await client.configurationItemDnsRecords.getEntityInfo()"
50922
+ ],
50923
+ "permissions": "unknown",
50924
+ "pagination": {
50925
+ "mode": "none"
50926
+ },
50927
+ "resolution": null,
50928
+ "retry": {
50929
+ "preset": "retry-ffb3a9cb"
50930
+ },
50931
+ "errors": {
50932
+ "set": 0
50933
+ },
50934
+ "metadata": {
50935
+ "purpose": "Get the ConfigurationItemDnsRecord capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
50936
+ "usage": "Unwraps info{}; drives client-side capability checks.",
50937
+ "preferredWhen": null,
50938
+ "related": [
50939
+ "configuration_item_dns_records.getFieldInfo"
50940
+ ],
50941
+ "untrustedFields": [
50942
+ "data",
50943
+ "dnsType"
50944
+ ]
50945
+ },
50946
+ "compact": null,
50947
+ "status": "tested"
50948
+ },
50949
+ {
50950
+ "id": "configuration_item_dns_records.getFieldInfo",
50951
+ "resource": "configuration_item_dns_records",
50952
+ "udfCapable": false,
50953
+ "operation": "getFieldInfo",
50954
+ "kind": "primitive",
50955
+ "endpoint": "GET /V1.0/ConfigurationItemDnsRecords/entityInformation/fields",
50956
+ "effect": "read",
50957
+ "flags": [],
50958
+ "dryRun": false,
50959
+ "envelope": "FieldInformationResultModel",
50960
+ "inputSchema": {},
50961
+ "inputSchemaStrict": true,
50962
+ "outputSchema": {
50963
+ "type": "FieldInformationResultModel",
50964
+ "drops": []
50965
+ },
50966
+ "examples": [
50967
+ "await client.configurationItemDnsRecords.getFieldInfo()"
50968
+ ],
50969
+ "permissions": "unknown",
50970
+ "pagination": {
50971
+ "mode": "none"
50972
+ },
50973
+ "resolution": null,
50974
+ "retry": {
50975
+ "preset": "retry-ffb3a9cb"
50976
+ },
50977
+ "errors": {
50978
+ "set": 0
50979
+ },
50980
+ "metadata": {
50981
+ "purpose": "Get the ConfigurationItemDnsRecord field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
50982
+ "usage": "Unwraps fields[]; full raw field dump — the largest read of the info trio (compact discovery: operations.fieldCatalog); the raw dump is also the basis for UDF handling.",
50983
+ "preferredWhen": null,
50984
+ "related": [
50985
+ "configuration_item_dns_records.getEntityInfo",
50986
+ "configuration_item_dns_records.getUdfInfo"
50987
+ ],
50988
+ "untrustedFields": [
50989
+ "data",
50990
+ "dnsType"
50991
+ ]
50992
+ },
50993
+ "compact": null,
50994
+ "status": "tested"
50995
+ },
50996
+ {
50997
+ "id": "configuration_item_dns_records.getUdfInfo",
50998
+ "resource": "configuration_item_dns_records",
50999
+ "udfCapable": false,
51000
+ "operation": "getUdfInfo",
51001
+ "kind": "primitive",
51002
+ "endpoint": "GET /V1.0/ConfigurationItemDnsRecords/entityInformation/userDefinedFields",
51003
+ "effect": "read",
51004
+ "flags": [],
51005
+ "dryRun": false,
51006
+ "envelope": "UserDefinedFieldInformationResultModel",
51007
+ "inputSchema": {},
51008
+ "inputSchemaStrict": true,
51009
+ "outputSchema": {
51010
+ "type": "UserDefinedFieldInformationResultModel",
51011
+ "drops": []
51012
+ },
51013
+ "examples": [
51014
+ "await client.configurationItemDnsRecords.getUdfInfo()"
51015
+ ],
51016
+ "permissions": "unknown",
51017
+ "pagination": {
51018
+ "mode": "none"
51019
+ },
51020
+ "resolution": null,
51021
+ "retry": {
51022
+ "preset": "retry-ffb3a9cb"
51023
+ },
51024
+ "errors": {
51025
+ "set": 0
51026
+ },
51027
+ "metadata": {
51028
+ "purpose": "Get the ConfigurationItemDnsRecord user-defined-field catalog.",
51029
+ "usage": "Unwraps fields[]; only meaningful where the entity is UDF-capable. (entity is not UDF-capable; catalog is expected empty).",
51030
+ "preferredWhen": null,
51031
+ "related": [
51032
+ "configuration_item_dns_records.getFieldInfo"
51033
+ ],
51034
+ "untrustedFields": [
51035
+ "data",
51036
+ "dnsType"
51037
+ ]
51038
+ },
51039
+ "compact": null,
51040
+ "status": "tested"
51041
+ },
51042
+ {
51043
+ "id": "configuration_item_dns_records.query",
51044
+ "resource": "configuration_item_dns_records",
51045
+ "udfCapable": false,
51046
+ "operation": "query",
51047
+ "kind": "primitive",
51048
+ "endpoint": "GET|POST /V1.0/ConfigurationItemDnsRecords/query",
50573
51049
  "effect": "read",
50574
51050
  "flags": [],
50575
51051
  "dryRun": false,
@@ -50745,6 +51221,482 @@ const CAPABILITY_DATA = {
50745
51221
  "compact": "ConfigurationItemDnsRecordSummary",
50746
51222
  "status": "tested"
50747
51223
  },
51224
+ {
51225
+ "id": "configuration_item_note_attachments.count",
51226
+ "resource": "configuration_item_note_attachments",
51227
+ "udfCapable": false,
51228
+ "operation": "count",
51229
+ "kind": "primitive",
51230
+ "endpoint": "GET|POST /V1.0/ConfigurationItemNoteAttachments/query/count",
51231
+ "effect": "read",
51232
+ "flags": [],
51233
+ "dryRun": false,
51234
+ "envelope": "QueryCountResultModel",
51235
+ "inputSchema": {
51236
+ "params": {
51237
+ "type": "object",
51238
+ "required": false,
51239
+ "description": "The query params object (CLOSED — unknown keys are refused pre-request): { filter?: FilterCondition[], fieldCheck?: boolean } — filter is the only wire parameter (the count endpoint takes no MaxRecords/IncludeFields; fieldCheck is consumed by the invoke router — never sent to the vendor). Filter condition field names are name-checked pre-request the same way as the query bag: a refusal costs zero /query/count wire (the cold fieldCache may cost the one authority metadata GET first). fieldCheck: false disables the name check (a non-boolean is refused pre-request; the shape/grammar checks always run) — the opt-out works on the count verb too.",
51240
+ "properties": [
51241
+ {
51242
+ "name": "filter",
51243
+ "type": "FilterCondition[]",
51244
+ "optional": true
51245
+ },
51246
+ {
51247
+ "name": "fieldCheck",
51248
+ "type": "boolean",
51249
+ "optional": true
51250
+ }
51251
+ ]
51252
+ }
51253
+ },
51254
+ "inputSchemaStrict": true,
51255
+ "outputSchema": {
51256
+ "type": "QueryCountResultModel",
51257
+ "drops": []
51258
+ },
51259
+ "examples": [
51260
+ "await invoke(client, 'configuration_item_note_attachments.count', [{ filter: [{ field: 'configurationItemNoteID', op: 'eq', value: 7 }] }])"
51261
+ ],
51262
+ "permissions": "unknown",
51263
+ "pagination": {
51264
+ "mode": "none"
51265
+ },
51266
+ "resolution": null,
51267
+ "retry": {
51268
+ "preset": "retry-ffb3a9cb"
51269
+ },
51270
+ "errors": {
51271
+ "set": 0
51272
+ },
51273
+ "metadata": {
51274
+ "purpose": "Count configuration item note attachment records matching a JSON filter. Use configurationItemNoteID for note scope.",
51275
+ "usage": "Unwraps queryCount; returns a plain number. Include an object-specific configurationItemNoteID filter. configurationItemID identifies the owning asset and is distinct from the attachment path’s note identifier. creatorType, data and fileSize are not queryable. Object-specific filters do not establish exact direct-parent attachment membership; an empty result is conditional on API-user permissions and visibility.",
51276
+ "preferredWhen": null,
51277
+ "related": [
51278
+ "configuration_item_note_attachments.query"
51279
+ ],
51280
+ "args": "args[0] is a params object (CLOSED — unknown keys are refused pre-request): { filter?: FilterCondition[], fieldCheck?: boolean } — filter is the only parameter sent to the vendor (the count endpoint takes no MaxRecords/IncludeFields; fieldCheck is consumed by the invoke router — never sent to the vendor). Filter condition field names are name-checked pre-request the same way as the query bag: a refusal costs zero /query/count wire (the cold fieldCache may cost the one authority metadata GET first). fieldCheck: false disables the name check (a non-boolean is refused pre-request; the shape/grammar checks always run) — the opt-out works on the count verb too. Filter grammar: 13 operators: eq, noteq, gt, gte, lt, lte, beginsWith, endsWith, contains, exist, notExist, in, notIn (in/notIn: array or '1,2,3') + and/or grouping (no not-group). Field names in vendor API casing — get them via operations.fieldCatalog. Caps: 500 OR-conditions / 1 UDF / 8000 chars.",
51281
+ "untrustedFields": [
51282
+ "title"
51283
+ ]
51284
+ },
51285
+ "compact": null,
51286
+ "status": "tested"
51287
+ },
51288
+ {
51289
+ "id": "configuration_item_note_attachments.create",
51290
+ "resource": "configuration_item_note_attachments",
51291
+ "udfCapable": false,
51292
+ "operation": "create",
51293
+ "kind": "primitive",
51294
+ "endpoint": "POST /V1.0/ConfigurationItemNotes/{parentId}/Attachments",
51295
+ "effect": "write",
51296
+ "flags": [],
51297
+ "dryRun": true,
51298
+ "envelope": "OperationResultModel",
51299
+ "inputSchema": {
51300
+ "parentId": {
51301
+ "type": "string | number",
51302
+ "required": true,
51303
+ "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
51304
+ },
51305
+ "data": {
51306
+ "type": "object",
51307
+ "required": true,
51308
+ "description": "The record payload (vendor model fields)."
51309
+ }
51310
+ },
51311
+ "inputSchemaStrict": true,
51312
+ "outputSchema": {
51313
+ "type": "OperationResultModel",
51314
+ "drops": []
51315
+ },
51316
+ "examples": [
51317
+ "const fields = await client.configurationItemNoteAttachments.getFieldInfo();\nconst values = fields.find(field => field.name === 'publish')?.picklistValues?.filter(value => value.isActive === true && /^-?\\d+$/.test(value.value) && Number.isSafeInteger(Number(value.value)));\nif (!values?.length) throw new Error('No active numeric publish value is exposed');\nawait client.configurationItemNoteAttachments.create(7, { attachmentType: 'FILE_ATTACHMENT', fullPath: 'note.txt', title: 'Supporting note', publish: Number(values[0].value), data: 'bm90ZQ==' }, { dryRun: true });"
51318
+ ],
51319
+ "permissions": "unknown",
51320
+ "pagination": {
51321
+ "mode": "none"
51322
+ },
51323
+ "resolution": null,
51324
+ "retry": {
51325
+ "preset": "retry-c5657094"
51326
+ },
51327
+ "errors": {
51328
+ "set": 1
51329
+ },
51330
+ "metadata": {
51331
+ "purpose": "Create a file attachment under a configuration-item note.",
51332
+ "usage": "Create a file attachment under ConfigurationItemNotes/{parentId}/Attachments. Use the configuration-item note id as parentId. Required inputs are attachmentType FILE_ATTACHMENT, title and fullPath (at most 255 characters), numeric publish from current metadata, and base64 data. The vendor validates permissions, visibility, resource impersonation and file limits. Existing attachments cannot be updated. For documented nesting use the owning configuration-item attachment route. Exact-parent deduplication is unproven, so use explicit create.",
51333
+ "preferredWhen": "Add a new attachment; existing attachments cannot be updated. Replace through separately governed delete and create actions.",
51334
+ "related": [
51335
+ "configuration_item_note_attachments.get"
51336
+ ],
51337
+ "argNotes": {
51338
+ "data": "File uploads only. Asset and note associations, audit fields, contentType, creatorType, fileSize, contact author overrides and nesting references are outside the supported create body. Resource impersonation uses the configured ImpersonationResourceID header. Other attachment types and UDF writes are unsupported."
51339
+ },
51340
+ "untrustedFields": [
51341
+ "title"
51342
+ ],
51343
+ "createRequirements": {
51344
+ "requires": {
51345
+ "allOf": [
51346
+ "attachmentType",
51347
+ "fullPath",
51348
+ "title",
51349
+ "publish",
51350
+ "data"
51351
+ ]
51352
+ },
51353
+ "requiresByValue": [
51354
+ {
51355
+ "field": "attachmentType",
51356
+ "value": "FILE_ATTACHMENT",
51357
+ "requires": {
51358
+ "allOf": [
51359
+ "data"
51360
+ ]
51361
+ }
51362
+ }
51363
+ ]
51364
+ }
51365
+ },
51366
+ "compact": null,
51367
+ "status": "tested"
51368
+ },
51369
+ {
51370
+ "id": "configuration_item_note_attachments.delete",
51371
+ "resource": "configuration_item_note_attachments",
51372
+ "udfCapable": false,
51373
+ "operation": "delete",
51374
+ "kind": "primitive",
51375
+ "endpoint": "DELETE /V1.0/ConfigurationItemNotes/{parentId}/Attachments/{id}",
51376
+ "effect": "destructive",
51377
+ "flags": [
51378
+ "idempotent",
51379
+ "requiresApproval"
51380
+ ],
51381
+ "dryRun": true,
51382
+ "envelope": "OperationResultModel (attachment entities: the deleted attachment model is returned, not OperationResultModel)",
51383
+ "inputSchema": {
51384
+ "parentId": {
51385
+ "type": "string | number",
51386
+ "required": true,
51387
+ "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
51388
+ },
51389
+ "id": {
51390
+ "type": "string | number",
51391
+ "required": true,
51392
+ "description": "The record id (number, or a canonical integer string — ids beyond 2^53 are supported via the string form)."
51393
+ }
51394
+ },
51395
+ "inputSchemaStrict": true,
51396
+ "outputSchema": {
51397
+ "type": "OperationResultModel (attachment entities: the deleted attachment model is returned, not OperationResultModel)",
51398
+ "drops": []
51399
+ },
51400
+ "examples": [
51401
+ "await invoke(client, 'configuration_item_note_attachments.delete', [7, 3], { confirm: 'configuration_item_note_attachments.delete' })"
51402
+ ],
51403
+ "permissions": "unknown",
51404
+ "pagination": {
51405
+ "mode": "none"
51406
+ },
51407
+ "resolution": null,
51408
+ "retry": {
51409
+ "preset": "retry-1849870d"
51410
+ },
51411
+ "errors": {
51412
+ "set": 2
51413
+ },
51414
+ "metadata": {
51415
+ "purpose": "Delete an attachment under a configuration-item note.",
51416
+ "usage": "Irreversible. Confirm the exact operation before governed deletion. Dry-run verifies the attachment under the supplied note id. Arguments are (note id, attachment id).",
51417
+ "preferredWhen": null,
51418
+ "related": [
51419
+ "configuration_item_note_attachments.get"
51420
+ ],
51421
+ "untrustedFields": [
51422
+ "title"
51423
+ ]
51424
+ },
51425
+ "compact": null,
51426
+ "status": "tested"
51427
+ },
51428
+ {
51429
+ "id": "configuration_item_note_attachments.get",
51430
+ "resource": "configuration_item_note_attachments",
51431
+ "udfCapable": false,
51432
+ "operation": "get",
51433
+ "kind": "primitive",
51434
+ "endpoint": "GET /V1.0/ConfigurationItemNotes/{parentId}/Attachments/{id}",
51435
+ "effect": "read",
51436
+ "flags": [],
51437
+ "dryRun": false,
51438
+ "envelope": "ConfigurationItemNoteAttachmentModel",
51439
+ "inputSchema": {
51440
+ "parentId": {
51441
+ "type": "string | number",
51442
+ "required": true,
51443
+ "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
51444
+ },
51445
+ "id": {
51446
+ "type": "string | number",
51447
+ "required": true,
51448
+ "description": "The record id (number, or a canonical integer string — ids beyond 2^53 are supported via the string form)."
51449
+ },
51450
+ "opts": {
51451
+ "type": "object",
51452
+ "required": false,
51453
+ "description": "The read options bag (CLOSED): { fresh?: boolean } — fresh: true bypasses the read-cache lookup and refreshes the entry with the live response. Omitted: the cached read (default unchanged). A positional fresh via invoke is REFUSED (typed error, zero wire — the fresh invoke option is the only spelling); the typed method get(id, { fresh: true }) is unchanged.",
51454
+ "properties": [
51455
+ {
51456
+ "name": "fresh",
51457
+ "type": "boolean",
51458
+ "optional": true
51459
+ }
51460
+ ]
51461
+ }
51462
+ },
51463
+ "inputSchemaStrict": true,
51464
+ "outputSchema": {
51465
+ "type": "ConfigurationItemNoteAttachmentModel",
51466
+ "drops": []
51467
+ },
51468
+ "examples": [
51469
+ "await client.configurationItemNoteAttachments.get(7, 3)"
51470
+ ],
51471
+ "permissions": "unknown",
51472
+ "pagination": {
51473
+ "mode": "none"
51474
+ },
51475
+ "resolution": null,
51476
+ "retry": {
51477
+ "preset": "retry-ffb3a9cb"
51478
+ },
51479
+ "errors": {
51480
+ "set": 3
51481
+ },
51482
+ "metadata": {
51483
+ "purpose": "Get one ConfigurationItemNoteAttachment by id.",
51484
+ "usage": "Returns the attachment model directly; item: null or an empty model is a typed not-found. Parent-scoped: parentId is the configuration-item note id, followed by the attachment id.",
51485
+ "preferredWhen": "Use a known note id and attachment id. Use the global query filtered by configurationItemNoteID to discover attachments.",
51486
+ "related": [
51487
+ "configuration_item_note_attachments.query"
51488
+ ],
51489
+ "args": "args are (parentId: number, id: number) Item GET returns the FULL vendor model — the vendor documents no field selection on single-record reads. For a slim record use a configuration_item_note_attachments.query with includeFields.",
51490
+ "untrustedFields": [
51491
+ "title"
51492
+ ]
51493
+ },
51494
+ "compact": null,
51495
+ "status": "tested"
51496
+ },
51497
+ {
51498
+ "id": "configuration_item_note_attachments.getEntityInfo",
51499
+ "resource": "configuration_item_note_attachments",
51500
+ "udfCapable": false,
51501
+ "operation": "getEntityInfo",
51502
+ "kind": "primitive",
51503
+ "endpoint": "GET /V1.0/ConfigurationItemNoteAttachments/entityInformation",
51504
+ "effect": "read",
51505
+ "flags": [],
51506
+ "dryRun": false,
51507
+ "envelope": "EntityInformationResultModel",
51508
+ "inputSchema": {},
51509
+ "inputSchemaStrict": true,
51510
+ "outputSchema": {
51511
+ "type": "EntityInformationResultModel",
51512
+ "drops": []
51513
+ },
51514
+ "examples": [
51515
+ "await client.configurationItemNoteAttachments.getEntityInfo()"
51516
+ ],
51517
+ "permissions": "unknown",
51518
+ "pagination": {
51519
+ "mode": "none"
51520
+ },
51521
+ "resolution": null,
51522
+ "retry": {
51523
+ "preset": "retry-ffb3a9cb"
51524
+ },
51525
+ "errors": {
51526
+ "set": 0
51527
+ },
51528
+ "metadata": {
51529
+ "purpose": "Get the ConfigurationItemNoteAttachment capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
51530
+ "usage": "Unwraps info{}; drives client-side capability checks.",
51531
+ "preferredWhen": null,
51532
+ "related": [
51533
+ "configuration_item_note_attachments.getFieldInfo"
51534
+ ],
51535
+ "untrustedFields": [
51536
+ "title"
51537
+ ]
51538
+ },
51539
+ "compact": null,
51540
+ "status": "tested"
51541
+ },
51542
+ {
51543
+ "id": "configuration_item_note_attachments.getFieldInfo",
51544
+ "resource": "configuration_item_note_attachments",
51545
+ "udfCapable": false,
51546
+ "operation": "getFieldInfo",
51547
+ "kind": "primitive",
51548
+ "endpoint": "GET /V1.0/ConfigurationItemNoteAttachments/entityInformation/fields",
51549
+ "effect": "read",
51550
+ "flags": [],
51551
+ "dryRun": false,
51552
+ "envelope": "FieldInformationResultModel",
51553
+ "inputSchema": {},
51554
+ "inputSchemaStrict": true,
51555
+ "outputSchema": {
51556
+ "type": "FieldInformationResultModel",
51557
+ "drops": []
51558
+ },
51559
+ "examples": [
51560
+ "await client.configurationItemNoteAttachments.getFieldInfo()"
51561
+ ],
51562
+ "permissions": "unknown",
51563
+ "pagination": {
51564
+ "mode": "none"
51565
+ },
51566
+ "resolution": null,
51567
+ "retry": {
51568
+ "preset": "retry-ffb3a9cb"
51569
+ },
51570
+ "errors": {
51571
+ "set": 0
51572
+ },
51573
+ "metadata": {
51574
+ "purpose": "Get the ConfigurationItemNoteAttachment field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
51575
+ "usage": "Unwraps fields[]; full raw field dump — the largest read of the info trio (compact discovery: operations.fieldCatalog); the raw dump is also the basis for UDF handling.",
51576
+ "preferredWhen": null,
51577
+ "related": [
51578
+ "configuration_item_note_attachments.getEntityInfo"
51579
+ ],
51580
+ "untrustedFields": [
51581
+ "title"
51582
+ ]
51583
+ },
51584
+ "compact": null,
51585
+ "status": "tested"
51586
+ },
51587
+ {
51588
+ "id": "configuration_item_note_attachments.query",
51589
+ "resource": "configuration_item_note_attachments",
51590
+ "udfCapable": false,
51591
+ "operation": "query",
51592
+ "kind": "primitive",
51593
+ "endpoint": "GET|POST /V1.0/ConfigurationItemNoteAttachments/query",
51594
+ "effect": "read",
51595
+ "flags": [],
51596
+ "dryRun": false,
51597
+ "envelope": "QueryActionResult[<Model>,<Entity>]",
51598
+ "inputSchema": {
51599
+ "params": {
51600
+ "type": "object",
51601
+ "required": false,
51602
+ "description": "The query params object (CLOSED — unknown keys are refused pre-request with a typed error naming the key + the valid keys): { filter?: FilterCondition[], limit?: number (total cap, default 500, max 2500 — NOT a page size), latest?: number (1-2500; the N highest-id rows — the vendor has no sort; count-probe + id-threshold semantics, see docs/API.md §4; the same-process latest-walk count probes are briefly cached per client — a 30 s TTL, cleared on a write through this client (a probe in flight across the write is discarded by the cache's invalidation epoch); the plain count op and aggregate stay fresh; limit and latest may coexist only when limit >= latest), noteChars?: number (integer >= 1; opt-in per-field char cap on the untrusted-class free-text fields of the resource (notes/descriptions/UDF prose): each capped value = the first N chars + the explicit marker … [+N chars truncated] (N = chars removed), applied at result-build BEFORE the server-side untrusted wrapper; absent = the raw, untruncated result), includeFields?: string[], fieldCheck?: boolean (default true: every includeFields NAME and every filter condition FIELD NAME is checked pre-request against the live field set (the vendored spec when that read faults — the resource's plan-pinned live-only fields, metadata.liveOnlyFields, are exempt from the vendored refusal: the live entity carries them and the vendor model omits them (e.g. time_entries postedDate/postedOnTime) — a truly unknown name is still refused); a refusal costs zero QUERY wire — the query POST and the count probe that anchors latest are never issued, a COLD fieldCache performs one authority metadata GET first (zero on a warm one); the one udf:true condition per query is exempt (a tenant UDF name is absent from the vendored spec by definition); false disables both name checks, never the shape/grammar checks; the count verb's bag is name-checked the same way and carries the same fieldCheck opt-out; a direct queryBounded/queryAll call is not checked (no bag contract there)), names?: boolean (absent = the client's labels option — OFF by default (the label pass costs a field-catalog read + up to 20 cold name reads per call; the MCP server (iit-mcp-autotask) enables the client labels option when it re-pins to this version (downstream)); true adds the row label siblings: picklist <field>Label (statusLabel), <fk>Name for companyID/contractID/ticketID/roleID/billingCodeID/*ResourceID (contractIDName, assignedResourceIDName) — null, never missing, when the field is keyed with a null value, a 0 id or an unresolved value (a picklist 0 is labelled when the picklist defines it); a names summary appears only when something was left unlabelled (the 20 uncached name-read cap or an unresolved picklist value); false = raw ids, ~30% smaller on a full tickets row), via?: \"post\" | \"get\" (vendor GET has a 2048-char cap), acknowledgeUnscoped?: boolean (query verb only; a walk expected to read over 500 rows with no id scope in the filter is guarded — one pre-flight <resource>.count, and a count over 500 refuses with the typed SCOPE_REQUIRED before the walk; true walks the unscoped set anyway; a count that fails or is blind lets the walk run and the result's scopeNote says so), walk?: object (walk.maxRows: positive integer — (D6): the walk's TOTAL row cap — serves at most maxRows rows in total; the page size stays min(500, limit), so one vendor page may fetch more rows than maxRows and the surplus is sliced off (fetched, not served); the result's truncated flag — false only when the cursor is exhausted, true iff more rows exist past the cap (so an exact-multiple count with a live next page reports true); not combinable with latest) }. Filter grammar: 13 operators (eq, noteq, gt, gte, lt, lte, beginsWith, endsWith, contains, exist, notExist, in, notIn; in/notIn: array or \"1,2,3\") + and/or grouping (no not-group); field names in vendor API casing (via operations.fieldCatalog); caps: 500 OR-conditions / 1 UDF / 8000 chars.",
51603
+ "properties": [
51604
+ {
51605
+ "name": "filter",
51606
+ "type": "FilterCondition[]",
51607
+ "optional": true
51608
+ },
51609
+ {
51610
+ "name": "limit",
51611
+ "type": "number",
51612
+ "optional": true,
51613
+ "default": 500
51614
+ },
51615
+ {
51616
+ "name": "latest",
51617
+ "type": "number",
51618
+ "optional": true
51619
+ },
51620
+ {
51621
+ "name": "noteChars",
51622
+ "type": "number",
51623
+ "optional": true
51624
+ },
51625
+ {
51626
+ "name": "includeFields",
51627
+ "type": "string[]",
51628
+ "optional": true
51629
+ },
51630
+ {
51631
+ "name": "fieldCheck",
51632
+ "type": "boolean",
51633
+ "optional": true,
51634
+ "default": true
51635
+ },
51636
+ {
51637
+ "name": "names",
51638
+ "type": "boolean",
51639
+ "optional": true
51640
+ },
51641
+ {
51642
+ "name": "via",
51643
+ "type": "\"post\" | \"get\"",
51644
+ "optional": true
51645
+ },
51646
+ {
51647
+ "name": "acknowledgeUnscoped",
51648
+ "type": "boolean",
51649
+ "optional": true
51650
+ },
51651
+ {
51652
+ "name": "walk",
51653
+ "type": "object",
51654
+ "optional": true
51655
+ }
51656
+ ]
51657
+ }
51658
+ },
51659
+ "inputSchemaStrict": true,
51660
+ "outputSchema": {
51661
+ "type": "QueryActionResult[<Model>,<Entity>]",
51662
+ "drops": []
51663
+ },
51664
+ "examples": [
51665
+ "await invoke(client, 'configuration_item_note_attachments.query', [{ filter: [{ field: 'configurationItemNoteID', op: 'eq', value: 7 }], limit: 25 }])"
51666
+ ],
51667
+ "permissions": "unknown",
51668
+ "pagination": {
51669
+ "mode": "cursor",
51670
+ "vendorDefault": 10,
51671
+ "vendorMax": 500,
51672
+ "pageGuard": 1000,
51673
+ "queryBounded": {
51674
+ "default": 500,
51675
+ "max": 2500
51676
+ }
51677
+ },
51678
+ "resolution": null,
51679
+ "retry": {
51680
+ "preset": "retry-ffb3a9cb"
51681
+ },
51682
+ "errors": {
51683
+ "set": 4
51684
+ },
51685
+ "metadata": {
51686
+ "purpose": "Query ConfigurationItemNoteAttachment records with a JSON filter.",
51687
+ "usage": "Server-side pagination: one call walks the vendor cursor internally (page 1 POSTs the QueryModel body with MaxRecords = the walk's internal page size (at most 500; the default POST path — `via: 'get'` issues a GET on page 1); later pages POST the SAME body — IncludeFields, MaxRecords and the preserved filter — to the absolute vendor cursor, rebased to the client base URL; the vendor honours IncludeFields on a continuation and ignores MaxRecords there, so a later page carries the vendor's own page size) until the limit is met or the cursor is null; 1000-page guard (hasMore stays true at the guard). queryAll is the unbounded raw walk — only when you need the ENTIRE set and accept a large payload; default to the bounded query op. noteChars: N (integer >= 1) is an opt-in per-field char cap on the untrusted-class free-text fields of the resource (notes/descriptions/UDF prose — the same set the server wraps): each capped value = the first N chars + the explicit marker … [+N chars truncated] (N = chars removed), applied at result-build BEFORE the server-side untrusted wrapper; absent = the raw, untruncated result (zero wire — response-side only). latest: N returns the N highest-id rows (id-descending): the vendor has no sort parameter — this is the only ordering channel, and a date window in `filter` narrows the cost; count-anchored — C ≤ 2500 → one count + a ≤6-page walk of the matching set, C > 2500 → count probes + an id-threshold window (≤64 probes; LATEST_THRESHOLD_UNRESOLVED on budget exhaustion), a blind count → a bounded walk with the blind-surface stamp (LATEST_WINDOW_INCOMPLETE on a truncated walk). Parent-scoped entity: the query stays global (filter with configurationItemNoteID eq <parentId> where the parent is known). Explicit walk.maxRows independently sets the TOTAL returned-row cap (including export-sized walks); the ordinary limit is still validated in 1..2500 and only bounds the internal page size for this form. hasMore and truncated remain true at the page guard or while a cursor or unserved fetched rows remain. Self-resource prefixes are accepted in filter fields and includeFields; dotted UDF names are always refused before metadata or vendor requests, never rewritten to another tenant UDF. Include an object-specific configurationItemNoteID filter. configurationItemID identifies the owning asset and is distinct from the attachment path’s note identifier. creatorType, data and fileSize are not queryable. Object-specific filters do not establish exact direct-parent attachment membership; an empty result is conditional on API-user permissions and visibility. The Swagger query response names an attachment model, while this collection uses the existing SDK attachment query contract { items, pageDetails }; a bare-model response is rejected as INVALID_RESPONSE rather than guessed into a collection.",
51688
+ "preferredWhen": "Default for filtered reads (the bounded query op). queryAll is the unbounded raw walk — only when you need the ENTIRE set and accept a large payload; default to the bounded query op. Prefer an includeFields subset over the full model (field names via operations.fieldCatalog). latest: N is the latest-N rows (id-descending) when the newest rows are the goal (the vendor has no sort — count-anchored, docs/API.md §4). Prefer a hand-listed includeFields for common narrow reads (removed the closed fieldsPreset presets — the v1 billing_join field list for billing_items.query, if you need it, is: companyID, ticketID, projectID, timeEntryID, contractServiceID, contractID, billingCodeID, expenseItemID, itemDate, quantity, rate, extendedPrice, totalAmount, nonBillable); noteChars: N caps the untrusted-class free-text fields of the resource (notes/descriptions/UDF prose) to N chars each with the explicit … [+N chars truncated] marker (opt-in; the raw result when absent).",
51689
+ "related": [
51690
+ "configuration_item_note_attachments.get"
51691
+ ],
51692
+ "args": "args[0] is a params object: { filter?: FilterCondition[], limit?: total cap (default 500, max 2500; server-side pagination), latest?: number (1-2500 — the N highest-id rows; the vendor has no sort parameter, so this is a count-anchored mechanism — see docs/API.md §4; coexists with limit only when limit >= latest), noteChars?: number (integer >= 1 — opt-in per-field char cap on the untrusted-class free-text fields of the resource (notes/descriptions/UDF prose): each capped value = the first N chars + the explicit marker … [+N chars truncated] (N = chars removed), applied at result-build BEFORE the server-side untrusted wrapper; absent = the raw, untruncated result) maxRecords?: page size — raw SDK `queryAll`/`query` walks only (this bounded query ignores it; the invoke bag refuses it — pass limit), includeFields?: string[], fieldCheck?: boolean (default true — the pre-request field-name check on includeFields names and filter condition fields; false disables it — consumed by the invoke router, never sent to the vendor), via?: \"post\" | \"get\" (the wire method; the vendor GET has a 2048-char cap), acknowledgeUnscoped?: boolean (query verb only; a walk expected over 500 rows with no id scope in the filter is guarded — one pre-flight <resource>.count, and a count over 500 refuses with the typed SCOPE_REQUIRED before the walk; true walks the unscoped set anyway; a count that fails or is blind lets the walk run and the result’s scopeNote says so), walk?: { maxRows: positive integer (D6: the walk’s TOTAL row cap — serves at most maxRows rows in total; the page size stays min(500, limit), so one vendor page may fetch more rows than maxRows and the surplus is sliced off (fetched, not served); the result’s truncated flag — false only when the cursor is exhausted, true iff more rows exist past the cap (so an exact-multiple count with a live next page reports true); not combinable with latest) } }. Filter grammar: 13 operators: eq, noteq, gt, gte, lt, lte, beginsWith, endsWith, contains, exist, notExist, in, notIn (in/notIn: array or '1,2,3') + and/or grouping (no not-group). Field names in vendor API casing — get them via operations.fieldCatalog. Caps: 500 OR-conditions / 1 UDF / 8000 chars. By default the FULL vendor model is returned (all fields). To slim the payload for context savings pass includeFields with the exact vendor field names you need (discover them via operations.fieldCatalog); only those fields + id come back. The subset persists across the internal page walk.",
51693
+ "untrustedFields": [
51694
+ "title"
51695
+ ]
51696
+ },
51697
+ "compact": null,
51698
+ "status": "tested"
51699
+ },
50748
51700
  {
50749
51701
  "id": "configuration_item_notes.count",
50750
51702
  "resource": "configuration_item_notes",
@@ -86114,8 +87066,8 @@ const CAPABILITY_DATA = {
86114
87066
  ]
86115
87067
  },
86116
87068
  "operations": {
86117
- "planHash": "ad752908bb8c2b868f1df63ba52fd308bd4eaec8e6c9c9182f97504ad79f5ca4",
86118
- "builtAt": "2026-11-19T03:48:00.874Z",
87069
+ "planHash": "a84c111cf8c415f470fc48dff7ad406f0f67ee9c2a8d75f963e4812e5a2577b2",
87070
+ "builtAt": "2026-11-19T06:42:18.403Z",
86119
87071
  "records": [
86120
87072
  {
86121
87073
  "id": "operations.aggregate",