node-autotask 0.75.0 → 0.77.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 +1499 -547
  5. package/dist/capabilities-data.js +1498 -546
  6. package/dist/capabilities.cjs +4 -4
  7. package/dist/capabilities.js +1 -1
  8. package/dist/{chunk-VMFQ53HQ.cjs → chunk-3FZJJX5B.cjs} +3 -3
  9. package/dist/{chunk-YGJCTU7F.cjs → chunk-5MH3MPLB.cjs} +32 -30
  10. package/dist/{chunk-54CRUNXF.cjs → chunk-6VBOBCWA.cjs} +355 -24
  11. package/dist/{chunk-MCAGTC6R.js → chunk-F5Y7WBWY.js} +350 -19
  12. package/dist/{chunk-OFYXDB5G.js → chunk-G2U6NHPO.js} +3 -3
  13. package/dist/{chunk-52YS7NCR.cjs → chunk-NAI7XIX4.cjs} +199 -199
  14. package/dist/{chunk-OTDNHBJJ.js → chunk-QTFK2HAO.js} +4 -2
  15. package/dist/{chunk-JEARDPBL.js → chunk-RLXUY4VM.js} +2 -2
  16. package/dist/{index-BEuTtkQE.d.cts → index-B-vNyiD_.d.cts} +92 -1
  17. package/dist/{index-BEuTtkQE.d.ts → index-B-vNyiD_.d.ts} +92 -1
  18. package/dist/{index-BAu5alhB.d.cts → index-PLdAoAFJ.d.cts} +4 -2
  19. package/dist/{index-CNuQgQ_Z.d.ts → index-ecr6unv3.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": "3732a92572dcff19995b19cf9ba1dec6156153313f5d54704d1cca885d1aff45",
414
- "builtAt": "2026-11-19T02:05:42.510Z",
413
+ "planHash": "3b14a93bbda886bce89c87d61ba40092f9acf6a829a959f042be1c3a0744ed42",
414
+ "builtAt": "2026-11-19T05:20:04.039Z",
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": "3732a92572dcff19995b19cf9ba1dec6156153313f5d54704d1cca885d1aff45",
43330
- "builtAt": "2026-11-19T02:05:42.511Z",
43329
+ "planHash": "3b14a93bbda886bce89c87d61ba40092f9acf6a829a959f042be1c3a0744ed42",
43330
+ "builtAt": "2026-11-19T05:20:04.039Z",
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,23 @@ 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",
50573
50481
  "effect": "read",
50574
50482
  "flags": [],
50575
50483
  "dryRun": false,
@@ -50641,7 +50549,7 @@ const CAPABILITY_DATA = {
50641
50549
  "drops": []
50642
50550
  },
50643
50551
  "examples": [
50644
- "await invoke(client, 'configuration_item_dns_records.query', [{ filter: [{ field: 'installedProductID', op: 'eq', value: 7 }], limit: 500 }])"
50552
+ "await client.configurationItemBillingProductAssociations.query({ filter: [{ field: 'name', op: 'eq', value: 'example' }], limit: 500 })"
50645
50553
  ],
50646
50554
  "permissions": "unknown",
50647
50555
  "pagination": {
@@ -50662,24 +50570,20 @@ const CAPABILITY_DATA = {
50662
50570
  "set": 4
50663
50571
  },
50664
50572
  "metadata": {
50665
- "purpose": "Query ConfigurationItemDnsRecord records with a JSON filter.",
50666
- "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 installedProductID 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.",
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.",
50667
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).",
50668
50576
  "related": [
50669
- "configuration_item_dns_records.resolve"
50577
+ "configuration_item_billing_product_associations.resolve"
50670
50578
  ],
50671
- "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.",
50672
- "untrustedFields": [
50673
- "data",
50674
- "dnsType"
50675
- ]
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."
50676
50580
  },
50677
50581
  "compact": null,
50678
50582
  "status": "tested"
50679
50583
  },
50680
50584
  {
50681
- "id": "configuration_item_dns_records.resolve",
50682
- "resource": "configuration_item_dns_records",
50585
+ "id": "configuration_item_billing_product_associations.resolve",
50586
+ "resource": "configuration_item_billing_product_associations",
50683
50587
  "udfCapable": false,
50684
50588
  "operation": "resolve",
50685
50589
  "kind": "helper",
@@ -50709,11 +50613,11 @@ const CAPABILITY_DATA = {
50709
50613
  },
50710
50614
  "inputSchemaStrict": true,
50711
50615
  "outputSchema": {
50712
- "type": "ConfigurationItemDnsRecordSummary",
50616
+ "type": "ConfigurationItemBillingProductAssociationsSummary",
50713
50617
  "drops": []
50714
50618
  },
50715
50619
  "examples": [
50716
- "await client.configurationItemDnsRecords.resolve('example-value')"
50620
+ "await client.configurationItemBillingProductAssociations.resolve('example-value')"
50717
50621
  ],
50718
50622
  "permissions": "unknown",
50719
50623
  "pagination": {
@@ -50731,27 +50635,83 @@ const CAPABILITY_DATA = {
50731
50635
  "set": 5
50732
50636
  },
50733
50637
  "metadata": {
50734
- "purpose": "Resolve a configuration item DNS record from a numeric id (the direct fetch) only — this resource has no searchable text field, so a non-numeric identifier throws a config error.",
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)",
50735
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.",
50736
50640
  "preferredWhen": null,
50737
50641
  "related": [
50738
- "configuration_item_dns_records.get"
50739
- ],
50740
- "untrustedFields": [
50741
- "data",
50742
- "dnsType"
50642
+ "configuration_item_billing_product_associations.get"
50743
50643
  ]
50744
50644
  },
50745
- "compact": "ConfigurationItemDnsRecordSummary",
50645
+ "compact": "ConfigurationItemBillingProductAssociationsSummary",
50746
50646
  "status": "tested"
50747
50647
  },
