Currently, there are two major limitations in the ClickUp Docs API that affect integration and automation workflows: Linking a Doc to a Task (and vice versa) At the moment, there’s no way to associate a ClickUp Doc with a Task via the API. The Create Task Attachment endpoint only allows attaching external files — it does not support linking native ClickUp Docs. Also, while it's possible to create links between tasks, there's no similar functionality available for documents. Managing Doc permissions When creating a Doc via the Create Doc endpoint, there’s no way to manage detailed access settings. The only option is to set it as either "private" or "public", but if it's private, there's no way to specify which members or guests should have access. The Update privacy and access of an object or location endpoint — which supports updating permissions for most ClickUp objects (tasks, spaces, lists, etc.) — doesn't support documents, leading to a gap in access control. Suggestions: Add support for linking Docs to Tasks (in both directions). Expand the Docs API to include access management by user or group, similar to how it works for other objects. These improvements would make the API more robust and consistent with the capabilities available through the ClickUp UI.
