List Folders (lawmatics_list-folders)
List folders from Lawmatics with optional pagination, filtering, and sorting. Rows carry the folder name, timestamps, and a `relationships` envelope of to-one {id,type} pointers (the owning matter/contact and the parent folder); use get-folder for the full envelope including child folders and files. To list the folders belonging to one record (a matter or contact), filter on documentable_id with that record's id. You can also filter on created_at / updated_at by date.
Tool Input
pageinteger— Page number (1-based)(> 0)
filterobject— Optional single-field filter; one filter at a time
fieldstringrequired— Field to filter on: documentable_id (numeric id of the record — a matter/prospect or contact — the folder belongs to; the way to list one record's folders), created_at, or updated_at (dates)(enum: "documentable_id", "created_at", "updated_at")
operatorstring— Comparison operator. Omit to use the Lawmatics per-field default (= for documentable_id). Use = for documentable_id and a range operator (e.g. >=) for created_at / updated_at(enum: "=", "!=", "<", "<=", ">", ">=", "null", "not_null")
valuestringrequired— Value to compare against (ignored for null / not_null operators)
sortBystring— Column to sort by(enum: "id", "created_at", "updated_at")
sortOrderstring— Sort direction; ascending or descending(enum: "asc", "desc")
Tool Output
foldersarrayrequired— Folders on this page of results
[]object
idstringrequired— Unique ID of the folder
namestringrequired— Folder name as stored (Lawmatics replaces slashes with colons)
createdAtstringnullrequired— When the folder was created, as an ISO 8601 timestamp; null if unknown
updatedAtstringnullrequired— When the folder was last updated, as an ISO 8601 timestamp; null if unknown
relationshipsobjectrequired— To-one JSON:API relationship pointers as {id,type} stubs. Not materialized — follow a pointer by calling that resource's own tool. List rows carry to-one pointers only; use get-folder for the full envelope incl. to-many (files, child folders).
2 fields
documentableobjectnullrequired— Owning record pointer — the matter/prospect or contact this folder belongs to; null when unset
2 fields
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— JSON:API record class of the reference (e.g. "user", "contact", "prospect", "firm"); resolve it by calling that resource's own get/find tool — this pointer is not materialized
parentFolderobjectnullrequired— Parent folder pointer when this folder is nested; null when it is at the top level
2 fields
idstringrequired— ID of the referenced Lawmatics record
typestringrequired— JSON:API record class of the reference (e.g. "user", "contact", "prospect", "firm"); resolve it by calling that resource's own get/find tool — this pointer is not materialized
paginationobjectnullrequired— Pagination metadata from the API response; null when the endpoint returns no meta envelope
totalPagesnumbernullrequired— Total number of pages available
limitPerPagenumbernullrequired— Maximum folders returned per page; null if not reported
totalEntriesnumbernullrequired— Total number of folders across all pages
Related Tools