---
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.

---

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