---
title: "Updates an AIP descriptive metadata"
method: PUT
path: "/api/v2/aips/{id}/metadata/descriptive"
tags: ["v2 aips"]
---

# Updates an AIP descriptive metadata

`PUT /api/v2/aips/{id}/metadata/descriptive`

## Path parameters

- `id` string, required

## Request body

- CreateDescriptiveMetadataRequest
  - `id` string
  - `filename` string
  - `type` string
  - `version` string
  - `similar` boolean
  - `permissions` Permissions
    - `users` object
    - `groups` object
  - `values` MetadataValue[]
    - `id` string
    - `options` object
  - `xml` string
  - `@type` string, required

## Response `200`

Descriptive metadata updated

- DescriptiveMetadata
  - `id` string
  - `aipId` string
  - `representationId` string
  - `type` string
  - `version` string

## Other responses

- `401` — Unauthorized access
- `403` — Forbidden
- `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)