# Modify Log Retention Policy

Each log stream in your pipeline is initially assigned a default data retention policy of 30 days. The logs for each log stream are retained for the specified number of days. However, you can define a custom retention policy for each log stream. The available options for retention periods include 7, 14, and 30 days.

{% hint style="info" %}
**Note:** You can alternatively use the `PATCH` request to update the retention policy of an existing pipeline.
{% endhint %}

The following is an example:

```bash
curl --location \
--request POST 'https://logging.de-txl.ionos.com/pipelines' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data '{
          "properties": {
    "name": "demo",
    "logs": [
      {
        "source": "kubernetes",
        "protocol": "http",
        "tag": "k8s",
        "destinations": [
          {
            "type": "loki",
            "retentionInDays": 7
          }
        ]
      }
    ]
  }
}'
```

## Unlimited log retention

To set the retention period for each log stream to **unlimited**, use the following request:

```bash
curl --location \
--request POST 'https://logging.de-txl.ionos.com/pipelines' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $TOKEN' \
--data '{
          "properties": {
    "name": "demo",
    "logs": [
      {
        "source": "kubernetes",
        "protocol": "http",
        "tag": "k8s",
        "destinations": [
          {
            "type": "loki",
            "retentionInDays": 0
          }
        ]
      }
    ]
  }
}'
```

{% hint style="info" %}
**Note:** The retention period is set to **unlimited** when the `retentionInDays` value is set to `0`.
{% endhint %}

### Access to the data

In Grafana, you can only access the data for a maximum of 30 days. To access the archived data (logs with unlimited retention), contact [<mark style="color:blue;">IONOS Cloud Support</mark>](https://docs.ionos.com/cloud/support/general-information/contact-information).

You must provide the following information while requesting access:

* Contract number
* Pipeline ID
* Log stream tag
* The date range for which you need access to the data
* Object Storage bucket information:
  * Name
  * Region
  * Object Storage endpoint

{% hint style="info" %}
**Note:** Ensure that the Object Storage Canonical User ID you receive from IONOS Cloud Support is assigned to the designated bucket. Additionally, confirm that write access has been granted to this specific bucket.
{% endhint %}

After receiving the required information, IONOS Cloud transfers the archived data into the designated Object Storage bucket. Following the successful upload, the data becomes available from within the Object Storage bucket. To add the grantee to your bucket, see the [<mark style="color:blue;">instructions</mark>](https://docs.ionos.com/cloud/backup-and-storage/ionos-object-storage/settings/access-control-list/access-control-list-buckets#dcd).

{% hint style="info" %}
**Note:** Storing logs for an indefinite period will increase storage costs. Our pricing for long-term log storage aligns with our standard [<mark style="color:blue;">Pricing Model</mark>](https://docs.ionos.com/cloud/backup-and-storage/ionos-object-storage/overview/pricing).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ionos.com/cloud/observability/logging-service/api-how-tos/modify-log-retention-policy.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.