---
title: "Retrieve Aggregate Deployment Logs"
method: GET
path: "/v2/apps/{app_id}/deployments/{deployment_id}/logs"
tags: ["DigitalOcean-public.v2-new_Apps"]
---

# Retrieve Aggregate Deployment Logs

`GET /v2/apps/{app_id}/deployments/{deployment_id}/logs`

Retrieve the logs of a past, in-progress, or active deployment. If a component name is specified, the logs will be limited to only that component. The response will include links to either real-time logs of an in-progress or active deployment or archived logs of a past deployment.

## Path parameters

- `app_id` string, required
- `deployment_id` string, required

## Query parameters

- `follow` boolean
- `type` 'UNSPECIFIED' | 'BUILD' | 'DEPLOY' | 'RUN' | 'RUN_RESTARTED', required
- `pod_connection_timeout` string

## Response `200`

A JSON object with urls that point to archived logs

- AppsGetLogsResponse
  - `historic_urls` string[]
  - `live_url` string — 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.

## Other responses

- `401` — Authentication failed due to invalid credentials.
- `404` — The resource was not found.
- `429` — The API rate limit has been exceeded.
- `500` — There was a server error.
- `default` — There was an unexpected error.

## Changes

- **2025-10-16** `cb3bf9b21459` — 2 info
  - api tag `DigitalOcean-public.v2-new_Apps` added
  - api tag `Apps` removed
- **2025-07-18** `f8e8c290636c` — 1 info
  - endpoint added
- **2025-07-17** `5fc9af728e82` — 1 breaking
  - api path removed without deprecation
- **2025-07-17** `f8e8c290636c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/digitalocean/apis/digitalocean-api/changes/v2/apps/:app_id/deployments/:deployment_id/logs/get.md)

---

[API](https://skmtc.dev/digitalocean/apis/digitalocean-api.md) · [All operations](https://skmtc.dev/digitalocean/apis/digitalocean-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/digitalocean/digitalocean-api/revisions/cb3bf9b21459/schema)