---
title: Logs Archives
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > API Reference > Logs Archives
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Logs Archives

Archives forward all the logs ingested to a cloud storage system.

See the [Archives Page](https://app.datadoghq.com/logs/pipelines/archives) for a list of the archives currently configured in Datadog.

## [Get all archives →](https://docs.datadoghq.com/api/latest/logs-archives/get-all-archives.md){% #get-all-archives %}

| Datadog site      | API endpoint                                                  |
| ----------------- | ------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/logs/config/archives |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/logs/config/archives |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/logs/config/archives      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/logs/config/archives      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/logs/config/archives  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/logs/config/archives |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/logs/config/archives     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/logs/config/archives |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/logs/config/archives |

## [Create an archive →](https://docs.datadoghq.com/api/latest/logs-archives/create-an-archive.md){% #create-an-archive %}

| Datadog site      | API endpoint                                                   |
| ----------------- | -------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/logs/config/archives |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/logs/config/archives |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/logs/config/archives      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/logs/config/archives      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/logs/config/archives  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/logs/config/archives |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/logs/config/archives     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/logs/config/archives |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/logs/config/archives |

## [Get an archive →](https://docs.datadoghq.com/api/latest/logs-archives/get-an-archive.md){% #get-an-archive %}

| Datadog site      | API endpoint                                                               |
| ----------------- | -------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/logs/config/archives/{archive_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/logs/config/archives/{archive_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/logs/config/archives/{archive_id}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/logs/config/archives/{archive_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/logs/config/archives/{archive_id}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/logs/config/archives/{archive_id} |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/logs/config/archives/{archive_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/logs/config/archives/{archive_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/logs/config/archives/{archive_id} |

## [Update an archive →](https://docs.datadoghq.com/api/latest/logs-archives/update-an-archive.md){% #update-an-archive %}

| Datadog site      | API endpoint                                                               |
| ----------------- | -------------------------------------------------------------------------- |
| ap1.datadoghq.com | PUT https://api.ap1.datadoghq.com/api/v2/logs/config/archives/{archive_id} |
| ap2.datadoghq.com | PUT https://api.ap2.datadoghq.com/api/v2/logs/config/archives/{archive_id} |
| app.datadoghq.eu  | PUT https://api.datadoghq.eu/api/v2/logs/config/archives/{archive_id}      |
| app.ddog-gov.com  | PUT https://api.ddog-gov.com/api/v2/logs/config/archives/{archive_id}      |
| us2.ddog-gov.com  | PUT https://api.us2.ddog-gov.com/api/v2/logs/config/archives/{archive_id}  |
| uk1.datadoghq.com | PUT https://api.uk1.datadoghq.com/api/v2/logs/config/archives/{archive_id} |
| app.datadoghq.com | PUT https://api.datadoghq.com/api/v2/logs/config/archives/{archive_id}     |
| us3.datadoghq.com | PUT https://api.us3.datadoghq.com/api/v2/logs/config/archives/{archive_id} |
| us5.datadoghq.com | PUT https://api.us5.datadoghq.com/api/v2/logs/config/archives/{archive_id} |

## [Delete an archive →](https://docs.datadoghq.com/api/latest/logs-archives/delete-an-archive.md){% #delete-an-archive %}

| Datadog site      | API endpoint                                                                  |
| ----------------- | ----------------------------------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/logs/config/archives/{archive_id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/logs/config/archives/{archive_id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/logs/config/archives/{archive_id}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/logs/config/archives/{archive_id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/logs/config/archives/{archive_id}  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/logs/config/archives/{archive_id} |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/logs/config/archives/{archive_id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/logs/config/archives/{archive_id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/logs/config/archives/{archive_id} |

## [List read roles for an archive →](https://docs.datadoghq.com/api/latest/logs-archives/list-read-roles-for-an-archive.md){% #list-read-roles-for-an-archive %}

| Datadog site      | API endpoint                                                                       |
| ----------------- | ---------------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/logs/config/archives/{archive_id}/readers |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/logs/config/archives/{archive_id}/readers |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/logs/config/archives/{archive_id}/readers      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/logs/config/archives/{archive_id}/readers      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/logs/config/archives/{archive_id}/readers  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/logs/config/archives/{archive_id}/readers |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/logs/config/archives/{archive_id}/readers     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/logs/config/archives/{archive_id}/readers |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/logs/config/archives/{archive_id}/readers |

## [Grant role to an archive →](https://docs.datadoghq.com/api/latest/logs-archives/grant-role-to-an-archive.md){% #grant-role-to-an-archive %}

| Datadog site      | API endpoint                                                                        |
| ----------------- | ----------------------------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/logs/config/archives/{archive_id}/readers |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/logs/config/archives/{archive_id}/readers |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/logs/config/archives/{archive_id}/readers      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/logs/config/archives/{archive_id}/readers      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/logs/config/archives/{archive_id}/readers  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/logs/config/archives/{archive_id}/readers |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/logs/config/archives/{archive_id}/readers     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/logs/config/archives/{archive_id}/readers |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/logs/config/archives/{archive_id}/readers |

## [Revoke role from an archive →](https://docs.datadoghq.com/api/latest/logs-archives/revoke-role-from-an-archive.md){% #revoke-role-from-an-archive %}

| Datadog site      | API endpoint                                                                          |
| ----------------- | ------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/logs/config/archives/{archive_id}/readers |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/logs/config/archives/{archive_id}/readers |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/logs/config/archives/{archive_id}/readers      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/logs/config/archives/{archive_id}/readers      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/logs/config/archives/{archive_id}/readers  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/logs/config/archives/{archive_id}/readers |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/logs/config/archives/{archive_id}/readers     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/logs/config/archives/{archive_id}/readers |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/logs/config/archives/{archive_id}/readers |

## [Get archive order →](https://docs.datadoghq.com/api/latest/logs-archives/get-archive-order.md){% #get-archive-order %}

| Datadog site      | API endpoint                                                       |
| ----------------- | ------------------------------------------------------------------ |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/logs/config/archive-order |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/logs/config/archive-order |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/logs/config/archive-order      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/logs/config/archive-order      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/logs/config/archive-order  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/logs/config/archive-order |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/logs/config/archive-order     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/logs/config/archive-order |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/logs/config/archive-order |

## [Update archive order →](https://docs.datadoghq.com/api/latest/logs-archives/update-archive-order.md){% #update-archive-order %}

| Datadog site      | API endpoint                                                       |
| ----------------- | ------------------------------------------------------------------ |
| ap1.datadoghq.com | PUT https://api.ap1.datadoghq.com/api/v2/logs/config/archive-order |
| ap2.datadoghq.com | PUT https://api.ap2.datadoghq.com/api/v2/logs/config/archive-order |
| app.datadoghq.eu  | PUT https://api.datadoghq.eu/api/v2/logs/config/archive-order      |
| app.ddog-gov.com  | PUT https://api.ddog-gov.com/api/v2/logs/config/archive-order      |
| us2.ddog-gov.com  | PUT https://api.us2.ddog-gov.com/api/v2/logs/config/archive-order  |
| uk1.datadoghq.com | PUT https://api.uk1.datadoghq.com/api/v2/logs/config/archive-order |
| app.datadoghq.com | PUT https://api.datadoghq.com/api/v2/logs/config/archive-order     |
| us3.datadoghq.com | PUT https://api.us3.datadoghq.com/api/v2/logs/config/archive-order |
| us5.datadoghq.com | PUT https://api.us5.datadoghq.com/api/v2/logs/config/archive-order |