---
title: "Modify a default retention policy."
method: PUT
path: "/{spaceId}/retentionpolicies/{id}"
tags: ["Retention"]
---

# Modify a default retention policy.

`PUT /{spaceId}/retentionpolicies/{id}`

## Request

- Base URL: `https://demo.octopus.app/api`
- URL: `https://demo.octopus.app/api/{spaceId}/retentionpolicies/{id}`
- Auth: one of:
  - API key in header `X-Octopus-ApiKey`
  - API key in query parameter `ApiKey`
  - API key in header `X-NuGet-ApiKey`

## Path parameters

- `spaceId` string, required
- `id` string, required

## Request body

- ModifyDefaultRetentionPolicyCommand
  - `Id` string, required: The id of the default retention policy.
  - `RetentionType` string, required: The type of the default retention policy. ["MachinePackageCache", "LifecycleRetention", "TentacleRetention", "RunbookRetention"]
  - `SpaceId` string, required: The id of the space that contains the default retention policy.

## Response `200`

The response returned from the request to modify a default retention policy.

- SpaceDefaultRetentionPolicyResource
  - `Id` string
  - `Name` string
  - `RetentionType` string
  - `SpaceId` string

## Other responses

- `400`: Bad request. Either the payload was not structurally valid or business rules did not permit the operation.
- `404`: Not found. One or more of the entities involved in the operation was not found.

---

[API](https://skmtc.dev/octopus/apis/octopus-server-api.md) - [All operations](https://skmtc.dev/octopus/apis/octopus-server-api/llms.txt) - [OpenAPI document](https://skmtc.dev/octopus/apis/octopus-server-api/revisions/fe937c07da34?raw)