---
title: "Create a CEDAR metadata record for a file"
method: POST
path: "/files/{file_id}/cedar_metadata_records/"
tags: ["CEDAR Metadata"]
---

# Create a CEDAR metadata record for a file

`POST /files/{file_id}/cedar_metadata_records/`

Create a new CEDAR metadata record for the specified file. CEDAR metadata records follow structured templates and can include rich metadata for data sharing and reuse.

## Path parameters

- `file_id` string, required

## Response `201`

Successfully created a new CEDAR metadata record.

## Other responses

- `400` — Validation error or invalid data.
- `401` — Authentication credentials were not provided or are invalid.
- `403` — You do not have permission to create metadata for this file.
- `404` — File not found.
- `405` — Returned if creating CEDAR metadata records for this file has been restricted. The response will include the message "This action is no longer available. Contact support if you have any questions."

## Changes

- **2026-08-20** `3c5164c707eb` — 1 info
  - added the non-success response with the status `405`

[Change history](https://skmtc.dev/osf/apis/osf-apiv2-documentation/changes/files/:file_id/cedar_metadata_records/post.md)

---

[API](https://skmtc.dev/osf/apis/osf-apiv2-documentation.md) · [All operations](https://skmtc.dev/osf/apis/osf-apiv2-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/osf/osf-apiv2-documentation/revisions/3c5164c707eb/schema)