Give Feedback

pydo.apps.list_events()

Generated on 3 Aug 2026 from pydo version v0.40.0

Copy page as Markdown View page as Markdown

Usage

client.apps.list_events(
    app_id="4f6c71e2-1e90-4762-9fee-6cc4a0a9f2cf",
    page=1,
    per_page=20,
    event_types=None,
)

Returns JSONRaises HttpResponseError

Description

List all events for an app, including deployments and autoscaling events.

Parameters

app_id string required

The app ID

page integer optional

Which 'page' of paginated results to return.

Min: 1

Default: 1

per_page integer optional

Number of items returned per page

Min: 1

Max: 200

Default: 20

event_types array of strings optional

Filter events by event type.

Request Sample

Show Request Sample

import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

get_resp = client.apps.list_events(app_id="4f6c71e2")

Pagination

This method returns paginated results. The response includes a links.pages object with URLs for navigating between pages. To retrieve the next page, parse the next URL and pass the page parameter:

from urllib.parse import urlparse, parse_qs

resp = client.apps.list_events(app_id="4f6c71e2-1e90-4762-9fee-6cc4a0a9f2cf", )
pages = resp.get("links", {}).get("pages", {})

while "next" in pages:
    parsed = urlparse(pages["next"])
    page = int(parse_qs(parsed.query)["page"][0])
    resp = client.apps.list_events(app_id="4f6c71e2-1e90-4762-9fee-6cc4a0a9f2cf", page=page)
    pages = resp.get("links", {}).get("pages", {})

Response Example

Show Response Example

{
  "events": [],
  "links": {
    "pages": {
      "pages": {
        "first": "https://api.digitalocean.com/v2/account/keys?page=1",
        "prev": "https://api.digitalocean.com/v2/account/keys?page=2"
      }
    }
  }
}

More Information

See /v2/apps/{app_id}/events in the API reference for additional detail on responses, headers, parameters, and more.