{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"To list alert instances for your account, send a GET request to\n`/v2/insights/alert-instances`. Alert instances are read-only records of\nalert rule firings against your resources.\n\nResults can optionally be filtered by `status`, `rule_id`, or\n`resource_urn`.\n\nResults are ordered by `triggered_at` descending (newest first). Because\nthe list is append-only and continuously growing, offset-based pagination\nis best-effort: newly triggered instances may shift older rows onto\nsubsequent pages between fetches. For stable pagination, filter by\n`rule_id` or a fixed time window on the client side.\n","properties":{"query":{"type":"object","properties":{"per_page":{"type":"integer","minimum":1,"default":20,"maximum":200,"examples":[2],"description":"Number of items returned per page"},"page":{"type":"integer","minimum":1,"default":1,"examples":[1],"description":"Which 'page' of paginated results to return."},"status":{"type":"string","enum":["active","resolved"],"examples":["active"],"description":"Optional filter. When set, only alert instances with this status are\nreturned.\n"},"rule_id":{"type":"string","format":"uuid","examples":["8f3a2b1c-4d5e-6f7a-8b9c-0d1e2f3a4b5c"],"description":"Optional filter. When set, only alert instances fired by the alert rule\nwith this ID are returned.\n"},"resource_urn":{"type":"string","examples":["do:droplet:12345"],"description":"Optional filter. When set, only resources associated with this resource URN\nare returned.\n"}},"required":[],"additionalProperties":false}},"required":[],"additionalProperties":false},"name":"List Alert Instances","id":"digitalocean.insights_list_alertinstances","example":{},"maxRequests":1,"summary":false}}