node-autotask 0.82.0 → 0.84.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.
- package/CHANGELOG.md +16 -0
- package/MCP_TOOL_CATALOG.json +577 -9
- package/README.md +1 -1
- package/capabilities.json +3194 -881
- package/dist/capabilities-data.js +3448 -1135
- package/dist/capabilities.cjs +4 -4
- package/dist/capabilities.js +1 -1
- package/dist/{chunk-TZL45TYE.cjs → chunk-36RXJUSA.cjs} +199 -199
- package/dist/{chunk-EFINBMXE.cjs → chunk-4NLWSHCB.cjs} +650 -91
- package/dist/{chunk-HZGCJ2CQ.js → chunk-AWK7FIZD.js} +645 -86
- package/dist/{chunk-EQ6LOII6.js → chunk-HASLVFC7.js} +3 -3
- package/dist/{chunk-5UR4L7SB.cjs → chunk-MVGGHMOB.cjs} +3 -3
- package/dist/{chunk-FYDLVUSN.js → chunk-RWBOJ5WK.js} +7 -2
- package/dist/{chunk-XJQYDJKB.cjs → chunk-SNILYCAV.cjs} +35 -30
- package/dist/{chunk-7PQKFGTI.js → chunk-Z56J7TFC.js} +2 -2
- package/dist/{index-inEhFJaU.d.cts → index-BZItfp_H.d.cts} +151 -1
- package/dist/{index-inEhFJaU.d.ts → index-BZItfp_H.d.ts} +151 -1
- package/dist/{index-Dt1KqDEQ.d.cts → index-DdvYwR2w.d.cts} +95 -84
- package/dist/{index-CW3PJPqH.d.ts → index-f1c_EdAt.d.ts} +95 -84
- package/dist/index.cjs +84 -84
- package/dist/index.d.cts +6 -5
- package/dist/index.d.ts +6 -5
- package/dist/index.js +5 -5
- package/dist/operations/index.cjs +51 -51
- package/dist/operations/index.d.cts +4 -4
- package/dist/operations/index.d.ts +4 -4
- package/dist/operations/index.js +2 -2
- package/dist/pool.cjs +12 -12
- package/dist/pool.d.cts +1 -1
- package/dist/pool.d.ts +1 -1
- package/dist/pool.js +4 -4
- package/dist/resources/index.cjs +27 -27
- package/dist/resources/index.d.cts +2 -2
- package/dist/resources/index.d.ts +2 -2
- package/dist/resources/index.js +3 -3
- package/dist/types/index.d.cts +1 -1
- package/dist/types/index.d.ts +1 -1
- package/docs/API.md +34 -20
- package/docs/RELEASING.md +2 -1
- package/package.json +1 -1
package/MCP_TOOL_CATALOG.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"generatedBy": "scripts/build-tool-catalog.mjs",
|
|
3
|
-
"generatedAt": "2026-11-
|
|
4
|
-
"planHash": "
|
|
3
|
+
"generatedAt": "2026-11-19T23:12:18.152Z",
|
|
4
|
+
"planHash": "5a5cfa013a7d398302f69e1c12e260ea29a89942aec743997be1f8cdf60a8df1",
|
|
5
5
|
"metaTools": [
|
|
6
6
|
{
|
|
7
7
|
"name": "autotask_catalog",
|
|
@@ -51,7 +51,7 @@
|
|
|
51
51
|
{
|
|
52
52
|
"name": "autotask_read",
|
|
53
53
|
"title": "Read One Registry Operation (read mode)",
|
|
54
|
-
"description": "Route an effect=read registry operation by its exact name (never fuzzy, never a tool name): the
|
|
54
|
+
"description": "Route an effect=read registry operation by its exact name (never fuzzy, never a tool name): the 432 field/entity/UDF-info reads (getEntityInfo/getFieldInfo/getUdfInfo) have no dedicated tool and ride this one, and any read op is routable. For field discovery use operations.fieldCatalog (compact) instead of per-resource getFieldInfo (full dump). Read-only by construction — every op it can route is effect=read (zero mutating requests), and a write or delete op is refused BEFORE any request (cross-mode refusal; the message names the correct tool). Reads have no dry run (a read with dry_run: true is refused). Harness approval policy: approve every tool with readOnlyHint !== true (exactly 283 today); the 665 readOnlyHint: true tools — including this one — are safe ungated; the 70 destructiveHint: true tools (69 dedicated delete tools + autotask_delete) require confirm === the operation key. Migration: autotask_invoke is REPLACED by autotask_read/autotask_write/autotask_delete — update harness config. For query/count ops args[0] is a params object (filter/limit); call autotask_describe first for the exact arg shape and filter grammar. The argument set is CLOSED at the top level: an unknown argument is refused before any request, with a typed error naming the key and the valid keys.",
|
|
55
55
|
"input": {
|
|
56
56
|
"operation": {
|
|
57
57
|
"type": "string",
|
|
@@ -71,7 +71,7 @@
|
|
|
71
71
|
{
|
|
72
72
|
"name": "autotask_write",
|
|
73
73
|
"title": "Write One Registry Operation (write mode)",
|
|
74
|
-
"description": "Route an effect=write registry operation by its exact name (never fuzzy, never a tool name), dry-run-first: the first call always travels dry_run: true (the pinned DryRunResult envelope, simulated: true — the mutating request is never issued); pass dry_run: false to apply. A read or delete op is refused BEFORE any request (cross-mode refusal; the message names the correct tool). The 2 approval-gated writes (configuration_items.moveConfigurationItem, contacts.moveToCompany) additionally require confirm === the operation key, in BOTH dry-run and apply mode. Harness approval policy: this tool is one of the
|
|
74
|
+
"description": "Route an effect=write registry operation by its exact name (never fuzzy, never a tool name), dry-run-first: the first call always travels dry_run: true (the pinned DryRunResult envelope, simulated: true — the mutating request is never issued); pass dry_run: false to apply. A read or delete op is refused BEFORE any request (cross-mode refusal; the message names the correct tool). The 2 approval-gated writes (configuration_items.moveConfigurationItem, contacts.moveToCompany) additionally require confirm === the operation key, in BOTH dry-run and apply mode. Harness approval policy: this tool is one of the 283 tools that require approval (readOnlyHint !== true); the 665 readOnlyHint: true tools are safe ungated, and the 70 destructiveHint: true tools (69 dedicated delete tools + autotask_delete) require confirm === the operation key. Migration: autotask_invoke is REPLACED by autotask_read/autotask_write/autotask_delete — update harness config. For query/count ops args[0] is a params object (filter/limit); call autotask_describe first for the exact arg shape and filter grammar. The argument set is CLOSED at the top level: an unknown argument is refused before any request, with a typed error naming the key and the valid keys.",
|
|
75
75
|
"input": {
|
|
76
76
|
"operation": {
|
|
77
77
|
"type": "string",
|
|
@@ -101,7 +101,7 @@
|
|
|
101
101
|
{
|
|
102
102
|
"name": "autotask_delete",
|
|
103
103
|
"title": "Delete One Registry Operation (delete mode)",
|
|
104
|
-
"description": "Route an effect=destructive (delete) registry operation by its exact name (never fuzzy, never a tool name), dry-run-first: the first call always travels dry_run: true (the pinned DryRunResult envelope, simulated: true); pass dry_run: false to apply. confirm === the operation key is REQUIRED for every delete (all
|
|
104
|
+
"description": "Route an effect=destructive (delete) registry operation by its exact name (never fuzzy, never a tool name), dry-run-first: the first call always travels dry_run: true (the pinned DryRunResult envelope, simulated: true); pass dry_run: false to apply. confirm === the operation key is REQUIRED for every delete (all 69), in BOTH dry-run and apply mode — the deliberate act is the call, not the delete. A read or write op is refused BEFORE any request (cross-mode refusal; the message names the correct tool). Harness approval policy: this tool is one of the 70 destructiveHint: true tools that require approval + confirm; approve every tool with readOnlyHint !== true (exactly 283 today); the 665 readOnlyHint: true tools are safe ungated. Migration: autotask_invoke is REPLACED by autotask_read/autotask_write/autotask_delete — update harness config. The argument set is CLOSED at the top level: an unknown argument is refused before any request, with a typed error naming the key and the valid keys.",
|
|
105
105
|
"input": {
|
|
106
106
|
"operation": {
|
|
107
107
|
"type": "string",
|
|
@@ -3247,6 +3247,318 @@
|
|
|
3247
3247
|
"reachReason": null,
|
|
3248
3248
|
"boundedAlternative": null
|
|
3249
3249
|
},
|
|
3250
|
+
{
|
|
3251
|
+
"operation": "deleted_task_activity_logs.count",
|
|
3252
|
+
"core": false,
|
|
3253
|
+
"tool": "autotask_deletedTaskActivityLog_count",
|
|
3254
|
+
"purpose": "Count DeletedTaskActivityLog audit records matching a JSON filter.",
|
|
3255
|
+
"preferredWhen": null,
|
|
3256
|
+
"backingOperation": "deleted_task_activity_logs.count",
|
|
3257
|
+
"effect": "read",
|
|
3258
|
+
"dryRunFirst": false,
|
|
3259
|
+
"confirm": false,
|
|
3260
|
+
"requiredArgs": [],
|
|
3261
|
+
"tier": "advanced",
|
|
3262
|
+
"reachable": true,
|
|
3263
|
+
"reach": "dedicated tool",
|
|
3264
|
+
"reachReason": null,
|
|
3265
|
+
"boundedAlternative": null
|
|
3266
|
+
},
|
|
3267
|
+
{
|
|
3268
|
+
"operation": "deleted_task_activity_logs.get",
|
|
3269
|
+
"core": false,
|
|
3270
|
+
"tool": "autotask_deletedTaskActivityLog_get",
|
|
3271
|
+
"purpose": "Get one DeletedTaskActivityLog audit record by its log id.",
|
|
3272
|
+
"preferredWhen": "Use the audit log record id, not the task or ticket id; discover log ids with a bounded filtered query.",
|
|
3273
|
+
"backingOperation": "deleted_task_activity_logs.get",
|
|
3274
|
+
"effect": "read",
|
|
3275
|
+
"dryRunFirst": false,
|
|
3276
|
+
"confirm": false,
|
|
3277
|
+
"requiredArgs": [
|
|
3278
|
+
"id"
|
|
3279
|
+
],
|
|
3280
|
+
"tier": "advanced",
|
|
3281
|
+
"reachable": true,
|
|
3282
|
+
"reach": "dedicated tool",
|
|
3283
|
+
"reachReason": null,
|
|
3284
|
+
"boundedAlternative": null
|
|
3285
|
+
},
|
|
3286
|
+
{
|
|
3287
|
+
"operation": "deleted_task_activity_logs.getEntityInfo",
|
|
3288
|
+
"core": false,
|
|
3289
|
+
"tool": null,
|
|
3290
|
+
"purpose": "Get DeletedTaskActivityLog entity capability metadata.",
|
|
3291
|
+
"preferredWhen": null,
|
|
3292
|
+
"backingOperation": "deleted_task_activity_logs.getEntityInfo",
|
|
3293
|
+
"effect": "read",
|
|
3294
|
+
"dryRunFirst": false,
|
|
3295
|
+
"confirm": false,
|
|
3296
|
+
"requiredArgs": [],
|
|
3297
|
+
"tier": "advanced",
|
|
3298
|
+
"reachable": true,
|
|
3299
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
3300
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
3301
|
+
"boundedAlternative": null
|
|
3302
|
+
},
|
|
3303
|
+
{
|
|
3304
|
+
"operation": "deleted_task_activity_logs.getFieldInfo",
|
|
3305
|
+
"core": false,
|
|
3306
|
+
"tool": null,
|
|
3307
|
+
"purpose": "Get the DeletedTaskActivityLog field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
|
|
3308
|
+
"preferredWhen": "Use when the full raw field catalog is needed. Requires Admin-level access to Projects & Tasks or Service Desk. Visibility and module/API-user permissions remain conditional; an empty result does not establish absence. Actor resource IDs do not establish company ownership, and referenced task/ticket records may be unavailable. Read-only audit access does not restore deleted records or unpost time.",
|
|
3309
|
+
"backingOperation": "deleted_task_activity_logs.getFieldInfo",
|
|
3310
|
+
"effect": "read",
|
|
3311
|
+
"dryRunFirst": false,
|
|
3312
|
+
"confirm": false,
|
|
3313
|
+
"requiredArgs": [],
|
|
3314
|
+
"tier": "advanced",
|
|
3315
|
+
"reachable": true,
|
|
3316
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
3317
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
3318
|
+
"boundedAlternative": null
|
|
3319
|
+
},
|
|
3320
|
+
{
|
|
3321
|
+
"operation": "deleted_task_activity_logs.getUdfInfo",
|
|
3322
|
+
"core": false,
|
|
3323
|
+
"tool": null,
|
|
3324
|
+
"purpose": "Get the documented DeletedTaskActivityLog UDF metadata catalog; this entity does not support UDF writes.",
|
|
3325
|
+
"preferredWhen": null,
|
|
3326
|
+
"backingOperation": "deleted_task_activity_logs.getUdfInfo",
|
|
3327
|
+
"effect": "read",
|
|
3328
|
+
"dryRunFirst": false,
|
|
3329
|
+
"confirm": false,
|
|
3330
|
+
"requiredArgs": [],
|
|
3331
|
+
"tier": "advanced",
|
|
3332
|
+
"reachable": true,
|
|
3333
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
3334
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
3335
|
+
"boundedAlternative": null
|
|
3336
|
+
},
|
|
3337
|
+
{
|
|
3338
|
+
"operation": "deleted_task_activity_logs.query",
|
|
3339
|
+
"core": false,
|
|
3340
|
+
"tool": "autotask_deletedTaskActivityLog_query",
|
|
3341
|
+
"purpose": "Query DeletedTaskActivityLog audit records with a JSON filter.",
|
|
3342
|
+
"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).",
|
|
3343
|
+
"backingOperation": "deleted_task_activity_logs.query",
|
|
3344
|
+
"effect": "read",
|
|
3345
|
+
"dryRunFirst": false,
|
|
3346
|
+
"confirm": false,
|
|
3347
|
+
"requiredArgs": [],
|
|
3348
|
+
"tier": "advanced",
|
|
3349
|
+
"reachable": true,
|
|
3350
|
+
"reach": "dedicated tool",
|
|
3351
|
+
"reachReason": null,
|
|
3352
|
+
"boundedAlternative": null
|
|
3353
|
+
},
|
|
3354
|
+
{
|
|
3355
|
+
"operation": "deleted_ticket_activity_logs.count",
|
|
3356
|
+
"core": false,
|
|
3357
|
+
"tool": "autotask_deletedTicketActivityLog_count",
|
|
3358
|
+
"purpose": "Count DeletedTicketActivityLog audit records matching a JSON filter.",
|
|
3359
|
+
"preferredWhen": null,
|
|
3360
|
+
"backingOperation": "deleted_ticket_activity_logs.count",
|
|
3361
|
+
"effect": "read",
|
|
3362
|
+
"dryRunFirst": false,
|
|
3363
|
+
"confirm": false,
|
|
3364
|
+
"requiredArgs": [],
|
|
3365
|
+
"tier": "advanced",
|
|
3366
|
+
"reachable": true,
|
|
3367
|
+
"reach": "dedicated tool",
|
|
3368
|
+
"reachReason": null,
|
|
3369
|
+
"boundedAlternative": null
|
|
3370
|
+
},
|
|
3371
|
+
{
|
|
3372
|
+
"operation": "deleted_ticket_activity_logs.get",
|
|
3373
|
+
"core": false,
|
|
3374
|
+
"tool": "autotask_deletedTicketActivityLog_get",
|
|
3375
|
+
"purpose": "Get one DeletedTicketActivityLog audit record by its log id.",
|
|
3376
|
+
"preferredWhen": "Use the audit log record id, not the task or ticket id; discover log ids with a bounded filtered query.",
|
|
3377
|
+
"backingOperation": "deleted_ticket_activity_logs.get",
|
|
3378
|
+
"effect": "read",
|
|
3379
|
+
"dryRunFirst": false,
|
|
3380
|
+
"confirm": false,
|
|
3381
|
+
"requiredArgs": [
|
|
3382
|
+
"id"
|
|
3383
|
+
],
|
|
3384
|
+
"tier": "advanced",
|
|
3385
|
+
"reachable": true,
|
|
3386
|
+
"reach": "dedicated tool",
|
|
3387
|
+
"reachReason": null,
|
|
3388
|
+
"boundedAlternative": null
|
|
3389
|
+
},
|
|
3390
|
+
{
|
|
3391
|
+
"operation": "deleted_ticket_activity_logs.getEntityInfo",
|
|
3392
|
+
"core": false,
|
|
3393
|
+
"tool": null,
|
|
3394
|
+
"purpose": "Get DeletedTicketActivityLog entity capability metadata.",
|
|
3395
|
+
"preferredWhen": null,
|
|
3396
|
+
"backingOperation": "deleted_ticket_activity_logs.getEntityInfo",
|
|
3397
|
+
"effect": "read",
|
|
3398
|
+
"dryRunFirst": false,
|
|
3399
|
+
"confirm": false,
|
|
3400
|
+
"requiredArgs": [],
|
|
3401
|
+
"tier": "advanced",
|
|
3402
|
+
"reachable": true,
|
|
3403
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
3404
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
3405
|
+
"boundedAlternative": null
|
|
3406
|
+
},
|
|
3407
|
+
{
|
|
3408
|
+
"operation": "deleted_ticket_activity_logs.getFieldInfo",
|
|
3409
|
+
"core": false,
|
|
3410
|
+
"tool": null,
|
|
3411
|
+
"purpose": "Get the DeletedTicketActivityLog field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
|
|
3412
|
+
"preferredWhen": "Use when the full raw field catalog is needed. Requires Admin-level access to Projects & Tasks or Service Desk. Visibility and module/API-user permissions remain conditional; an empty result does not establish absence. Actor resource IDs do not establish company ownership, and referenced task/ticket records may be unavailable. Read-only audit access does not restore deleted records or unpost time.",
|
|
3413
|
+
"backingOperation": "deleted_ticket_activity_logs.getFieldInfo",
|
|
3414
|
+
"effect": "read",
|
|
3415
|
+
"dryRunFirst": false,
|
|
3416
|
+
"confirm": false,
|
|
3417
|
+
"requiredArgs": [],
|
|
3418
|
+
"tier": "advanced",
|
|
3419
|
+
"reachable": true,
|
|
3420
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
3421
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
3422
|
+
"boundedAlternative": null
|
|
3423
|
+
},
|
|
3424
|
+
{
|
|
3425
|
+
"operation": "deleted_ticket_activity_logs.getUdfInfo",
|
|
3426
|
+
"core": false,
|
|
3427
|
+
"tool": null,
|
|
3428
|
+
"purpose": "Get the documented DeletedTicketActivityLog UDF metadata catalog; this entity does not support UDF writes.",
|
|
3429
|
+
"preferredWhen": null,
|
|
3430
|
+
"backingOperation": "deleted_ticket_activity_logs.getUdfInfo",
|
|
3431
|
+
"effect": "read",
|
|
3432
|
+
"dryRunFirst": false,
|
|
3433
|
+
"confirm": false,
|
|
3434
|
+
"requiredArgs": [],
|
|
3435
|
+
"tier": "advanced",
|
|
3436
|
+
"reachable": true,
|
|
3437
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
3438
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
3439
|
+
"boundedAlternative": null
|
|
3440
|
+
},
|
|
3441
|
+
{
|
|
3442
|
+
"operation": "deleted_ticket_activity_logs.query",
|
|
3443
|
+
"core": false,
|
|
3444
|
+
"tool": "autotask_deletedTicketActivityLog_query",
|
|
3445
|
+
"purpose": "Query DeletedTicketActivityLog audit records with a JSON filter.",
|
|
3446
|
+
"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).",
|
|
3447
|
+
"backingOperation": "deleted_ticket_activity_logs.query",
|
|
3448
|
+
"effect": "read",
|
|
3449
|
+
"dryRunFirst": false,
|
|
3450
|
+
"confirm": false,
|
|
3451
|
+
"requiredArgs": [],
|
|
3452
|
+
"tier": "advanced",
|
|
3453
|
+
"reachable": true,
|
|
3454
|
+
"reach": "dedicated tool",
|
|
3455
|
+
"reachReason": null,
|
|
3456
|
+
"boundedAlternative": null
|
|
3457
|
+
},
|
|
3458
|
+
{
|
|
3459
|
+
"operation": "deleted_ticket_logs.count",
|
|
3460
|
+
"core": false,
|
|
3461
|
+
"tool": "autotask_deletedTicketLog_count",
|
|
3462
|
+
"purpose": "Count DeletedTicketLog audit records matching a JSON filter.",
|
|
3463
|
+
"preferredWhen": null,
|
|
3464
|
+
"backingOperation": "deleted_ticket_logs.count",
|
|
3465
|
+
"effect": "read",
|
|
3466
|
+
"dryRunFirst": false,
|
|
3467
|
+
"confirm": false,
|
|
3468
|
+
"requiredArgs": [],
|
|
3469
|
+
"tier": "advanced",
|
|
3470
|
+
"reachable": true,
|
|
3471
|
+
"reach": "dedicated tool",
|
|
3472
|
+
"reachReason": null,
|
|
3473
|
+
"boundedAlternative": null
|
|
3474
|
+
},
|
|
3475
|
+
{
|
|
3476
|
+
"operation": "deleted_ticket_logs.get",
|
|
3477
|
+
"core": false,
|
|
3478
|
+
"tool": "autotask_deletedTicketLog_get",
|
|
3479
|
+
"purpose": "Get one DeletedTicketLog audit record by its log id.",
|
|
3480
|
+
"preferredWhen": "Use the audit log record id, not the task or ticket id; discover log ids with a bounded filtered query.",
|
|
3481
|
+
"backingOperation": "deleted_ticket_logs.get",
|
|
3482
|
+
"effect": "read",
|
|
3483
|
+
"dryRunFirst": false,
|
|
3484
|
+
"confirm": false,
|
|
3485
|
+
"requiredArgs": [
|
|
3486
|
+
"id"
|
|
3487
|
+
],
|
|
3488
|
+
"tier": "advanced",
|
|
3489
|
+
"reachable": true,
|
|
3490
|
+
"reach": "dedicated tool",
|
|
3491
|
+
"reachReason": null,
|
|
3492
|
+
"boundedAlternative": null
|
|
3493
|
+
},
|
|
3494
|
+
{
|
|
3495
|
+
"operation": "deleted_ticket_logs.getEntityInfo",
|
|
3496
|
+
"core": false,
|
|
3497
|
+
"tool": null,
|
|
3498
|
+
"purpose": "Get DeletedTicketLog entity capability metadata.",
|
|
3499
|
+
"preferredWhen": null,
|
|
3500
|
+
"backingOperation": "deleted_ticket_logs.getEntityInfo",
|
|
3501
|
+
"effect": "read",
|
|
3502
|
+
"dryRunFirst": false,
|
|
3503
|
+
"confirm": false,
|
|
3504
|
+
"requiredArgs": [],
|
|
3505
|
+
"tier": "advanced",
|
|
3506
|
+
"reachable": true,
|
|
3507
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
3508
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
3509
|
+
"boundedAlternative": null
|
|
3510
|
+
},
|
|
3511
|
+
{
|
|
3512
|
+
"operation": "deleted_ticket_logs.getFieldInfo",
|
|
3513
|
+
"core": false,
|
|
3514
|
+
"tool": null,
|
|
3515
|
+
"purpose": "Get the DeletedTicketLog field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
|
|
3516
|
+
"preferredWhen": "Use when the full raw field catalog is needed. Requires Admin-level access to Projects & Tasks or Service Desk. Visibility and module/API-user permissions remain conditional; an empty result does not establish absence. Actor resource IDs do not establish company ownership, and referenced task/ticket records may be unavailable. Read-only audit access does not restore deleted records or unpost time.",
|
|
3517
|
+
"backingOperation": "deleted_ticket_logs.getFieldInfo",
|
|
3518
|
+
"effect": "read",
|
|
3519
|
+
"dryRunFirst": false,
|
|
3520
|
+
"confirm": false,
|
|
3521
|
+
"requiredArgs": [],
|
|
3522
|
+
"tier": "advanced",
|
|
3523
|
+
"reachable": true,
|
|
3524
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
3525
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
3526
|
+
"boundedAlternative": null
|
|
3527
|
+
},
|
|
3528
|
+
{
|
|
3529
|
+
"operation": "deleted_ticket_logs.getUdfInfo",
|
|
3530
|
+
"core": false,
|
|
3531
|
+
"tool": null,
|
|
3532
|
+
"purpose": "Get the documented DeletedTicketLog UDF metadata catalog; this entity does not support UDF writes.",
|
|
3533
|
+
"preferredWhen": null,
|
|
3534
|
+
"backingOperation": "deleted_ticket_logs.getUdfInfo",
|
|
3535
|
+
"effect": "read",
|
|
3536
|
+
"dryRunFirst": false,
|
|
3537
|
+
"confirm": false,
|
|
3538
|
+
"requiredArgs": [],
|
|
3539
|
+
"tier": "advanced",
|
|
3540
|
+
"reachable": true,
|
|
3541
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
3542
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
3543
|
+
"boundedAlternative": null
|
|
3544
|
+
},
|
|
3545
|
+
{
|
|
3546
|
+
"operation": "deleted_ticket_logs.query",
|
|
3547
|
+
"core": false,
|
|
3548
|
+
"tool": "autotask_deletedTicketLog_query",
|
|
3549
|
+
"purpose": "Query DeletedTicketLog audit records with a JSON filter.",
|
|
3550
|
+
"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).",
|
|
3551
|
+
"backingOperation": "deleted_ticket_logs.query",
|
|
3552
|
+
"effect": "read",
|
|
3553
|
+
"dryRunFirst": false,
|
|
3554
|
+
"confirm": false,
|
|
3555
|
+
"requiredArgs": [],
|
|
3556
|
+
"tier": "advanced",
|
|
3557
|
+
"reachable": true,
|
|
3558
|
+
"reach": "dedicated tool",
|
|
3559
|
+
"reachReason": null,
|
|
3560
|
+
"boundedAlternative": null
|
|
3561
|
+
},
|
|
3250
3562
|
{
|
|
3251
3563
|
"operation": "departments.count",
|
|
3252
3564
|
"core": false,
|
|
@@ -3974,6 +4286,134 @@
|
|
|
3974
4286
|
"reachReason": null,
|
|
3975
4287
|
"boundedAlternative": null
|
|
3976
4288
|
},
|
|
4289
|
+
{
|
|
4290
|
+
"operation": "expense_report_attachments.count",
|
|
4291
|
+
"core": false,
|
|
4292
|
+
"tool": "autotask_expenseReportAttachment_count",
|
|
4293
|
+
"purpose": "Count expense report attachment records matching a JSON filter. Use expenseReportID for parent scope.",
|
|
4294
|
+
"preferredWhen": null,
|
|
4295
|
+
"backingOperation": "expense_report_attachments.count",
|
|
4296
|
+
"effect": "read",
|
|
4297
|
+
"dryRunFirst": false,
|
|
4298
|
+
"confirm": false,
|
|
4299
|
+
"requiredArgs": [],
|
|
4300
|
+
"tier": "extended",
|
|
4301
|
+
"reachable": true,
|
|
4302
|
+
"reach": "dedicated tool",
|
|
4303
|
+
"reachReason": null,
|
|
4304
|
+
"boundedAlternative": null
|
|
4305
|
+
},
|
|
4306
|
+
{
|
|
4307
|
+
"operation": "expense_report_attachments.create",
|
|
4308
|
+
"core": false,
|
|
4309
|
+
"tool": "autotask_expenseReportAttachment_create",
|
|
4310
|
+
"purpose": "Create a file attachment under an expense report.",
|
|
4311
|
+
"preferredWhen": "Add a new attachment; existing attachments cannot be updated. Replace through separately governed delete and create actions.",
|
|
4312
|
+
"backingOperation": "expense_report_attachments.create",
|
|
4313
|
+
"effect": "write",
|
|
4314
|
+
"dryRunFirst": true,
|
|
4315
|
+
"confirm": false,
|
|
4316
|
+
"requiredArgs": [
|
|
4317
|
+
"parentId",
|
|
4318
|
+
"data"
|
|
4319
|
+
],
|
|
4320
|
+
"tier": "extended",
|
|
4321
|
+
"reachable": true,
|
|
4322
|
+
"reach": "dedicated tool",
|
|
4323
|
+
"reachReason": null,
|
|
4324
|
+
"boundedAlternative": null
|
|
4325
|
+
},
|
|
4326
|
+
{
|
|
4327
|
+
"operation": "expense_report_attachments.delete",
|
|
4328
|
+
"core": false,
|
|
4329
|
+
"tool": "autotask_expenseReportAttachment_delete",
|
|
4330
|
+
"purpose": "Delete an attachment under an expense report.",
|
|
4331
|
+
"preferredWhen": null,
|
|
4332
|
+
"backingOperation": "expense_report_attachments.delete",
|
|
4333
|
+
"effect": "destructive",
|
|
4334
|
+
"dryRunFirst": true,
|
|
4335
|
+
"confirm": true,
|
|
4336
|
+
"requiredArgs": [
|
|
4337
|
+
"parentId",
|
|
4338
|
+
"id"
|
|
4339
|
+
],
|
|
4340
|
+
"tier": "extended",
|
|
4341
|
+
"reachable": true,
|
|
4342
|
+
"reach": "dedicated tool",
|
|
4343
|
+
"reachReason": null,
|
|
4344
|
+
"boundedAlternative": null
|
|
4345
|
+
},
|
|
4346
|
+
{
|
|
4347
|
+
"operation": "expense_report_attachments.get",
|
|
4348
|
+
"core": false,
|
|
4349
|
+
"tool": "autotask_expenseReportAttachment_get",
|
|
4350
|
+
"purpose": "Get one ExpenseReportAttachment by id.",
|
|
4351
|
+
"preferredWhen": "Use a known attachment id; query the scoped collection to discover ids.",
|
|
4352
|
+
"backingOperation": "expense_report_attachments.get",
|
|
4353
|
+
"effect": "read",
|
|
4354
|
+
"dryRunFirst": false,
|
|
4355
|
+
"confirm": false,
|
|
4356
|
+
"requiredArgs": [
|
|
4357
|
+
"parentId",
|
|
4358
|
+
"id"
|
|
4359
|
+
],
|
|
4360
|
+
"tier": "extended",
|
|
4361
|
+
"reachable": true,
|
|
4362
|
+
"reach": "dedicated tool",
|
|
4363
|
+
"reachReason": null,
|
|
4364
|
+
"boundedAlternative": null
|
|
4365
|
+
},
|
|
4366
|
+
{
|
|
4367
|
+
"operation": "expense_report_attachments.getEntityInfo",
|
|
4368
|
+
"core": false,
|
|
4369
|
+
"tool": null,
|
|
4370
|
+
"purpose": "Get the ExpenseReportAttachment capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
|
|
4371
|
+
"preferredWhen": null,
|
|
4372
|
+
"backingOperation": "expense_report_attachments.getEntityInfo",
|
|
4373
|
+
"effect": "read",
|
|
4374
|
+
"dryRunFirst": false,
|
|
4375
|
+
"confirm": false,
|
|
4376
|
+
"requiredArgs": [],
|
|
4377
|
+
"tier": "extended",
|
|
4378
|
+
"reachable": true,
|
|
4379
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
4380
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
4381
|
+
"boundedAlternative": null
|
|
4382
|
+
},
|
|
4383
|
+
{
|
|
4384
|
+
"operation": "expense_report_attachments.getFieldInfo",
|
|
4385
|
+
"core": false,
|
|
4386
|
+
"tool": null,
|
|
4387
|
+
"purpose": "Get the ExpenseReportAttachment field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
|
|
4388
|
+
"preferredWhen": null,
|
|
4389
|
+
"backingOperation": "expense_report_attachments.getFieldInfo",
|
|
4390
|
+
"effect": "read",
|
|
4391
|
+
"dryRunFirst": false,
|
|
4392
|
+
"confirm": false,
|
|
4393
|
+
"requiredArgs": [],
|
|
4394
|
+
"tier": "extended",
|
|
4395
|
+
"reachable": true,
|
|
4396
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
4397
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
4398
|
+
"boundedAlternative": null
|
|
4399
|
+
},
|
|
4400
|
+
{
|
|
4401
|
+
"operation": "expense_report_attachments.query",
|
|
4402
|
+
"core": false,
|
|
4403
|
+
"tool": "autotask_expenseReportAttachment_query",
|
|
4404
|
+
"purpose": "Query ExpenseReportAttachment records with a JSON filter.",
|
|
4405
|
+
"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).",
|
|
4406
|
+
"backingOperation": "expense_report_attachments.query",
|
|
4407
|
+
"effect": "read",
|
|
4408
|
+
"dryRunFirst": false,
|
|
4409
|
+
"confirm": false,
|
|
4410
|
+
"requiredArgs": [],
|
|
4411
|
+
"tier": "extended",
|
|
4412
|
+
"reachable": true,
|
|
4413
|
+
"reach": "dedicated tool",
|
|
4414
|
+
"reachReason": null,
|
|
4415
|
+
"boundedAlternative": null
|
|
4416
|
+
},
|
|
3977
4417
|
{
|
|
3978
4418
|
"operation": "expense_reports.count",
|
|
3979
4419
|
"core": false,
|
|
@@ -6699,6 +7139,134 @@
|
|
|
6699
7139
|
"reachReason": null,
|
|
6700
7140
|
"boundedAlternative": null
|
|
6701
7141
|
},
|
|
7142
|
+
{
|
|
7143
|
+
"operation": "resource_attachments.count",
|
|
7144
|
+
"core": false,
|
|
7145
|
+
"tool": "autotask_resourceAttachment_count",
|
|
7146
|
+
"purpose": "Count resource attachment records matching a JSON filter. Use resourceID for parent scope.",
|
|
7147
|
+
"preferredWhen": null,
|
|
7148
|
+
"backingOperation": "resource_attachments.count",
|
|
7149
|
+
"effect": "read",
|
|
7150
|
+
"dryRunFirst": false,
|
|
7151
|
+
"confirm": false,
|
|
7152
|
+
"requiredArgs": [],
|
|
7153
|
+
"tier": "extended",
|
|
7154
|
+
"reachable": true,
|
|
7155
|
+
"reach": "dedicated tool",
|
|
7156
|
+
"reachReason": null,
|
|
7157
|
+
"boundedAlternative": null
|
|
7158
|
+
},
|
|
7159
|
+
{
|
|
7160
|
+
"operation": "resource_attachments.create",
|
|
7161
|
+
"core": false,
|
|
7162
|
+
"tool": "autotask_resourceAttachment_create",
|
|
7163
|
+
"purpose": "Create a file attachment under a resource.",
|
|
7164
|
+
"preferredWhen": "Add a new attachment; existing attachments cannot be updated. Replace through separately governed delete and create actions.",
|
|
7165
|
+
"backingOperation": "resource_attachments.create",
|
|
7166
|
+
"effect": "write",
|
|
7167
|
+
"dryRunFirst": true,
|
|
7168
|
+
"confirm": false,
|
|
7169
|
+
"requiredArgs": [
|
|
7170
|
+
"parentId",
|
|
7171
|
+
"data"
|
|
7172
|
+
],
|
|
7173
|
+
"tier": "extended",
|
|
7174
|
+
"reachable": true,
|
|
7175
|
+
"reach": "dedicated tool",
|
|
7176
|
+
"reachReason": null,
|
|
7177
|
+
"boundedAlternative": null
|
|
7178
|
+
},
|
|
7179
|
+
{
|
|
7180
|
+
"operation": "resource_attachments.delete",
|
|
7181
|
+
"core": false,
|
|
7182
|
+
"tool": "autotask_resourceAttachment_delete",
|
|
7183
|
+
"purpose": "Delete an attachment under a resource.",
|
|
7184
|
+
"preferredWhen": null,
|
|
7185
|
+
"backingOperation": "resource_attachments.delete",
|
|
7186
|
+
"effect": "destructive",
|
|
7187
|
+
"dryRunFirst": true,
|
|
7188
|
+
"confirm": true,
|
|
7189
|
+
"requiredArgs": [
|
|
7190
|
+
"parentId",
|
|
7191
|
+
"id"
|
|
7192
|
+
],
|
|
7193
|
+
"tier": "extended",
|
|
7194
|
+
"reachable": true,
|
|
7195
|
+
"reach": "dedicated tool",
|
|
7196
|
+
"reachReason": null,
|
|
7197
|
+
"boundedAlternative": null
|
|
7198
|
+
},
|
|
7199
|
+
{
|
|
7200
|
+
"operation": "resource_attachments.get",
|
|
7201
|
+
"core": false,
|
|
7202
|
+
"tool": "autotask_resourceAttachment_get",
|
|
7203
|
+
"purpose": "Get one ResourceAttachment by id.",
|
|
7204
|
+
"preferredWhen": "Use a known attachment id; query the scoped collection to discover ids.",
|
|
7205
|
+
"backingOperation": "resource_attachments.get",
|
|
7206
|
+
"effect": "read",
|
|
7207
|
+
"dryRunFirst": false,
|
|
7208
|
+
"confirm": false,
|
|
7209
|
+
"requiredArgs": [
|
|
7210
|
+
"parentId",
|
|
7211
|
+
"id"
|
|
7212
|
+
],
|
|
7213
|
+
"tier": "extended",
|
|
7214
|
+
"reachable": true,
|
|
7215
|
+
"reach": "dedicated tool",
|
|
7216
|
+
"reachReason": null,
|
|
7217
|
+
"boundedAlternative": null
|
|
7218
|
+
},
|
|
7219
|
+
{
|
|
7220
|
+
"operation": "resource_attachments.getEntityInfo",
|
|
7221
|
+
"core": false,
|
|
7222
|
+
"tool": null,
|
|
7223
|
+
"purpose": "Get the ResourceAttachment capability metadata (canCreate/canUpdate/hasUserDefinedFields/...).",
|
|
7224
|
+
"preferredWhen": null,
|
|
7225
|
+
"backingOperation": "resource_attachments.getEntityInfo",
|
|
7226
|
+
"effect": "read",
|
|
7227
|
+
"dryRunFirst": false,
|
|
7228
|
+
"confirm": false,
|
|
7229
|
+
"requiredArgs": [],
|
|
7230
|
+
"tier": "extended",
|
|
7231
|
+
"reachable": true,
|
|
7232
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
7233
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
7234
|
+
"boundedAlternative": null
|
|
7235
|
+
},
|
|
7236
|
+
{
|
|
7237
|
+
"operation": "resource_attachments.getFieldInfo",
|
|
7238
|
+
"core": false,
|
|
7239
|
+
"tool": null,
|
|
7240
|
+
"purpose": "Get the ResourceAttachment field catalog (types, picklists, required, maxLength) — the full raw field dump (the largest read of the info trio; compact discovery: operations.fieldCatalog).",
|
|
7241
|
+
"preferredWhen": null,
|
|
7242
|
+
"backingOperation": "resource_attachments.getFieldInfo",
|
|
7243
|
+
"effect": "read",
|
|
7244
|
+
"dryRunFirst": false,
|
|
7245
|
+
"confirm": false,
|
|
7246
|
+
"requiredArgs": [],
|
|
7247
|
+
"tier": "extended",
|
|
7248
|
+
"reachable": true,
|
|
7249
|
+
"reach": "autotask_read (exact operation name; effect=read — read-only; zero mutating requests)",
|
|
7250
|
+
"reachReason": "no dedicated tool — the op is still discoverable and invocable by exact name",
|
|
7251
|
+
"boundedAlternative": null
|
|
7252
|
+
},
|
|
7253
|
+
{
|
|
7254
|
+
"operation": "resource_attachments.query",
|
|
7255
|
+
"core": false,
|
|
7256
|
+
"tool": "autotask_resourceAttachment_query",
|
|
7257
|
+
"purpose": "Query ResourceAttachment records with a JSON filter.",
|
|
7258
|
+
"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).",
|
|
7259
|
+
"backingOperation": "resource_attachments.query",
|
|
7260
|
+
"effect": "read",
|
|
7261
|
+
"dryRunFirst": false,
|
|
7262
|
+
"confirm": false,
|
|
7263
|
+
"requiredArgs": [],
|
|
7264
|
+
"tier": "extended",
|
|
7265
|
+
"reachable": true,
|
|
7266
|
+
"reach": "dedicated tool",
|
|
7267
|
+
"reachReason": null,
|
|
7268
|
+
"boundedAlternative": null
|
|
7269
|
+
},
|
|
6702
7270
|
{
|
|
6703
7271
|
"operation": "resource_role_queues.count",
|
|
6704
7272
|
"core": false,
|
|
@@ -24695,11 +25263,11 @@
|
|
|
24695
25263
|
}
|
|
24696
25264
|
],
|
|
24697
25265
|
"counts": {
|
|
24698
|
-
"registryOperations":
|
|
25266
|
+
"registryOperations": 1375,
|
|
24699
25267
|
"coreOperations": 10,
|
|
24700
|
-
"catalogRows":
|
|
24701
|
-
"withTool":
|
|
24702
|
-
"readModeOnly":
|
|
25268
|
+
"catalogRows": 1375,
|
|
25269
|
+
"withTool": 943,
|
|
25270
|
+
"readModeOnly": 432,
|
|
24703
25271
|
"neverExposed": 0,
|
|
24704
25272
|
"metaTools": 5
|
|
24705
25273
|
}
|