add_timeline_entry

Add updates or progress notes to work items and enhancements in DevRev. Use this tool to document changes, track status, and maintain project timelines.

Instructions

Add a timeline entry to a work item (issue, ticket) or part (enhancement)

Input Schema

TableJSON Schema

Name	Required	Description	Default
`id`	Yes	The DevRev ID of the work item (issue, ticket) or part (enhancement)
`timeline_entry`	Yes	The timeline entry about updates to the work item (issue, ticket) or part (enhancement).

Implementation Reference

src/devrev_mcp/server.py:434-444 (registration)

Registration of the 'add_timeline_entry' tool including its description and input schema definition.

    name="add_timeline_entry",
    description="Add a timeline entry to a work item (issue, ticket) or part (enhancement)",
    inputSchema={
        "type": "object",
        "properties": {
            "id": {"type": "string", "description": "The DevRev ID of the work item (issue, ticket) or part (enhancement)"},
            "timeline_entry": {"type": "string", "description": "The timeline entry about updates to the work item (issue, ticket) or part (enhancement)."},
        },
        "required": ["id", "timeline_entry"],
    }
),

src/devrev_mcp/server.py:1262-1296 (handler)

Handler implementation for 'add_timeline_entry' tool that validates input, constructs payload, and calls the DevRev API to create a timeline entry of type 'timeline_comment' on the specified object.

elif name == "add_timeline_entry":
    if not arguments:
        raise ValueError("Missing arguments")

    payload = {"type": "timeline_comment"}

    id = arguments.get("id")
    if not id:
        raise ValueError("Missing id parameter")
    payload["object"] = id

    timeline_entry = arguments.get("timeline_entry")
    if not timeline_entry:
        raise ValueError("Missing timeline_entry parameter")
    payload["body"] = timeline_entry
    
    timeline_response = make_devrev_request(
        "timeline-entries.create",
        payload
    )
    if timeline_response.status_code != 201:
        error_text = timeline_response.text
        return [
            types.TextContent(
                type="text",
                text=f"Create timeline entry failed with status {timeline_response.status_code}: {error_text}"
            )
        ]
    
    return [
        types.TextContent(
            type="text",
            text=f"Timeline entry created successfully: {timeline_response.json()}"
        )
    ]

DevRev MCP Server