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

# Retrieve Active Deployment Aggregate Logs

`GET /v2/apps/{app_id}/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.

## Path parameters

- `app_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)