{"id":"list_annotations","name":"List Annotations","alias":"ListAnnotations","aliases":[],"description_short":"Retrieve annotations logged on your project.","description_long":"Retrieve annotations logged on your project.","description_tool_prompt":"List chart annotations on the current project: dated notes and markers on Botify time-series charts (site changes, campaigns, releases, commercial events, incidents). Use when correlating traffic or ranking shifts with known timeline events, or when the user asks what was logged on specific dates.","source":"Botify","conversation_examples":["Show me my annotations","List all annotations from the last 6 months"],"tags":["web search"],"available_in_chat":true,"available_in_deepthink":true,"available_in_mcp":true,"mcp_audience":"all","config":{"type":"object","properties":{},"required":[]},"item":{"type":"object","properties":{"period_start":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Optional inclusive start of the period filter (ISO date, e.g. 2024-01-01). Annotations whose start_date falls within this period are returned.","title":"Period Start"},"period_end":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Optional inclusive end of the period filter (ISO date, e.g. 2024-12-31). Annotations whose start_date falls within this period are returned.","title":"Period End"}},"required":[]},"response":{"$defs":{"ChartAnnotation":{"description":"Project chart annotation with only the fields exposed by the agent.","properties":{"start_date":{"description":"Annotation start date and time","format":"date-time","title":"Start Date","type":"string"},"data":{"anyOf":[{"$ref":"#/$defs/ChartAnnotationData"},{"type":"null"}],"default":null,"description":"Annotation payload (typically includes content text)"}},"required":["start_date"],"title":"ChartAnnotation","type":"object"},"ChartAnnotationData":{"additionalProperties":true,"properties":{"content":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Content"}},"title":"ChartAnnotationData","type":"object"}},"properties":{"annotations":{"description":"Project chart annotations for the project","items":{"$ref":"#/$defs/ChartAnnotation"},"title":"Annotations","type":"array"},"count":{"description":"Number of annotations returned after filtering","title":"Count","type":"integer"},"total_count":{"description":"Total number of annotations on the project before filtering","title":"Total Count","type":"integer"}},"required":["annotations","count","total_count"],"title":"ListAnnotationsProcessedItem","type":"object"},"has_canvas":false,"open_canvas_automatically":false}