---
title: "POST /v1/projects/{projectOrProductUID}/description/{descriptionName}"
method: POST
path: "/v1/projects/{projectOrProductUID}/description/{descriptionName}"
tags: ["description"]
---

# POST /v1/projects/{projectOrProductUID}/description/{descriptionName}

`POST /v1/projects/{projectOrProductUID}/description/{descriptionName}`

Create or replace a project description record (up to 10MB). The request Content-Type is stored and returned on GET; when omitted it is detected (JSON or text).

## Response `200`

Description record created or updated.

- DescriptionRecord — Metadata for a stored description record. The content itself is returned by GET on the record.
  - `content_type` string, required — The stored content type, either "application/json" or "text/plain; charset=utf-8".
  - `created_at` integer, required — When the record was first created (Unix seconds).
  - `created_by` string — The actor who created the record.
  - `length` integer, required — The content length in bytes.
  - `md5` string, required — The hex-encoded MD5 of the content.
  - `modified_at` integer, required — When the record was last updated (Unix seconds).
  - `modified_by` string — The actor who last updated the record.
  - `name` string, required — The record name (letters, digits, '.', '_' or '-').
  - `owner_uid` string — The owning project (app) UID for project-scoped records; empty for global.
  - `scope` string, required — The ownership scope of the record ("global" or "project").

## Other responses

- `400` — The response body in case of an API error.
- `default` — The response body in case of an API error.

---

[API](https://skmtc.net/notefile/apis/notehub-api.md) · [All operations](https://skmtc.net/notefile/apis/notehub-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notefile/notehub-api/revisions/9c5b2b63a991/schema)