box_docgen_template_list_jobs_tool
Retrieve a list of document generation jobs associated with a specific template using the Box API. Supports pagination with optional marker and limit parameters for efficient job retrieval.
Instructions
List Doc Gen jobs that used a specific template.
Args: client (BoxClient): Authenticated Box client. template_id (str): ID of the template. marker (str, optional): Pagination marker. limit (int, optional): Max items per page.
Returns: DocGenJobsV2025R0: A page of Doc Gen jobs for the template.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| marker | No | ||
| template_id | Yes |
Implementation Reference
- src/tools/box_tools_docgen.py:139-160 (handler)The main asynchronous handler function implementing the tool logic. It retrieves the Box client from context and calls the underlying box_ai_agents_toolkit function box_docgen_template_list_jobs to list jobs for the given template.async def box_docgen_template_list_jobs_tool( ctx: Context, template_id: str, marker: str | None = None, limit: int | None = None, ) -> list[dict[str, Any]]: """ List Doc Gen jobs that used a specific template. Args: client (BoxClient): Authenticated Box client. template_id (str): ID of the template. marker (str, optional): Pagination marker. limit (int, optional): Max items per page. Returns: DocGenJobsV2025R0: A page of Doc Gen jobs for the template. """ box_client = get_box_client(ctx) return box_docgen_template_list_jobs( box_client, template_id=template_id, marker=marker, limit=limit )
- src/tool_registry/doc_gen_tools.py:29-29 (registration)The registration of the box_docgen_template_list_jobs_tool using the MCP FastMCP tool decorator within the register_doc_gen_tools function.mcp.tool()(box_docgen_template_list_jobs_tool)
- src/tool_registry/doc_gen_tools.py:12-12 (registration)Import of the box_docgen_template_list_jobs_tool handler from src/tools/box_tools_docgen.py in the tool registry module.box_docgen_template_list_jobs_tool,