---
title: "Update disposal schedule"
method: PUT
path: "/api/v2/disposal/schedules"
tags: ["v2 disposal schedules"]
---

# Update disposal schedule

`PUT /api/v2/disposal/schedules`

Update existing disposal schedule

## Request body

- DisposalSchedule
  - `id` string
  - `title` string
  - `description` string
  - `mandate` string
  - `scopeNotes` string
  - `actionCode` 'RETAIN_PERMANENTLY' | 'REVIEW' | 'DESTROY'
  - `retentionTriggerElementId` string
  - `retentionPeriodIntervalCode` 'NO_RETENTION_PERIOD' | 'DAYS' | 'WEEKS' | 'MONTHS' | 'YEARS'
  - `retentionPeriodDuration` integer
  - `firstTimeUsed` string, date-time
  - `apiCounter` integer
  - `createdOn` string, date-time
  - `createdBy` string
  - `updatedOn` string, date-time
  - `updatedBy` string
  - `state` 'ACTIVE' | 'INACTIVE'

## Response `200`

Disposal schedule updated

- DisposalSchedule
  - `id` string
  - `title` string
  - `description` string
  - `mandate` string
  - `scopeNotes` string
  - `actionCode` 'RETAIN_PERMANENTLY' | 'REVIEW' | 'DESTROY'
  - `retentionTriggerElementId` string
  - `retentionPeriodIntervalCode` 'NO_RETENTION_PERIOD' | 'DAYS' | 'WEEKS' | 'MONTHS' | 'YEARS'
  - `retentionPeriodDuration` integer
  - `firstTimeUsed` string, date-time
  - `apiCounter` integer
  - `createdOn` string, date-time
  - `createdBy` string
  - `updatedOn` string, date-time
  - `updatedBy` string
  - `state` 'ACTIVE' | 'INACTIVE'

## Other responses

- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/keeps/apis/roda-rest-api.md) · [All operations](https://skmtc.net/keeps/apis/roda-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keeps/roda-rest-api/revisions/afc3c5bcc0d9/schema)