v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB
DigitalOcean-public.v2-new_Apps

Retrieve Active Deployment Logs

Retrieve the logs of the active deployment if one exists. The response will include links to either real-time logs of an in-progress or active deployment or archived logs of a past deployment. Note log_type=BUILD logs will return logs associated with the current active deployment (being served). To view build logs associated with in-progress build, the query must explicitly reference the deployment id.

get/v2/apps/{app_id}/components/{component_name}/logs

Path parameters

app_idstring required

The app ID

component_namestring required

An optional component name. If set, logs will be limited to this component only.

Query parameters

followboolean

Whether the logs should follow live updates.

type'UNSPECIFIED' | 'BUILD' | 'DEPLOY' | 'RUN' | 'RUN_RESTARTED' required

The type of logs to retrieve

  • BUILD: Build-time logs
  • DEPLOY: Deploy-time logs
  • RUN: Live run-time logs
  • RUN_RESTARTED: Logs of crashed/restarted instances during runtime
pod_connection_timeoutstring

An optional time duration to wait if the underlying component instance is not immediately available. Default: 3m.

Response

A JSON object with urls that point to archived logs

historic_urlsstring[]
live_urlstring

A URL of the real-time live logs. This URL may use either the https:// or wss:// protocols and will keep pushing live logs as they become available.

Example response

{
  "historic_urls": [
    "https://logs/build.log"
  ],
  "live_url": "ws://logs/build"
}