Autotask icon

Autotask

Work with Autotask PSA REST API resources

Actions125

Task Note → List Task Notes

AI-generated

Summary

List task notes

Inputs

  • parentId (required) — Numeric ID of the parent task.
  • returnAll — Whether to return all results or only up to a given Limit.
  • limit — Maximum number of results to return.
  • includeFields — Comma‑separated list of fields to include in the response; leave blank to return all fields.
  • useAdvancedFilters — Whether to show advanced filter controls (row‑builder + raw JSON).
  • advancedFilters — Advanced filter clauses joined with AND; visible only when Use Advanced Filters is enabled.
  • filterJson — Raw Autotask filter JSON array for complex or nested filtering.
  • requestOptions — Header overrides; e.g., impersonation resource ID.

Output shape

array of Task Note objects

Pagination is controlled by returnAll and limit; includeFields can restrict fields; results may be fewer than requested.

Examples

Example 1: Retrieve the first 10 notes of task 12345, including only id and description fields.

parentId=12345&limit=10&includeFields=id,description

Example 2: Fetch all notes for task 987 using an advanced filter for notes created after 2023‑01‑01.

parentId=987&returnAll=true&advancedFilters=[{"field":"createDate","operator":"gt","value":"2023-01-01"}]

Example 3: Get notes of a task while excluding archived notes via a custom filter.

parentId=555&filterJson=[{"op":"not","items":[{"op":"eq","field":"status","value":"archived"}]}]

Links

Discussion