50748
50648
  {
50749
- "id": "configuration_item_notes.count",
50750
- "resource": "configuration_item_notes",
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",
50751
50711
  "udfCapable": false,
50752
50712
  "operation": "count",
50753
50713
  "kind": "primitive",
50754
- "endpoint": "GET|POST /V1.0/ConfigurationItemNotes/query/count",
50714
+ "endpoint": "GET|POST /V1.0/ConfigurationItemDnsRecords/query/count",
50755
50715
  "effect": "read",
50756
50716
  "flags": [],
50757
50717
  "dryRun": false,
@@ -50781,7 +50741,7 @@ const CAPABILITY_DATA = {
50781
50741
  "drops": []
50782
50742
  },
50783
50743
  "examples": [
50784
- "await client.configurationItemNotes.count({ filter: [{ field: 'name', op: 'eq', value: 'example' }] })"
50744
+ "await invoke(client, 'configuration_item_dns_records.count', [{ filter: [{ field: 'installedProductID', op: 'eq', value: 7 }] }])"
50785
50745
  ],
50786
50746
  "permissions": "unknown",
50787
50747
  "pagination": {
@@ -50795,30 +50755,33 @@ const CAPABILITY_DATA = {
50795
50755
  "set": 0
50796
50756
  },
50797
50757
  "metadata": {
50798
- "purpose": "Count configuration item note records matching a JSON filter.",
50758
+ "purpose": "Count configuration item DNS records matching a JSON filter.",
50799
50759
  "usage": "Unwraps queryCount; returns a plain number.",
50800
50760
  "preferredWhen": null,
50801
50761
  "related": [
50802
- "configuration_item_notes.query"
50762
+ "configuration_item_dns_records.query"
50803
50763
  ],
50804
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.",
50805
50765
  "untrustedFields": [
50806
- "description",
50807
- "title"
50766
+ "data",
50767
+ "dnsType"
50808
50768
  ]
50809
50769
  },
50810
50770
  "compact": null,
50811
50771
  "status": "tested"
50812
50772
  },
50813
50773
  {
50814
- "id": "configuration_item_notes.create",
50815
- "resource": "configuration_item_notes",
50774
+ "id": "configuration_item_dns_records.delete",
50775
+ "resource": "configuration_item_dns_records",
50816
50776
  "udfCapable": false,
50817
- "operation": "create",
50777
+ "operation": "delete",
50818
50778
  "kind": "primitive",
50819
- "endpoint": "POST /V1.0/ConfigurationItems/{parentId}/Notes",
50820
- "effect": "write",
50821
- "flags": [],
50779
+ "endpoint": "DELETE /V1.0/ConfigurationItems/{parentId}/DnsRecords/{id}",
50780
+ "effect": "destructive",
50781
+ "flags": [
50782
+ "idempotent",
50783
+ "requiresApproval"
50784
+ ],
50822
50785
  "dryRun": true,
50823
50786
  "envelope": "OperationResultModel",
50824
50787
  "inputSchema": {
@@ -50827,10 +50790,10 @@ const CAPABILITY_DATA = {
50827
50790
  "required": true,
50828
50791
  "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
50829
50792
  },
50830
- "data": {
50831
- "type": "object",
50793
+ "id": {
50794
+ "type": "string | number",
50832
50795
  "required": true,
50833
- "description": "The record payload (vendor model fields)."
50796
+ "description": "The record id (number, or a canonical integer string — ids beyond 2^53 are supported via the string form)."
50834
50797
  }
50835
50798
  },
50836
50799
  "inputSchemaStrict": true,
@@ -50839,7 +50802,7 @@ const CAPABILITY_DATA = {
50839
50802
  "drops": []
50840
50803
  },
50841
50804
  "examples": [
50842
- "await client.configurationItemNotes.create('example-value', { name: 'example' }, { dryRun: true })"
50805
+ "await invoke(client, 'configuration_item_dns_records.delete', ['example-value', 'example-value'], { dryRun: false, confirm: 'configuration_item_dns_records.delete' })"
50843
50806
  ],
50844
50807
  "permissions": "unknown",
50845
50808
  "pagination": {
@@ -50847,42 +50810,37 @@ const CAPABILITY_DATA = {
50847
50810
  },
50848
50811
  "resolution": null,
50849
50812
  "retry": {
50850
- "preset": "retry-c5657094"
50813
+ "preset": "retry-1849870d"
50851
50814
  },
50852
50815
  "errors": {
50853
- "set": 1
50816
+ "set": 2
50854
50817
  },
50855
50818
  "metadata": {
50856
- "purpose": "Create a configuration item note.",
50857
- "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.",
50858
- "preferredWhen": "Only for a record that does not exist yet; prefer update for an id you already have.",
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,
50859
50822
  "related": [
50860
- "configuration_item_notes.update"
50823
+ "configuration_item_dns_records.get"
50861
50824
  ],
50862
- "deleteBoundary": {
50863
- "resource": "configuration_item_notes",
50864
- "note": "the vendor defines no DELETE for configuration_item_notes (spec-derived: the vendored api-docs.json defines no DELETE on the entity's paths) — a create cannot be undone through the API; cleanup is UI-only.",
50865
- "proof": "spec-derived"
50866
- },
50867
50825
  "untrustedFields": [
50868
- "description",
50869
- "title"
50826
+ "data",
50827
+ "dnsType"
50870
50828
  ]
50871
50829
  },
50872
50830
  "compact": null,
50873
50831
  "status": "tested"
50874
50832
  },
50875
50833
  {
50876
- "id": "configuration_item_notes.get",
50877
- "resource": "configuration_item_notes",
50834
+ "id": "configuration_item_dns_records.get",
50835
+ "resource": "configuration_item_dns_records",
50878
50836
  "udfCapable": false,
50879
50837
  "operation": "get",
50880
50838
  "kind": "primitive",
50881
- "endpoint": "GET /V1.0/ConfigurationItems/{parentId}/Notes/{id}",
50839
+ "endpoint": "GET /V1.0/ConfigurationItems/{parentId}/DnsRecords/{id}",
50882
50840
  "effect": "read",
50883
50841
  "flags": [],
50884
50842
  "dryRun": false,
50885
- "envelope": "ItemQueryResultModel[ConfigurationItemNoteModel,InstalledProductNote]",
50843
+ "envelope": "ItemQueryResultModel[ConfigurationItemDnsRecordModel,InstalledProductDnsRecord]",
50886
50844
  "inputSchema": {
50887
50845
  "parentId": {
50888
50846
  "type": "string | number",
@@ -50909,11 +50867,11 @@ const CAPABILITY_DATA = {
50909
50867
  },
50910
50868
  "inputSchemaStrict": true,
50911
50869
  "outputSchema": {
50912
- "type": "ItemQueryResultModel[ConfigurationItemNoteModel,InstalledProductNote]",
50870
+ "type": "ItemQueryResultModel[ConfigurationItemDnsRecordModel,InstalledProductDnsRecord]",
50913
50871
  "drops": []
50914
50872
  },
50915
50873
  "examples": [
50916
- "await client.configurationItemNotes.get('example-value', 'example-value')"
50874
+ "await client.configurationItemDnsRecords.get('example-value', 'example-value')"
50917
50875
  ],
50918
50876
  "permissions": "unknown",
50919
50877
  "pagination": {
@@ -50927,28 +50885,28 @@ const CAPABILITY_DATA = {
50927
50885
  "set": 3
50928
50886
  },
50929
50887
  "metadata": {
50930
- "purpose": "Get one ConfigurationItemNote by id.",
50888
+ "purpose": "Get one ConfigurationItemDnsRecord by id.",
50931
50889
  "usage": "item: null on the 200 body maps to NotFoundError (vendor not-found signal). Parent-scoped: parentId + id.",
50932
- "preferredWhen": "Preferred when the numeric id is already known; configuration_item_notes.resolve is for a field value.",
50890
+ "preferredWhen": "Preferred when the numeric id is already known; configuration_item_dns_records.resolve is for a field value.",
50933
50891
  "related": [
50934
- "configuration_item_notes.resolve"
50892
+ "configuration_item_dns_records.resolve"
50935
50893
  ],
50936
- "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_notes.query with includeFields.",
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.",
50937
50895
  "untrustedFields": [
50938
- "description",
50939
- "title"
50896
+ "data",
50897
+ "dnsType"
50940
50898
  ]
50941
50899
  },
50942
50900
  "compact": null,
50943
50901
  "status": "tested"
50944
50902
  },
50945
50903
  {
50946
- "id": "configuration_item_notes.getEntityInfo",
50947
- "resource": "configuration_item_notes",
50904
+ "id": "configuration_item_dns_records.getEntityInfo",
50905
+ "resource": "configuration_item_dns_records",
50948
50906
  "udfCapable": false,
50949
50907
  "operation": "getEntityInfo",
50950
50908
  "kind": "primitive",
50951
- "endpoint": "GET /V1.0/ConfigurationItemNotes/entityInformation",
50909
+ "endpoint": "GET /V1.0/ConfigurationItemDnsRecords/entityInformation",
50952
50910
  "effect": "read",
50953
50911
  "flags": [],
50954
50912
  "dryRun": false,
@@ -50960,7 +50918,7 @@ const CAPABILITY_DATA = {
50960
50918
  "drops": []
50961
50919
  },
50962
50920
  "examples": [
50963
- "await client.configurationItemNotes.getEntityInfo()"
50921
+ "await client.configurationItemDnsRecords.getEntityInfo()"
50964
50922
  ],
50965
50923
  "permissions": "unknown",
50966
50924
  "pagination": {
@@ -50974,27 +50932,27 @@ const CAPABILITY_DATA = {
50974
50932
  "set": 0
50975
50933
  },
50976
50934
  "metadata": {
50977
- "purpose": "Get the ConfigurationItemNote capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
50935
+ "purpose": "Get the ConfigurationItemDnsRecord capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
50978
50936
  "usage": "Unwraps info{}; drives client-side capability checks.",
50979
50937
  "preferredWhen": null,
50980
50938
  "related": [
50981
- "configuration_item_notes.getFieldInfo"
50939
+ "configuration_item_dns_records.getFieldInfo"
50982
50940
  ],
50983
50941
  "untrustedFields": [
50984
- "description",
50985
- "title"
50942
+ "data",
50943
+ "dnsType"
50986
50944
  ]
50987
50945
  },
50988
50946
  "compact": null,
50989
50947
  "status": "tested"
50990
50948
  },
50991
50949
  {
50992
- "id": "configuration_item_notes.getFieldInfo",
50993
- "resource": "configuration_item_notes",
50950
+ "id": "configuration_item_dns_records.getFieldInfo",
50951
+ "resource": "configuration_item_dns_records",
50994
50952
  "udfCapable": false,
50995
50953
  "operation": "getFieldInfo",
50996
50954
  "kind": "primitive",
50997
- "endpoint": "GET /V1.0/ConfigurationItemNotes/entityInformation/fields",
50955
+ "endpoint": "GET /V1.0/ConfigurationItemDnsRecords/entityInformation/fields",
50998
50956
  "effect": "read",
50999
50957
  "flags": [],
51000
50958
  "dryRun": false,
@@ -51006,7 +50964,7 @@ const CAPABILITY_DATA = {
51006
50964
  "drops": []
51007
50965
  },
51008
50966
  "examples": [
51009
- "await client.configurationItemNotes.getFieldInfo()"
50967
+ "await client.configurationItemDnsRecords.getFieldInfo()"
51010
50968
  ],
51011
50969
  "permissions": "unknown",
51012
50970
  "pagination": {
@@ -51020,28 +50978,28 @@ const CAPABILITY_DATA = {
51020
50978
  "set": 0
51021
50979
  },
51022
50980
  "metadata": {
51023
- "purpose": "Get the ConfigurationItemNote field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
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).",
51024
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.",
51025
50983
  "preferredWhen": null,
51026
50984
  "related": [
51027
- "configuration_item_notes.getEntityInfo",
51028
- "configuration_item_notes.getUdfInfo"
50985
+ "configuration_item_dns_records.getEntityInfo",
50986
+ "configuration_item_dns_records.getUdfInfo"
51029
50987
  ],
51030
50988
  "untrustedFields": [
51031
- "description",
51032
- "title"
50989
+ "data",
50990
+ "dnsType"
51033
50991
  ]
51034
50992
  },
51035
50993
  "compact": null,
51036
50994
  "status": "tested"
51037
50995
  },
51038
50996
  {
51039
- "id": "configuration_item_notes.getUdfInfo",
51040
- "resource": "configuration_item_notes",
50997
+ "id": "configuration_item_dns_records.getUdfInfo",
50998
+ "resource": "configuration_item_dns_records",
51041
50999
  "udfCapable": false,
51042
51000
  "operation": "getUdfInfo",
51043
51001
  "kind": "primitive",
51044
- "endpoint": "GET /V1.0/ConfigurationItemNotes/entityInformation/userDefinedFields",
51002
+ "endpoint": "GET /V1.0/ConfigurationItemDnsRecords/entityInformation/userDefinedFields",
51045
51003
  "effect": "read",
51046
51004
  "flags": [],
51047
51005
  "dryRun": false,
@@ -51053,7 +51011,7 @@ const CAPABILITY_DATA = {
51053
51011
  "drops": []
51054
51012
  },
51055
51013
  "examples": [
51056
- "await client.configurationItemNotes.getUdfInfo()"
51014
+ "await client.configurationItemDnsRecords.getUdfInfo()"
51057
51015
  ],
51058
51016
  "permissions": "unknown",
51059
51017
  "pagination": {
@@ -51067,27 +51025,27 @@ const CAPABILITY_DATA = {
51067
51025
  "set": 0
51068
51026
  },
51069
51027
  "metadata": {
51070
- "purpose": "Get the ConfigurationItemNote user-defined-field catalog.",
51028
+ "purpose": "Get the ConfigurationItemDnsRecord user-defined-field catalog.",
51071
51029
  "usage": "Unwraps fields[]; only meaningful where the entity is UDF-capable. (entity is not UDF-capable; catalog is expected empty).",
51072
51030
  "preferredWhen": null,
51073
51031
  "related": [
51074
- "configuration_item_notes.getFieldInfo"
51032
+ "configuration_item_dns_records.getFieldInfo"
51075
51033
  ],
51076
51034
  "untrustedFields": [
51077
- "description",
51078
- "title"
51035
+ "data",
51036
+ "dnsType"
51079
51037
  ]
51080
51038
  },
51081
51039
  "compact": null,
51082
51040
  "status": "tested"
51083
51041
  },
51084
51042
  {
51085
- "id": "configuration_item_notes.query",
51086
- "resource": "configuration_item_notes",
51043
+ "id": "configuration_item_dns_records.query",
51044
+ "resource": "configuration_item_dns_records",
51087
51045
  "udfCapable": false,
51088
51046
  "operation": "query",
51089
51047
  "kind": "primitive",
51090
- "endpoint": "GET|POST /V1.0/ConfigurationItemNotes/query",
51048
+ "endpoint": "GET|POST /V1.0/ConfigurationItemDnsRecords/query",
51091
51049
  "effect": "read",
51092
51050
  "flags": [],
51093
51051
  "dryRun": false,
@@ -51159,7 +51117,7 @@ const CAPABILITY_DATA = {
51159
51117
  "drops": []
51160
51118
  },
51161
51119
  "examples": [
51162
- "await client.configurationItemNotes.query({ filter: [{ field: 'name', op: 'eq', value: 'example' }], limit: 500 })"
51120
+ "await invoke(client, 'configuration_item_dns_records.query', [{ filter: [{ field: 'installedProductID', op: 'eq', value: 7 }], limit: 500 }])"
51163
51121
  ],
51164
51122
  "permissions": "unknown",
51165
51123
  "pagination": {
@@ -51180,24 +51138,24 @@ const CAPABILITY_DATA = {
51180
51138
  "set": 4
51181
51139
  },
51182
51140
  "metadata": {
51183
- "purpose": "Query ConfigurationItemNote records with a JSON filter.",
51184
- "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.",
51141
+ "purpose": "Query ConfigurationItemDnsRecord records with a JSON filter.",
51142
+ "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 installedProductID 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.",
51185
51143
  "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).",
51186
51144
  "related": [
51187
- "configuration_item_notes.resolve"
51145
+ "configuration_item_dns_records.resolve"
51188
51146
  ],
51189
51147
  "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.",
51190
51148
  "untrustedFields": [
51191
- "description",
51192
- "title"
51149
+ "data",
51150
+ "dnsType"
51193
51151
  ]
51194
51152
  },
51195
51153
  "compact": null,
51196
51154
  "status": "tested"
51197
51155
  },
51198
51156
  {
51199
- "id": "configuration_item_notes.resolve",
51200
- "resource": "configuration_item_notes",
51157
+ "id": "configuration_item_dns_records.resolve",
51158
+ "resource": "configuration_item_dns_records",
51201
51159
  "udfCapable": false,
51202
51160
  "operation": "resolve",
51203
51161
  "kind": "helper",
@@ -51227,11 +51185,11 @@ const CAPABILITY_DATA = {
51227
51185
  },
51228
51186
  "inputSchemaStrict": true,
51229
51187
  "outputSchema": {
51230
- "type": "ConfigurationItemNoteSummary",
51188
+ "type": "ConfigurationItemDnsRecordSummary",
51231
51189
  "drops": []
51232
51190
  },
51233
51191
  "examples": [
51234
- "await client.configurationItemNotes.resolve('example-value')"
51192
+ "await client.configurationItemDnsRecords.resolve('example-value')"
51235
51193
  ],
51236
51194
  "permissions": "unknown",
51237
51195
  "pagination": {
@@ -51249,91 +51207,27 @@ const CAPABILITY_DATA = {
51249
51207
  "set": 5
51250
51208
  },
51251
51209
  "metadata": {
51252
- "purpose": "Resolve a configuration item note from a numeric id (the direct fetch) only — this resource has no searchable text field, so a non-numeric identifier throws a config error.",
51210
+ "purpose": "Resolve a configuration item DNS record from a numeric id (the direct fetch) only — this resource has no searchable text field, so a non-numeric identifier throws a config error.",
51253
51211
  "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.",
51254
51212
  "preferredWhen": null,
51255
51213
  "related": [
51256
- "configuration_item_notes.get"
51214
+ "configuration_item_dns_records.get"
51257
51215
  ],
51258
51216
  "untrustedFields": [
51259
- "description",
51260
- "title"
51217
+ "data",
51218
+ "dnsType"
51261
51219
  ]
51262
51220
  },
51263
- "compact": "ConfigurationItemNoteSummary",
51221
+ "compact": "ConfigurationItemDnsRecordSummary",
51264
51222
  "status": "tested"
51265
51223
  },
51266
51224
  {
51267
- "id": "configuration_item_notes.update",
51225
+ "id": "configuration_item_notes.count",
51268
51226
  "resource": "configuration_item_notes",
51269
51227
  "udfCapable": false,
51270
- "operation": "update",
51271
- "kind": "primitive",
51272
- "endpoint": "PUT|PATCH /V1.0/ConfigurationItems/{parentId}/Notes",
51273
- "effect": "write",
51274
- "flags": [
51275
- "idempotent"
51276
- ],
51277
- "dryRun": true,
51278
- "envelope": "OperationResultModel",
51279
- "inputSchema": {
51280
- "parentId": {
51281
- "type": "string | number",
51282
- "required": true,
51283
- "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
51284
- },
51285
- "id": {
51286
- "type": "string | number",
51287
- "required": true,
51288
- "description": "The record id (number, or a canonical integer string — ids beyond 2^53 are supported via the string form)."
51289
- },
51290
- "data": {
51291
- "type": "object",
51292
- "required": true,
51293
- "description": "The record payload (vendor model fields)."
51294
- }
51295
- },
51296
- "inputSchemaStrict": true,
51297
- "outputSchema": {
51298
- "type": "OperationResultModel",
51299
- "drops": []
51300
- },
51301
- "examples": [
51302
- "await client.configurationItemNotes.update('example-value', 'example-value', { name: 'example' }, { dryRun: true })"
51303
- ],
51304
- "permissions": "unknown",
51305
- "pagination": {
51306
- "mode": "none"
51307
- },
51308
- "resolution": null,
51309
- "retry": {
51310
- "preset": "retry-85897a3a"
51311
- },
51312
- "errors": {
51313
- "set": 1
51314
- },
51315
- "metadata": {
51316
- "purpose": "Update a configuration item note.",
51317
- "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.",
51318
- "preferredWhen": "Preferred over create or delete when the record exists and only some fields change.",
51319
- "related": [
51320
- "configuration_item_notes.get"
51321
- ],
51322
- "untrustedFields": [
51323
- "description",
51324
- "title"
51325
- ]
51326
- },
51327
- "compact": null,
51328
- "status": "tested"
51329
- },
51330
- {
51331
- "id": "configuration_item_related_items.count",
51332
- "resource": "configuration_item_related_items",
51333
- "udfCapable": false,
51334
51228
  "operation": "count",
51335
51229
  "kind": "primitive",
51336
- "endpoint": "GET|POST /V1.0/ConfigurationItemRelatedItems/query/count",
51230
+ "endpoint": "GET|POST /V1.0/ConfigurationItemNotes/query/count",
51337
51231
  "effect": "read",
51338
51232
  "flags": [],
51339
51233
  "dryRun": false,
@@ -51363,7 +51257,7 @@ const CAPABILITY_DATA = {
51363
51257
  "drops": []
51364
51258
  },
51365
51259
  "examples": [
51366
- "await client.configurationItemRelatedItems.count({ filter: [{ field: 'name', op: 'eq', value: 'example' }] })"
51260
+ "await client.configurationItemNotes.count({ filter: [{ field: 'name', op: 'eq', value: 'example' }] })"
51367
51261
  ],
51368
51262
  "permissions": "unknown",
51369
51263
  "pagination": {
@@ -51377,24 +51271,28 @@ const CAPABILITY_DATA = {
51377
51271
  "set": 0
51378
51272
  },
51379
51273
  "metadata": {
51380
- "purpose": "Count configuration item related item records matching a JSON filter.",
51274
+ "purpose": "Count configuration item note records matching a JSON filter.",
51381
51275
  "usage": "Unwraps queryCount; returns a plain number.",
51382
51276
  "preferredWhen": null,
51383
51277
  "related": [
51384
- "configuration_item_related_items.query"
51278
+ "configuration_item_notes.query"
51385
51279
  ],
51386
- "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."
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
+ "description",
51283
+ "title"
51284
+ ]
51387
51285
  },
51388
51286
  "compact": null,
51389
51287
  "status": "tested"
51390
51288
  },
51391
51289
  {
51392
- "id": "configuration_item_related_items.create",
51393
- "resource": "configuration_item_related_items",
51290
+ "id": "configuration_item_notes.create",
51291
+ "resource": "configuration_item_notes",
51394
51292
  "udfCapable": false,
51395
51293
  "operation": "create",
51396
51294
  "kind": "primitive",
51397
- "endpoint": "POST /V1.0/ConfigurationItems/{parentId}/RelatedItems",
51295
+ "endpoint": "POST /V1.0/ConfigurationItems/{parentId}/Notes",
51398
51296
  "effect": "write",
51399
51297
  "flags": [],
51400
51298
  "dryRun": true,
@@ -51417,7 +51315,7 @@ const CAPABILITY_DATA = {
51417
51315
  "drops": []
51418
51316
  },
51419
51317
  "examples": [
51420
- "await client.configurationItemRelatedItems.create('example-value', { name: 'example' }, { dryRun: true })"
51318
+ "await client.configurationItemNotes.create('example-value', { name: 'example' }, { dryRun: true })"
51421
51319
  ],
51422
51320
  "permissions": "unknown",
51423
51321
  "pagination": {
@@ -51431,83 +51329,36 @@ const CAPABILITY_DATA = {
51431
51329
  "set": 1
51432
51330
  },
51433
51331
  "metadata": {
51434
- "purpose": "Create a configuration item related item.",
51332
+ "purpose": "Create a configuration item note.",
51435
51333
  "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.",
51436
51334
  "preferredWhen": "Only for a record that does not exist yet; prefer update for an id you already have.",
51437
51335
  "related": [
51438
- "configuration_item_related_items.update"
51439
- ]
51440
- },
51441
- "compact": null,
51442
- "status": "tested"
51443
- },
51444
- {
51445
- "id": "configuration_item_related_items.delete",
51446
- "resource": "configuration_item_related_items",
51447
- "udfCapable": false,
51448
- "operation": "delete",
51449
- "kind": "primitive",
51450
- "endpoint": "DELETE /V1.0/ConfigurationItems/{parentId}/RelatedItems/{id}",
51451
- "effect": "destructive",
51452
- "flags": [
51453
- "idempotent",
51454
- "requiresApproval"
51455
- ],
51456
- "dryRun": true,
51457
- "envelope": "OperationResultModel",
51458
- "inputSchema": {
51459
- "parentId": {
51460
- "type": "string | number",
51461
- "required": true,
51462
- "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
51336
+ "configuration_item_notes.update"
51337
+ ],
51338
+ "deleteBoundary": {
51339
+ "resource": "configuration_item_notes",
51340
+ "note": "the vendor defines no DELETE for configuration_item_notes (spec-derived: the vendored api-docs.json defines no DELETE on the entity's paths) — a create cannot be undone through the API; cleanup is UI-only.",
51341
+ "proof": "spec-derived"
51463
51342
  },
51464
- "id": {
51465
- "type": "string | number",
51466
- "required": true,
51467
- "description": "The record id (number, or a canonical integer string — ids beyond 2^53 are supported via the string form)."
51468
- }
51469
- },
51470
- "inputSchemaStrict": true,
51471
- "outputSchema": {
51472
- "type": "OperationResultModel",
51473
- "drops": []
51474
- },
51475
- "examples": [
51476
- "await invoke(client, 'configuration_item_related_items.delete', ['example-value', 'example-value'], { dryRun: false, confirm: 'configuration_item_related_items.delete' })"
51477
- ],
51478
- "permissions": "unknown",
51479
- "pagination": {
51480
- "mode": "none"
51481
- },
51482
- "resolution": null,
51483
- "retry": {
51484
- "preset": "retry-1849870d"
51485
- },
51486
- "errors": {
51487
- "set": 2
51488
- },
51489
- "metadata": {
51490
- "purpose": "Delete a configuration item related item.",
51491
- "usage": "Irreversible; dry-run validates the target id first. Parent-scoped: parentId + id.",
51492
- "preferredWhen": null,
51493
- "related": [
51494
- "configuration_item_related_items.get"
51343
+ "untrustedFields": [
51344
+ "description",
51345
+ "title"
51495
51346
  ]
51496
51347
  },
51497
51348
  "compact": null,
51498
51349
  "status": "tested"
51499
51350
  },
51500
51351
  {
51501
- "id": "configuration_item_related_items.get",
51502
- "resource": "configuration_item_related_items",
51352
+ "id": "configuration_item_notes.get",
51353
+ "resource": "configuration_item_notes",
51503
51354
  "udfCapable": false,
51504
51355
  "operation": "get",
51505
51356
  "kind": "primitive",
51506
- "endpoint": "GET /V1.0/ConfigurationItems/{parentId}/RelatedItems/{id}",
51357
+ "endpoint": "GET /V1.0/ConfigurationItems/{parentId}/Notes/{id}",
51507
51358
  "effect": "read",
51508
51359
  "flags": [],
51509
51360
  "dryRun": false,
51510
- "envelope": "ItemQueryResultModel[ConfigurationItemRelatedItemModel,InstalledProductRelatedItem]",
51361
+ "envelope": "ItemQueryResultModel[ConfigurationItemNoteModel,InstalledProductNote]",
51511
51362
  "inputSchema": {
51512
51363
  "parentId": {
51513
51364
  "type": "string | number",
@@ -51534,11 +51385,11 @@ const CAPABILITY_DATA = {
51534
51385
  },
51535
51386
  "inputSchemaStrict": true,
51536
51387
  "outputSchema": {
51537
- "type": "ItemQueryResultModel[ConfigurationItemRelatedItemModel,InstalledProductRelatedItem]",
51388
+ "type": "ItemQueryResultModel[ConfigurationItemNoteModel,InstalledProductNote]",
51538
51389
  "drops": []
51539
51390
  },
51540
51391
  "examples": [
51541
- "await client.configurationItemRelatedItems.get('example-value', 'example-value')"
51392
+ "await client.configurationItemNotes.get('example-value', 'example-value')"
51542
51393
  ],
51543
51394
  "permissions": "unknown",
51544
51395
  "pagination": {
@@ -51552,24 +51403,28 @@ const CAPABILITY_DATA = {
51552
51403
  "set": 3
51553
51404
  },
51554
51405
  "metadata": {
51555
- "purpose": "Get one ConfigurationItemRelatedItem by id.",
51406
+ "purpose": "Get one ConfigurationItemNote by id.",
51556
51407
  "usage": "item: null on the 200 body maps to NotFoundError (vendor not-found signal). Parent-scoped: parentId + id.",
51557
- "preferredWhen": "Preferred when the numeric id is already known; configuration_item_related_items.resolve is for a field value.",
51408
+ "preferredWhen": "Preferred when the numeric id is already known; configuration_item_notes.resolve is for a field value.",
51558
51409
  "related": [
51559
- "configuration_item_related_items.resolve"
51410
+ "configuration_item_notes.resolve"
51560
51411
  ],
51561
- "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_related_items.query with includeFields."
51412
+ "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_notes.query with includeFields.",
51413
+ "untrustedFields": [
51414
+ "description",
51415
+ "title"
51416
+ ]
51562
51417
  },
51563
51418
  "compact": null,
51564
51419
  "status": "tested"
51565
51420
  },
51566
51421
  {
51567
- "id": "configuration_item_related_items.getEntityInfo",
51568
- "resource": "configuration_item_related_items",
51422
+ "id": "configuration_item_notes.getEntityInfo",
51423
+ "resource": "configuration_item_notes",
51569
51424
  "udfCapable": false,
51570
51425
  "operation": "getEntityInfo",
51571
51426
  "kind": "primitive",
51572
- "endpoint": "GET /V1.0/ConfigurationItemRelatedItems/entityInformation",
51427
+ "endpoint": "GET /V1.0/ConfigurationItemNotes/entityInformation",
51573
51428
  "effect": "read",
51574
51429
  "flags": [],
51575
51430
  "dryRun": false,
@@ -51581,7 +51436,7 @@ const CAPABILITY_DATA = {
51581
51436
  "drops": []
51582
51437
  },
51583
51438
  "examples": [
51584
- "await client.configurationItemRelatedItems.getEntityInfo()"
51439
+ "await client.configurationItemNotes.getEntityInfo()"
51585
51440
  ],
51586
51441
  "permissions": "unknown",
51587
51442
  "pagination": {
@@ -51595,23 +51450,27 @@ const CAPABILITY_DATA = {
51595
51450
  "set": 0
51596
51451
  },
51597
51452
  "metadata": {
51598
- "purpose": "Get the ConfigurationItemRelatedItem capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
51453
+ "purpose": "Get the ConfigurationItemNote capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
51599
51454
  "usage": "Unwraps info{}; drives client-side capability checks.",
51600
51455
  "preferredWhen": null,
51601
51456
  "related": [
51602
- "configuration_item_related_items.getFieldInfo"
51457
+ "configuration_item_notes.getFieldInfo"
51458
+ ],
51459
+ "untrustedFields": [
51460
+ "description",
51461
+ "title"
51603
51462
  ]
51604
51463
  },
51605
51464
  "compact": null,
51606
51465
  "status": "tested"
51607
51466
  },
51608
51467
  {
51609
- "id": "configuration_item_related_items.getFieldInfo",
51610
- "resource": "configuration_item_related_items",
51468
+ "id": "configuration_item_notes.getFieldInfo",
51469
+ "resource": "configuration_item_notes",
51611
51470
  "udfCapable": false,
51612
51471
  "operation": "getFieldInfo",
51613
51472
  "kind": "primitive",
51614
- "endpoint": "GET /V1.0/ConfigurationItemRelatedItems/entityInformation/fields",
51473
+ "endpoint": "GET /V1.0/ConfigurationItemNotes/entityInformation/fields",
51615
51474
  "effect": "read",
51616
51475
  "flags": [],
51617
51476
  "dryRun": false,
@@ -51623,7 +51482,7 @@ const CAPABILITY_DATA = {
51623
51482
  "drops": []
51624
51483
  },
51625
51484
  "examples": [
51626
- "await client.configurationItemRelatedItems.getFieldInfo()"
51485
+ "await client.configurationItemNotes.getFieldInfo()"
51627
51486
  ],
51628
51487
  "permissions": "unknown",
51629
51488
  "pagination": {
@@ -51637,24 +51496,28 @@ const CAPABILITY_DATA = {
51637
51496
  "set": 0
51638
51497
  },
51639
51498
  "metadata": {
51640
- "purpose": "Get the ConfigurationItemRelatedItem field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
51499
+ "purpose": "Get the ConfigurationItemNote field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
51641
51500
  "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.",
51642
51501
  "preferredWhen": null,
51643
51502
  "related": [
51644
- "configuration_item_related_items.getEntityInfo",
51645
- "configuration_item_related_items.getUdfInfo"
51503
+ "configuration_item_notes.getEntityInfo",
51504
+ "configuration_item_notes.getUdfInfo"
51505
+ ],
51506
+ "untrustedFields": [
51507
+ "description",
51508
+ "title"
51646
51509
  ]
51647
51510
  },
51648
51511
  "compact": null,
51649
51512
  "status": "tested"
51650
51513
  },
51651
51514
  {
51652
- "id": "configuration_item_related_items.getUdfInfo",
51653
- "resource": "configuration_item_related_items",
51515
+ "id": "configuration_item_notes.getUdfInfo",
51516
+ "resource": "configuration_item_notes",
51654
51517
  "udfCapable": false,
51655
51518
  "operation": "getUdfInfo",
51656
51519
  "kind": "primitive",
51657
- "endpoint": "GET /V1.0/ConfigurationItemRelatedItems/entityInformation/userDefinedFields",
51520
+ "endpoint": "GET /V1.0/ConfigurationItemNotes/entityInformation/userDefinedFields",
51658
51521
  "effect": "read",
51659
51522
  "flags": [],
51660
51523
  "dryRun": false,
@@ -51666,7 +51529,7 @@ const CAPABILITY_DATA = {
51666
51529
  "drops": []
51667
51530
  },
51668
51531
  "examples": [
51669
- "await client.configurationItemRelatedItems.getUdfInfo()"
51532
+ "await client.configurationItemNotes.getUdfInfo()"
51670
51533
  ],
51671
51534
  "permissions": "unknown",
51672
51535
  "pagination": {
@@ -51680,23 +51543,27 @@ const CAPABILITY_DATA = {
51680
51543
  "set": 0
51681
51544
  },
51682
51545
  "metadata": {
51683
- "purpose": "Get the ConfigurationItemRelatedItem user-defined-field catalog.",
51546
+ "purpose": "Get the ConfigurationItemNote user-defined-field catalog.",
51684
51547
  "usage": "Unwraps fields[]; only meaningful where the entity is UDF-capable. (entity is not UDF-capable; catalog is expected empty).",
51685
51548
  "preferredWhen": null,
51686
51549
  "related": [
51687
- "configuration_item_related_items.getFieldInfo"
51550
+ "configuration_item_notes.getFieldInfo"
51551
+ ],
51552
+ "untrustedFields": [
51553
+ "description",
51554
+ "title"
51688
51555
  ]
51689
51556
  },
51690
51557
  "compact": null,
51691
51558
  "status": "tested"
51692
51559
  },
51693
51560
  {
51694
- "id": "configuration_item_related_items.query",
51695
- "resource": "configuration_item_related_items",
51561
+ "id": "configuration_item_notes.query",
51562
+ "resource": "configuration_item_notes",
51696
51563
  "udfCapable": false,
51697
51564
  "operation": "query",
51698
51565
  "kind": "primitive",
51699
- "endpoint": "GET|POST /V1.0/ConfigurationItemRelatedItems/query",
51566
+ "endpoint": "GET|POST /V1.0/ConfigurationItemNotes/query",
51700
51567
  "effect": "read",
51701
51568
  "flags": [],
51702
51569
  "dryRun": false,
@@ -51768,7 +51635,7 @@ const CAPABILITY_DATA = {
51768
51635
  "drops": []
51769
51636
  },
51770
51637
  "examples": [
51771
- "await client.configurationItemRelatedItems.query({ filter: [{ field: 'name', op: 'eq', value: 'example' }], limit: 500 })"
51638
+ "await client.configurationItemNotes.query({ filter: [{ field: 'name', op: 'eq', value: 'example' }], limit: 500 })"
51772
51639
  ],
51773
51640
  "permissions": "unknown",
51774
51641
  "pagination": {
@@ -51789,20 +51656,629 @@ const CAPABILITY_DATA = {
51789
51656
  "set": 4
51790
51657
  },
51791
51658
  "metadata": {
51792
- "purpose": "Query ConfigurationItemRelatedItem records with a JSON filter.",
51659
+ "purpose": "Query ConfigurationItemNote records with a JSON filter.",
51793
51660
  "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.",
51794
51661
  "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).",
51795
51662
  "related": [
51796
- "configuration_item_related_items.resolve"
51663
+ "configuration_item_notes.resolve"
51797
51664
  ],
51798
- "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."
51665
+ "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.",
51666
+ "untrustedFields": [
51667
+ "description",
51668
+ "title"
51669
+ ]
51799
51670
  },
51800
51671
  "compact": null,
51801
51672
  "status": "tested"
51802
51673
  },
51803
51674
  {
51804
- "id": "configuration_item_related_items.resolve",
51805
- "resource": "configuration_item_related_items",
51675
+ "id": "configuration_item_notes.resolve",
51676
+ "resource": "configuration_item_notes",
51677
+ "udfCapable": false,
51678
+ "operation": "resolve",
51679
+ "kind": "helper",
51680
+ "endpoint": null,
51681
+ "effect": "read",
51682
+ "flags": [],
51683
+ "dryRun": false,
51684
+ "envelope": null,
51685
+ "inputSchema": {
51686
+ "identifier": {
51687
+ "type": "string | number",
51688
+ "required": true,
51689
+ "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)."
51690
+ },
51691
+ "opts": {
51692
+ "type": "object",
51693
+ "required": false,
51694
+ "description": "ResolutionOpts — { expand?: boolean } (return the full record; a no-op where the Summary is a structural alias).",
51695
+ "properties": [
51696
+ {
51697
+ "name": "expand",
51698
+ "type": "boolean",
51699
+ "optional": true
51700
+ }
51701
+ ]
51702
+ }
51703
+ },
51704
+ "inputSchemaStrict": true,
51705
+ "outputSchema": {
51706
+ "type": "ConfigurationItemNoteSummary",
51707
+ "drops": []
51708
+ },
51709
+ "examples": [
51710
+ "await client.configurationItemNotes.resolve('example-value')"
51711
+ ],
51712
+ "permissions": "unknown",
51713
+ "pagination": {
51714
+ "mode": "none"
51715
+ },
51716
+ "resolution": {
51717
+ "basis": "server-filter",
51718
+ "maxScanRecords": 500,
51719
+ "maxScanPages": 4
51720
+ },
51721
+ "retry": {
51722
+ "preset": "retry-ffb3a9cb"
51723
+ },
51724
+ "errors": {
51725
+ "set": 5
51726
+ },
51727
+ "metadata": {
51728
+ "purpose": "Resolve a configuration item note from a numeric id (the direct fetch) only — this resource has no searchable text field, so a non-numeric identifier throws a config error.",
51729
+ "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.",
51730
+ "preferredWhen": null,
51731
+ "related": [
51732
+ "configuration_item_notes.get"
51733
+ ],
51734
+ "untrustedFields": [
51735
+ "description",
51736
+ "title"
51737
+ ]
51738
+ },
51739
+ "compact": "ConfigurationItemNoteSummary",
51740
+ "status": "tested"
51741
+ },
51742
+ {
51743
+ "id": "configuration_item_notes.update",
51744
+ "resource": "configuration_item_notes",
51745
+ "udfCapable": false,
51746
+ "operation": "update",
51747
+ "kind": "primitive",
51748
+ "endpoint": "PUT|PATCH /V1.0/ConfigurationItems/{parentId}/Notes",
51749
+ "effect": "write",
51750
+ "flags": [
51751
+ "idempotent"
51752
+ ],
51753
+ "dryRun": true,
51754
+ "envelope": "OperationResultModel",
51755
+ "inputSchema": {
51756
+ "parentId": {
51757
+ "type": "string | number",
51758
+ "required": true,
51759
+ "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
51760
+ },
51761
+ "id": {
51762
+ "type": "string | number",
51763
+ "required": true,
51764
+ "description": "The record id (number, or a canonical integer string — ids beyond 2^53 are supported via the string form)."
51765
+ },
51766
+ "data": {
51767
+ "type": "object",
51768
+ "required": true,
51769
+ "description": "The record payload (vendor model fields)."
51770
+ }
51771
+ },
51772
+ "inputSchemaStrict": true,
51773
+ "outputSchema": {
51774
+ "type": "OperationResultModel",
51775
+ "drops": []
51776
+ },
51777
+ "examples": [
51778
+ "await client.configurationItemNotes.update('example-value', 'example-value', { name: 'example' }, { dryRun: true })"
51779
+ ],
51780
+ "permissions": "unknown",
51781
+ "pagination": {
51782
+ "mode": "none"
51783
+ },
51784
+ "resolution": null,
51785
+ "retry": {
51786
+ "preset": "retry-85897a3a"
51787
+ },
51788
+ "errors": {
51789
+ "set": 1
51790
+ },
51791
+ "metadata": {
51792
+ "purpose": "Update a configuration item note.",
51793
+ "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.",
51794
+ "preferredWhen": "Preferred over create or delete when the record exists and only some fields change.",
51795
+ "related": [
51796
+ "configuration_item_notes.get"
51797
+ ],
51798
+ "untrustedFields": [
51799
+ "description",
51800
+ "title"
51801
+ ]
51802
+ },
51803
+ "compact": null,
51804
+ "status": "tested"
51805
+ },
51806
+ {
51807
+ "id": "configuration_item_related_items.count",
51808
+ "resource": "configuration_item_related_items",
51809
+ "udfCapable": false,
51810
+ "operation": "count",
51811
+ "kind": "primitive",
51812
+ "endpoint": "GET|POST /V1.0/ConfigurationItemRelatedItems/query/count",
51813
+ "effect": "read",
51814
+ "flags": [],
51815
+ "dryRun": false,
51816
+ "envelope": "QueryCountResultModel",
51817
+ "inputSchema": {
51818
+ "params": {
51819
+ "type": "object",
51820
+ "required": false,
51821
+ "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.",
51822
+ "properties": [
51823
+ {
51824
+ "name": "filter",
51825
+ "type": "FilterCondition[]",
51826
+ "optional": true
51827
+ },
51828
+ {
51829
+ "name": "fieldCheck",
51830
+ "type": "boolean",
51831
+ "optional": true
51832
+ }
51833
+ ]
51834
+ }
51835
+ },
51836
+ "inputSchemaStrict": true,
51837
+ "outputSchema": {
51838
+ "type": "QueryCountResultModel",
51839
+ "drops": []
51840
+ },
51841
+ "examples": [
51842
+ "await client.configurationItemRelatedItems.count({ filter: [{ field: 'name', op: 'eq', value: 'example' }] })"
51843
+ ],
51844
+ "permissions": "unknown",
51845
+ "pagination": {
51846
+ "mode": "none"
51847
+ },
51848
+ "resolution": null,
51849
+ "retry": {
51850
+ "preset": "retry-ffb3a9cb"
51851
+ },
51852
+ "errors": {
51853
+ "set": 0
51854
+ },
51855
+ "metadata": {
51856
+ "purpose": "Count configuration item related item records matching a JSON filter.",
51857
+ "usage": "Unwraps queryCount; returns a plain number.",
51858
+ "preferredWhen": null,
51859
+ "related": [
51860
+ "configuration_item_related_items.query"
51861
+ ],
51862
+ "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."
51863
+ },
51864
+ "compact": null,
51865
+ "status": "tested"
51866
+ },
51867
+ {
51868
+ "id": "configuration_item_related_items.create",
51869
+ "resource": "configuration_item_related_items",
51870
+ "udfCapable": false,
51871
+ "operation": "create",
51872
+ "kind": "primitive",
51873
+ "endpoint": "POST /V1.0/ConfigurationItems/{parentId}/RelatedItems",
51874
+ "effect": "write",
51875
+ "flags": [],
51876
+ "dryRun": true,
51877
+ "envelope": "OperationResultModel",
51878
+ "inputSchema": {
51879
+ "parentId": {
51880
+ "type": "string | number",
51881
+ "required": true,
51882
+ "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
51883
+ },
51884
+ "data": {
51885
+ "type": "object",
51886
+ "required": true,
51887
+ "description": "The record payload (vendor model fields)."
51888
+ }
51889
+ },
51890
+ "inputSchemaStrict": true,
51891
+ "outputSchema": {
51892
+ "type": "OperationResultModel",
51893
+ "drops": []
51894
+ },
51895
+ "examples": [
51896
+ "await client.configurationItemRelatedItems.create('example-value', { name: 'example' }, { dryRun: true })"
51897
+ ],
51898
+ "permissions": "unknown",
51899
+ "pagination": {
51900
+ "mode": "none"
51901
+ },
51902
+ "resolution": null,
51903
+ "retry": {
51904
+ "preset": "retry-c5657094"
51905
+ },
51906
+ "errors": {
51907
+ "set": 1
51908
+ },
51909
+ "metadata": {
51910
+ "purpose": "Create a configuration item related item.",
51911
+ "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.",
51912
+ "preferredWhen": "Only for a record that does not exist yet; prefer update for an id you already have.",
51913
+ "related": [
51914
+ "configuration_item_related_items.update"
51915
+ ]
51916
+ },
51917
+ "compact": null,
51918
+ "status": "tested"
51919
+ },
51920
+ {
51921
+ "id": "configuration_item_related_items.delete",
51922
+ "resource": "configuration_item_related_items",
51923
+ "udfCapable": false,
51924
+ "operation": "delete",
51925
+ "kind": "primitive",
51926
+ "endpoint": "DELETE /V1.0/ConfigurationItems/{parentId}/RelatedItems/{id}",
51927
+ "effect": "destructive",
51928
+ "flags": [
51929
+ "idempotent",
51930
+ "requiresApproval"
51931
+ ],
51932
+ "dryRun": true,
51933
+ "envelope": "OperationResultModel",
51934
+ "inputSchema": {
51935
+ "parentId": {
51936
+ "type": "string | number",
51937
+ "required": true,
51938
+ "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
51939
+ },
51940
+ "id": {
51941
+ "type": "string | number",
51942
+ "required": true,
51943
+ "description": "The record id (number, or a canonical integer string — ids beyond 2^53 are supported via the string form)."
51944
+ }
51945
+ },
51946
+ "inputSchemaStrict": true,
51947
+ "outputSchema": {
51948
+ "type": "OperationResultModel",
51949
+ "drops": []
51950
+ },
51951
+ "examples": [
51952
+ "await invoke(client, 'configuration_item_related_items.delete', ['example-value', 'example-value'], { dryRun: false, confirm: 'configuration_item_related_items.delete' })"
51953
+ ],
51954
+ "permissions": "unknown",
51955
+ "pagination": {
51956
+ "mode": "none"
51957
+ },
51958
+ "resolution": null,
51959
+ "retry": {
51960
+ "preset": "retry-1849870d"
51961
+ },
51962
+ "errors": {
51963
+ "set": 2
51964
+ },
51965
+ "metadata": {
51966
+ "purpose": "Delete a configuration item related item.",
51967
+ "usage": "Irreversible; dry-run validates the target id first. Parent-scoped: parentId + id.",
51968
+ "preferredWhen": null,
51969
+ "related": [
51970
+ "configuration_item_related_items.get"
51971
+ ]
51972
+ },
51973
+ "compact": null,
51974
+ "status": "tested"
51975
+ },
51976
+ {
51977
+ "id": "configuration_item_related_items.get",
51978
+ "resource": "configuration_item_related_items",
51979
+ "udfCapable": false,
51980
+ "operation": "get",
51981
+ "kind": "primitive",
51982
+ "endpoint": "GET /V1.0/ConfigurationItems/{parentId}/RelatedItems/{id}",
51983
+ "effect": "read",
51984
+ "flags": [],
51985
+ "dryRun": false,
51986
+ "envelope": "ItemQueryResultModel[ConfigurationItemRelatedItemModel,InstalledProductRelatedItem]",
51987
+ "inputSchema": {
51988
+ "parentId": {
51989
+ "type": "string | number",
51990
+ "required": true,
51991
+ "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
51992
+ },
51993
+ "id": {
51994
+ "type": "string | number",
51995
+ "required": true,
51996
+ "description": "The record id (number, or a canonical integer string — ids beyond 2^53 are supported via the string form)."
51997
+ },
51998
+ "opts": {
51999
+ "type": "object",
52000
+ "required": false,
52001
+ "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.",
52002
+ "properties": [
52003
+ {
52004
+ "name": "fresh",
52005
+ "type": "boolean",
52006
+ "optional": true
52007
+ }
52008
+ ]
52009
+ }
52010
+ },
52011
+ "inputSchemaStrict": true,
52012
+ "outputSchema": {
52013
+ "type": "ItemQueryResultModel[ConfigurationItemRelatedItemModel,InstalledProductRelatedItem]",
52014
+ "drops": []
52015
+ },
52016
+ "examples": [
52017
+ "await client.configurationItemRelatedItems.get('example-value', 'example-value')"
52018
+ ],
52019
+ "permissions": "unknown",
52020
+ "pagination": {
52021
+ "mode": "none"
52022
+ },
52023
+ "resolution": null,
52024
+ "retry": {
52025
+ "preset": "retry-ffb3a9cb"
52026
+ },
52027
+ "errors": {
52028
+ "set": 3
52029
+ },
52030
+ "metadata": {
52031
+ "purpose": "Get one ConfigurationItemRelatedItem by id.",
52032
+ "usage": "item: null on the 200 body maps to NotFoundError (vendor not-found signal). Parent-scoped: parentId + id.",
52033
+ "preferredWhen": "Preferred when the numeric id is already known; configuration_item_related_items.resolve is for a field value.",
52034
+ "related": [
52035
+ "configuration_item_related_items.resolve"
52036
+ ],
52037
+ "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_related_items.query with includeFields."
52038
+ },
52039
+ "compact": null,
52040
+ "status": "tested"
52041
+ },
52042
+ {
52043
+ "id": "configuration_item_related_items.getEntityInfo",
52044
+ "resource": "configuration_item_related_items",
52045
+ "udfCapable": false,
52046
+ "operation": "getEntityInfo",
52047
+ "kind": "primitive",
52048
+ "endpoint": "GET /V1.0/ConfigurationItemRelatedItems/entityInformation",
52049
+ "effect": "read",
52050
+ "flags": [],
52051
+ "dryRun": false,
52052
+ "envelope": "EntityInformationResultModel",
52053
+ "inputSchema": {},
52054
+ "inputSchemaStrict": true,
52055
+ "outputSchema": {
52056
+ "type": "EntityInformationResultModel",
52057
+ "drops": []
52058
+ },
52059
+ "examples": [
52060
+ "await client.configurationItemRelatedItems.getEntityInfo()"
52061
+ ],
52062
+ "permissions": "unknown",
52063
+ "pagination": {
52064
+ "mode": "none"
52065
+ },
52066
+ "resolution": null,
52067
+ "retry": {
52068
+ "preset": "retry-ffb3a9cb"
52069
+ },
52070
+ "errors": {
52071
+ "set": 0
52072
+ },
52073
+ "metadata": {
52074
+ "purpose": "Get the ConfigurationItemRelatedItem capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
52075
+ "usage": "Unwraps info{}; drives client-side capability checks.",
52076
+ "preferredWhen": null,
52077
+ "related": [
52078
+ "configuration_item_related_items.getFieldInfo"
52079
+ ]
52080
+ },
52081
+ "compact": null,
52082
+ "status": "tested"
52083
+ },
52084
+ {
52085
+ "id": "configuration_item_related_items.getFieldInfo",
52086
+ "resource": "configuration_item_related_items",
52087
+ "udfCapable": false,
52088
+ "operation": "getFieldInfo",
52089
+ "kind": "primitive",
52090
+ "endpoint": "GET /V1.0/ConfigurationItemRelatedItems/entityInformation/fields",
52091
+ "effect": "read",
52092
+ "flags": [],
52093
+ "dryRun": false,
52094
+ "envelope": "FieldInformationResultModel",
52095
+ "inputSchema": {},
52096
+ "inputSchemaStrict": true,
52097
+ "outputSchema": {
52098
+ "type": "FieldInformationResultModel",
52099
+ "drops": []
52100
+ },
52101
+ "examples": [
52102
+ "await client.configurationItemRelatedItems.getFieldInfo()"
52103
+ ],
52104
+ "permissions": "unknown",
52105
+ "pagination": {
52106
+ "mode": "none"
52107
+ },
52108
+ "resolution": null,
52109
+ "retry": {
52110
+ "preset": "retry-ffb3a9cb"
52111
+ },
52112
+ "errors": {
52113
+ "set": 0
52114
+ },
52115
+ "metadata": {
52116
+ "purpose": "Get the ConfigurationItemRelatedItem field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
52117
+ "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.",
52118
+ "preferredWhen": null,
52119
+ "related": [
52120
+ "configuration_item_related_items.getEntityInfo",
52121
+ "configuration_item_related_items.getUdfInfo"
52122
+ ]
52123
+ },
52124
+ "compact": null,
52125
+ "status": "tested"
52126
+ },
52127
+ {
52128
+ "id": "configuration_item_related_items.getUdfInfo",
52129
+ "resource": "configuration_item_related_items",
52130
+ "udfCapable": false,
52131
+ "operation": "getUdfInfo",
52132
+ "kind": "primitive",
52133
+ "endpoint": "GET /V1.0/ConfigurationItemRelatedItems/entityInformation/userDefinedFields",
52134
+ "effect": "read",
52135
+ "flags": [],
52136
+ "dryRun": false,
52137
+ "envelope": "UserDefinedFieldInformationResultModel",
52138
+ "inputSchema": {},
52139
+ "inputSchemaStrict": true,
52140
+ "outputSchema": {
52141
+ "type": "UserDefinedFieldInformationResultModel",
52142
+ "drops": []
52143
+ },
52144
+ "examples": [
52145
+ "await client.configurationItemRelatedItems.getUdfInfo()"
52146
+ ],
52147
+ "permissions": "unknown",
52148
+ "pagination": {
52149
+ "mode": "none"
52150
+ },
52151
+ "resolution": null,
52152
+ "retry": {
52153
+ "preset": "retry-ffb3a9cb"
52154
+ },
52155
+ "errors": {
52156
+ "set": 0
52157
+ },
52158
+ "metadata": {
52159
+ "purpose": "Get the ConfigurationItemRelatedItem user-defined-field catalog.",
52160
+ "usage": "Unwraps fields[]; only meaningful where the entity is UDF-capable. (entity is not UDF-capable; catalog is expected empty).",
52161
+ "preferredWhen": null,
52162
+ "related": [
52163
+ "configuration_item_related_items.getFieldInfo"
52164
+ ]
52165
+ },
52166
+ "compact": null,
52167
+ "status": "tested"
52168
+ },
52169
+ {
52170
+ "id": "configuration_item_related_items.query",
52171
+ "resource": "configuration_item_related_items",
52172
+ "udfCapable": false,
52173
+ "operation": "query",
52174
+ "kind": "primitive",
52175
+ "endpoint": "GET|POST /V1.0/ConfigurationItemRelatedItems/query",
52176
+ "effect": "read",
52177
+ "flags": [],
52178
+ "dryRun": false,
52179
+ "envelope": "QueryActionResult[<Model>,<Entity>]",
52180
+ "inputSchema": {
52181
+ "params": {
52182
+ "type": "object",
52183
+ "required": false,
52184
+ "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.",
52185
+ "properties": [
52186
+ {
52187
+ "name": "filter",
52188
+ "type": "FilterCondition[]",
52189
+ "optional": true
52190
+ },
52191
+ {
52192
+ "name": "limit",
52193
+ "type": "number",
52194
+ "optional": true,
52195
+ "default": 500
52196
+ },
52197
+ {
52198
+ "name": "latest",
52199
+ "type": "number",
52200
+ "optional": true
52201
+ },
52202
+ {
52203
+ "name": "noteChars",
52204
+ "type": "number",
52205
+ "optional": true
52206
+ },
52207
+ {
52208
+ "name": "includeFields",
52209
+ "type": "string[]",
52210
+ "optional": true
52211
+ },
52212
+ {
52213
+ "name": "fieldCheck",
52214
+ "type": "boolean",
52215
+ "optional": true,
52216
+ "default": true
52217
+ },
52218
+ {
52219
+ "name": "names",
52220
+ "type": "boolean",
52221
+ "optional": true
52222
+ },
52223
+ {
52224
+ "name": "via",
52225
+ "type": "\"post\" | \"get\"",
52226
+ "optional": true
52227
+ },
52228
+ {
52229
+ "name": "acknowledgeUnscoped",
52230
+ "type": "boolean",
52231
+ "optional": true
52232
+ },
52233
+ {
52234
+ "name": "walk",
52235
+ "type": "object",
52236
+ "optional": true
52237
+ }
52238
+ ]
52239
+ }
52240
+ },
52241
+ "inputSchemaStrict": true,
52242
+ "outputSchema": {
52243
+ "type": "QueryActionResult[<Model>,<Entity>]",
52244
+ "drops": []
52245
+ },
52246
+ "examples": [
52247
+ "await client.configurationItemRelatedItems.query({ filter: [{ field: 'name', op: 'eq', value: 'example' }], limit: 500 })"
52248
+ ],
52249
+ "permissions": "unknown",
52250
+ "pagination": {
52251
+ "mode": "cursor",
52252
+ "vendorDefault": 10,
52253
+ "vendorMax": 500,
52254
+ "pageGuard": 1000,
52255
+ "queryBounded": {
52256
+ "default": 500,
52257
+ "max": 2500
52258
+ }
52259
+ },
52260
+ "resolution": null,
52261
+ "retry": {
52262
+ "preset": "retry-ffb3a9cb"
52263
+ },
52264
+ "errors": {
52265
+ "set": 4
52266
+ },
52267
+ "metadata": {
52268
+ "purpose": "Query ConfigurationItemRelatedItem records with a JSON filter.",
52269
+ "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.",
52270
+ "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).",
52271
+ "related": [
52272
+ "configuration_item_related_items.resolve"
52273
+ ],
52274
+ "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."
52275
+ },
52276
+ "compact": null,
52277
+ "status": "tested"
52278
+ },
52279
+ {
52280
+ "id": "configuration_item_related_items.resolve",
52281
+ "resource": "configuration_item_related_items",
51806
52282
  "udfCapable": false,
51807
52283
  "operation": "resolve",
51808
52284
  "kind": "helper",
@@ -75409,6 +75885,482 @@ const CAPABILITY_DATA = {
75409
75885
  "compact": null,
75410
75886
  "status": "tested"
75411
75887
  },
75888
+ {
75889
+ "id": "task_note_attachments.count",
75890
+ "resource": "task_note_attachments",
75891
+ "udfCapable": false,
75892
+ "operation": "count",
75893
+ "kind": "primitive",
75894
+ "endpoint": "GET|POST /V1.0/TaskNoteAttachments/query/count",
75895
+ "effect": "read",
75896
+ "flags": [],
75897
+ "dryRun": false,
75898
+ "envelope": "QueryCountResultModel",
75899
+ "inputSchema": {
75900
+ "params": {
75901
+ "type": "object",
75902
+ "required": false,
75903
+ "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.",
75904
+ "properties": [
75905
+ {
75906
+ "name": "filter",
75907
+ "type": "FilterCondition[]",
75908
+ "optional": true
75909
+ },
75910
+ {
75911
+ "name": "fieldCheck",
75912
+ "type": "boolean",
75913
+ "optional": true
75914
+ }
75915
+ ]
75916
+ }
75917
+ },
75918
+ "inputSchemaStrict": true,
75919
+ "outputSchema": {
75920
+ "type": "QueryCountResultModel",
75921
+ "drops": []
75922
+ },
75923
+ "examples": [
75924
+ "await invoke(client, 'task_note_attachments.count', [{ filter: [{ field: 'taskNoteID', op: 'eq', value: 7 }] }])"
75925
+ ],
75926
+ "permissions": "unknown",
75927
+ "pagination": {
75928
+ "mode": "none"
75929
+ },
75930
+ "resolution": null,
75931
+ "retry": {
75932
+ "preset": "retry-ffb3a9cb"
75933
+ },
75934
+ "errors": {
75935
+ "set": 0
75936
+ },
75937
+ "metadata": {
75938
+ "purpose": "Count task note attachment records matching a JSON filter. Use taskNoteID for note scope.",
75939
+ "usage": "Unwraps queryCount; returns a plain number. Include an object-specific taskNoteID filter. taskID is the separate task association; taskNoteID identifies the note parent. Do not substitute the task id for the note id. 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.",
75940
+ "preferredWhen": null,
75941
+ "related": [
75942
+ "task_note_attachments.query"
75943
+ ],
75944
+ "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.",
75945
+ "untrustedFields": [
75946
+ "title"
75947
+ ]
75948
+ },
75949
+ "compact": null,
75950
+ "status": "tested"
75951
+ },
75952
+ {
75953
+ "id": "task_note_attachments.create",
75954
+ "resource": "task_note_attachments",
75955
+ "udfCapable": false,
75956
+ "operation": "create",
75957
+ "kind": "primitive",
75958
+ "endpoint": "POST /V1.0/TaskNotes/{parentId}/Attachments",
75959
+ "effect": "write",
75960
+ "flags": [],
75961
+ "dryRun": true,
75962
+ "envelope": "OperationResultModel",
75963
+ "inputSchema": {
75964
+ "parentId": {
75965
+ "type": "string | number",
75966
+ "required": true,
75967
+ "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
75968
+ },
75969
+ "data": {
75970
+ "type": "object",
75971
+ "required": true,
75972
+ "description": "The record payload (vendor model fields)."
75973
+ }
75974
+ },
75975
+ "inputSchemaStrict": true,
75976
+ "outputSchema": {
75977
+ "type": "OperationResultModel",
75978
+ "drops": []
75979
+ },
75980
+ "examples": [
75981
+ "const fields = await client.taskNoteAttachments.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.taskNoteAttachments.create(7, { attachmentType: 'FILE_ATTACHMENT', fullPath: 'note.txt', title: 'Supporting note', publish: Number(values[0].value), data: 'bm90ZQ==' }, { dryRun: true });"
75982
+ ],
75983
+ "permissions": "unknown",
75984
+ "pagination": {
75985
+ "mode": "none"
75986
+ },
75987
+ "resolution": null,
75988
+ "retry": {
75989
+ "preset": "retry-c5657094"
75990
+ },
75991
+ "errors": {
75992
+ "set": 1
75993
+ },
75994
+ "metadata": {
75995
+ "purpose": "Create a file attachment under a task note.",
75996
+ "usage": "Create a file under TaskNotes/{parentId}/Attachments; parentId is the task-note ID, not taskID. Required: explicit FILE_ATTACHMENT, title/fullPath (at most 255 characters), numeric publish from current metadata and base64 data. Existing attachments cannot be updated. taskID/taskNoteID and audit fields are response associations, not writable links. Vendor file/type limits and permissions apply: individual file limit 6–7 MB, 10,000,000 bytes per five minutes and a five-minute creation pause when exceeded. Contact impersonation requires security permission, publish label ALL, an active contact/account, and a note created by that contact. Resource impersonation uses the configured header. Exact-parent deduplication is unproven; createIfNotExists is unsupported. No live create is claimed.",
75997
+ "preferredWhen": "Add a new attachment; existing attachments cannot be updated. Replace through separately governed delete and create actions.",
75998
+ "related": [
75999
+ "task_note_attachments.get"
76000
+ ],
76001
+ "argNotes": {
76002
+ "data": "File uploads only. Optional attachedByContactID is the documented contact impersonation input; the vendor checks authorship of the task note, active contact/account, publish ALL and security permission. Read-only taskID/taskNoteID, audit/creator fields, contentType and fileSize are not create inputs. No parentAttachmentID on this model; nested attachments use the parent entity URL and do not retain note visibility. Other attachment types and UDF writes are unsupported."
76003
+ },
76004
+ "untrustedFields": [
76005
+ "title"
76006
+ ],
76007
+ "createRequirements": {
76008
+ "requires": {
76009
+ "allOf": [
76010
+ "attachmentType",
76011
+ "fullPath",
76012
+ "title",
76013
+ "publish",
76014
+ "data"
76015
+ ]
76016
+ },
76017
+ "requiresByValue": [
76018
+ {
76019
+ "field": "attachmentType",
76020
+ "value": "FILE_ATTACHMENT",
76021
+ "requires": {
76022
+ "allOf": [
76023
+ "data"
76024
+ ]
76025
+ }
76026
+ }
76027
+ ]
76028
+ }
76029
+ },
76030
+ "compact": null,
76031
+ "status": "tested"
76032
+ },
76033
+ {
76034
+ "id": "task_note_attachments.delete",
76035
+ "resource": "task_note_attachments",
76036
+ "udfCapable": false,
76037
+ "operation": "delete",
76038
+ "kind": "primitive",
76039
+ "endpoint": "DELETE /V1.0/TaskNotes/{parentId}/Attachments/{id}",
76040
+ "effect": "destructive",
76041
+ "flags": [
76042
+ "idempotent",
76043
+ "requiresApproval"
76044
+ ],
76045
+ "dryRun": true,
76046
+ "envelope": "OperationResultModel (attachment entities: the deleted attachment model is returned, not OperationResultModel)",
76047
+ "inputSchema": {
76048
+ "parentId": {
76049
+ "type": "string | number",
76050
+ "required": true,
76051
+ "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
76052
+ },
76053
+ "id": {
76054
+ "type": "string | number",
76055
+ "required": true,
76056
+ "description": "The record id (number, or a canonical integer string — ids beyond 2^53 are supported via the string form)."
76057
+ }
76058
+ },
76059
+ "inputSchemaStrict": true,
76060
+ "outputSchema": {
76061
+ "type": "OperationResultModel (attachment entities: the deleted attachment model is returned, not OperationResultModel)",
76062
+ "drops": []
76063
+ },
76064
+ "examples": [
76065
+ "await invoke(client, 'task_note_attachments.delete', [7, 3], { confirm: 'task_note_attachments.delete' })"
76066
+ ],
76067
+ "permissions": "unknown",
76068
+ "pagination": {
76069
+ "mode": "none"
76070
+ },
76071
+ "resolution": null,
76072
+ "retry": {
76073
+ "preset": "retry-1849870d"
76074
+ },
76075
+ "errors": {
76076
+ "set": 2
76077
+ },
76078
+ "metadata": {
76079
+ "purpose": "Delete an attachment under a task note.",
76080
+ "usage": "Irreversible; dry-run validates the target id first. Parent-scoped: parentId + id.",
76081
+ "preferredWhen": null,
76082
+ "related": [
76083
+ "task_note_attachments.get"
76084
+ ],
76085
+ "untrustedFields": [
76086
+ "title"
76087
+ ]
76088
+ },
76089
+ "compact": null,
76090
+ "status": "tested"
76091
+ },
76092
+ {
76093
+ "id": "task_note_attachments.get",
76094
+ "resource": "task_note_attachments",
76095
+ "udfCapable": false,
76096
+ "operation": "get",
76097
+ "kind": "primitive",
76098
+ "endpoint": "GET /V1.0/TaskNotes/{parentId}/Attachments/{id}",
76099
+ "effect": "read",
76100
+ "flags": [],
76101
+ "dryRun": false,
76102
+ "envelope": "TaskNoteAttachmentModel",
76103
+ "inputSchema": {
76104
+ "parentId": {
76105
+ "type": "string | number",
76106
+ "required": true,
76107
+ "description": "The parent record id (parent-scoped collection; number, or a canonical integer string)."
76108
+ },
76109
+ "id": {
76110
+ "type": "string | number",
76111
+ "required": true,
76112
+ "description": "The record id (number, or a canonical integer string — ids beyond 2^53 are supported via the string form)."
76113
+ },
76114
+ "opts": {
76115
+ "type": "object",
76116
+ "required": false,
76117
+ "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.",
76118
+ "properties": [
76119
+ {
76120
+ "name": "fresh",
76121
+ "type": "boolean",
76122
+ "optional": true
76123
+ }
76124
+ ]
76125
+ }
76126
+ },
76127
+ "inputSchemaStrict": true,
76128
+ "outputSchema": {
76129
+ "type": "TaskNoteAttachmentModel",
76130
+ "drops": []
76131
+ },
76132
+ "examples": [
76133
+ "await client.taskNoteAttachments.get(7, 3)"
76134
+ ],
76135
+ "permissions": "unknown",
76136
+ "pagination": {
76137
+ "mode": "none"
76138
+ },
76139
+ "resolution": null,
76140
+ "retry": {
76141
+ "preset": "retry-ffb3a9cb"
76142
+ },
76143
+ "errors": {
76144
+ "set": 3
76145
+ },
76146
+ "metadata": {
76147
+ "purpose": "Get one TaskNoteAttachment by id.",
76148
+ "usage": "Returns the attachment model directly; item: null or an empty model is a typed not-found. Parent-scoped: parentId is the task-note id, followed by the attachment id.",
76149
+ "preferredWhen": "Use a known attachment id; query the scoped collection to discover ids.",
76150
+ "related": [
76151
+ "task_note_attachments.query"
76152
+ ],
76153
+ "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 task_note_attachments.query with includeFields.",
76154
+ "untrustedFields": [
76155
+ "title"
76156
+ ]
76157
+ },
76158
+ "compact": null,
76159
+ "status": "tested"
76160
+ },
76161
+ {
76162
+ "id": "task_note_attachments.getEntityInfo",
76163
+ "resource": "task_note_attachments",
76164
+ "udfCapable": false,
76165
+ "operation": "getEntityInfo",
76166
+ "kind": "primitive",
76167
+ "endpoint": "GET /V1.0/TaskNoteAttachments/entityInformation",
76168
+ "effect": "read",
76169
+ "flags": [],
76170
+ "dryRun": false,
76171
+ "envelope": "EntityInformationResultModel",
76172
+ "inputSchema": {},
76173
+ "inputSchemaStrict": true,
76174
+ "outputSchema": {
76175
+ "type": "EntityInformationResultModel",
76176
+ "drops": []
76177
+ },
76178
+ "examples": [
76179
+ "await client.taskNoteAttachments.getEntityInfo()"
76180
+ ],
76181
+ "permissions": "unknown",
76182
+ "pagination": {
76183
+ "mode": "none"
76184
+ },
76185
+ "resolution": null,
76186
+ "retry": {
76187
+ "preset": "retry-ffb3a9cb"
76188
+ },
76189
+ "errors": {
76190
+ "set": 0
76191
+ },
76192
+ "metadata": {
76193
+ "purpose": "Get the TaskNoteAttachment capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
76194
+ "usage": "Unwraps info{}; drives client-side capability checks.",
76195
+ "preferredWhen": null,
76196
+ "related": [
76197
+ "task_note_attachments.getFieldInfo"
76198
+ ],
76199
+ "untrustedFields": [
76200
+ "title"
76201
+ ]
76202
+ },
76203
+ "compact": null,
76204
+ "status": "tested"
76205
+ },
76206
+ {
76207
+ "id": "task_note_attachments.getFieldInfo",
76208
+ "resource": "task_note_attachments",
76209
+ "udfCapable": false,
76210
+ "operation": "getFieldInfo",
76211
+ "kind": "primitive",
76212
+ "endpoint": "GET /V1.0/TaskNoteAttachments/entityInformation/fields",
76213
+ "effect": "read",
76214
+ "flags": [],
76215
+ "dryRun": false,
76216
+ "envelope": "FieldInformationResultModel",
76217
+ "inputSchema": {},
76218
+ "inputSchemaStrict": true,
76219
+ "outputSchema": {
76220
+ "type": "FieldInformationResultModel",
76221
+ "drops": []
76222
+ },
76223
+ "examples": [
76224
+ "await client.taskNoteAttachments.getFieldInfo()"
76225
+ ],
76226
+ "permissions": "unknown",
76227
+ "pagination": {
76228
+ "mode": "none"
76229
+ },
76230
+ "resolution": null,
76231
+ "retry": {
76232
+ "preset": "retry-ffb3a9cb"
76233
+ },
76234
+ "errors": {
76235
+ "set": 0
76236
+ },
76237
+ "metadata": {
76238
+ "purpose": "Get the TaskNoteAttachment field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
76239
+ "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.",
76240
+ "preferredWhen": null,
76241
+ "related": [
76242
+ "task_note_attachments.getEntityInfo"
76243
+ ],
76244
+ "untrustedFields": [
76245
+ "title"
76246
+ ]
76247
+ },
76248
+ "compact": null,
76249
+ "status": "tested"
76250
+ },
76251
+ {
76252
+ "id": "task_note_attachments.query",
76253
+ "resource": "task_note_attachments",
76254
+ "udfCapable": false,
76255
+ "operation": "query",
76256
+ "kind": "primitive",
76257
+ "endpoint": "GET|POST /V1.0/TaskNoteAttachments/query",
76258
+ "effect": "read",
76259
+ "flags": [],
76260
+ "dryRun": false,
76261
+ "envelope": "QueryActionResult[<Model>,<Entity>]",
76262
+ "inputSchema": {
76263
+ "params": {
76264
+ "type": "object",
76265
+ "required": false,
76266
+ "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.",
76267
+ "properties": [
76268
+ {
76269
+ "name": "filter",
76270
+ "type": "FilterCondition[]",
76271
+ "optional": true
76272
+ },
76273
+ {
76274
+ "name": "limit",
76275
+ "type": "number",
76276
+ "optional": true,
76277
+ "default": 500
76278
+ },
76279
+ {
76280
+ "name": "latest",
76281
+ "type": "number",
76282
+ "optional": true
76283
+ },
76284
+ {
76285
+ "name": "noteChars",
76286
+ "type": "number",
76287
+ "optional": true
76288
+ },
76289
+ {
76290
+ "name": "includeFields",
76291
+ "type": "string[]",
76292
+ "optional": true
76293
+ },
76294
+ {
76295
+ "name": "fieldCheck",
76296
+ "type": "boolean",
76297
+ "optional": true,
76298
+ "default": true
76299
+ },
76300
+ {
76301
+ "name": "names",
76302
+ "type": "boolean",
76303
+ "optional": true
76304
+ },
76305
+ {
76306
+ "name": "via",
76307
+ "type": "\"post\" | \"get\"",
76308
+ "optional": true
76309
+ },
76310
+ {
76311
+ "name": "acknowledgeUnscoped",
76312
+ "type": "boolean",
76313
+ "optional": true
76314
+ },
76315
+ {
76316
+ "name": "walk",
76317
+ "type": "object",
76318
+ "optional": true
76319
+ }
76320
+ ]
76321
+ }
76322
+ },
76323
+ "inputSchemaStrict": true,
76324
+ "outputSchema": {
76325
+ "type": "QueryActionResult[<Model>,<Entity>]",
76326
+ "drops": []
76327
+ },
76328
+ "examples": [
76329
+ "await invoke(client, 'task_note_attachments.query', [{ filter: [{ field: 'taskNoteID', op: 'eq', value: 7 }], limit: 25 }])"
76330
+ ],
76331
+ "permissions": "unknown",
76332
+ "pagination": {
76333
+ "mode": "cursor",
76334
+ "vendorDefault": 10,
76335
+ "vendorMax": 500,
76336
+ "pageGuard": 1000,
76337
+ "queryBounded": {
76338
+ "default": 500,
76339
+ "max": 2500
76340
+ }
76341
+ },
76342
+ "resolution": null,
76343
+ "retry": {
76344
+ "preset": "retry-ffb3a9cb"
76345
+ },
76346
+ "errors": {
76347
+ "set": 4
76348
+ },
76349
+ "metadata": {
76350
+ "purpose": "Query TaskNoteAttachment records with a JSON filter.",
76351
+ "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 taskNoteID 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 taskNoteID filter. taskID is the separate task association; taskNoteID identifies the note parent. Do not substitute the task id for the note id. 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.",
76352
+ "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).",
76353
+ "related": [
76354
+ "task_note_attachments.get"
76355
+ ],
76356
+ "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.",
76357
+ "untrustedFields": [
76358
+ "title"
76359
+ ]
76360
+ },
76361
+ "compact": null,
76362
+ "status": "tested"
76363
+ },
75412
76364
  {
75413
76365
  "id": "task_notes.count",
75414
76366
  "resource": "task_notes",
@@ -85638,8 +86590,8 @@ const CAPABILITY_DATA = {
85638
86590
  ]
85639
86591
  },
85640
86592
  "operations": {
85641
- "planHash": "3732a92572dcff19995b19cf9ba1dec6156153313f5d54704d1cca885d1aff45",
85642
- "builtAt": "2026-11-19T02:05:42.511Z",
86593
+ "planHash": "3b14a93bbda886bce89c87d61ba40092f9acf6a829a959f042be1c3a0744ed42",
86594
+ "builtAt": "2026-11-19T05:20:04.039Z",
85643
86595
  "records": [
85644
86596
  {
85645
86597
  "id": "operations.aggregate",