Docs Methods

Method Name Method Type Description
fetch_docs(object_ids, limit, page) Getter Retrieves metadata for docs with pagination.
create_doc(workspace_id, name, kind) Setter Creates a new doc in a workspace.

Method Details

fetch_docs()

fetch_docs(object_ids, limit, page)

Description: Retrieves metadata for docs with pagination.

Arguments:

  • object_ids (list, optional): Specific doc IDs to return.
  • limit (int, optional): Number of docs to retrieve per request (default: 25, max: 100).
  • page (int, optional): Page number to fetch (default: 1).

Returns: List of dictionaries containing doc details. Returns None or an error message if the request fails.

Example:

response = monday.docs.fetch_docs(limit=50, page=2)

create_doc()

create_doc(workspace_id, name, kind)

Description: Creates a new doc in a workspace.

Arguments:

  • workspace_id (int): ID of the workspace.
  • name (str): Name of the new doc.
  • kind (str, optional): Doc kind ("private", "public", or "share"). Default is "private".

Returns: UUID of the newly created doc. Returns None or an error message if the API call fails.

Example:

new_doc_id = monday.docs.create_doc(workspace_id=123456, name="Project Plan", kind="public")