---
title: "Creates a descriptive metadata under the AIP"
method: POST
path: "/api/v2/aips/{id}/metadata/descriptive"
tags: ["v2 aips"]
---

# Creates a descriptive metadata under the AIP

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

Create AIP descriptive metadata

## 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 `201`

Descriptive metadata created

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

## Other responses

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