clickup_search_docs
Search for Docs in a ClickUp workspace using filters like parent location, creator, or status. Returns doc names, IDs, and parent details with cursor-based pagination.
Instructions
Search the Docs in a Workspace, optionally filtered by parent location.
Lists Docs across the Workspace and can narrow by creator, parent container, or archived/deleted state. Results are cursor-paginated.
When to Use:
To find a Doc's id before reading (
clickup_get_doc) or editing its pages.To enumerate every Doc under a Space/Folder/List (set parent_id + parent_type).
When NOT to Use:
To read a specific Doc's content — use
clickup_get_doc_pagesinstead.To create a Doc — use
clickup_create_doc.
Returns:
A list of Docs (name, id, parent, created date). When more results exist the
response includes a next_cursor; pass it back as cursor to page forward.
Pagination:
Cursor-based. Loop: call once, read next_cursor from the output, then call
again with cursor=<next_cursor> until it is empty.
Examples:
params = {"parent_id": "901300", "parent_type": "space"}
params = {"cursor": "eyJ...", "limit": 100}
Error Handling:
401 → bad token; 404 → unknown Workspace id. Errors return an Error ... string.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |