---
title: "Patch a content instance"
method: PATCH
path: "/v0/enterprise/{enterprise_id}/content/{content_id}/"
tags: ["esper_cloud_api_Content"]
---

# Patch a content instance

`PATCH /v0/enterprise/{enterprise_id}/content/{content_id}/`

Partially updates the metadata of an existing content item in the enterprise's Content Management library. Only tags and description can be updated — the file itself and its core properties (filename, size, MIME type, path) cannot be modified through this endpoint.

Request body fields (all optional)

Replaces the existing tag array with the new set of tag strings provided
Updates the human-readable description for the content item

**Common Use Cases**

Adding or correcting tags to improve discoverability via the search parameter on GET /v0/enterprise/{enterprise_id}/content/
Updating a description to reflect a file's current purpose after it has changed
Retroactively tagging content that was uploaded without tags

**Best Practices**

Tags is a full replacement, not an append — if you want to add a tag while preserving existing ones, retrieve the current tags first via GET /v0/enterprise/{enterprise_id}/content/{content_id}/ and include them all in the patch body
This endpoint cannot be used to replace or rename the file itself — upload a new file via POST /v0/enterprise/{enterprise_id}/content/upload/ and delete the old one if the file content needs to change
Apply consistent, descriptive tags across your library to make content searchable and auditable

## Path parameters

- `content_id` string, uuid, required
- `enterprise_id` string, required

## Response `200`

successful operation

- EsperCloudApiContent
  - `id` integer, required — Unique content Identifier
  - `download_url` string, url — URL to download the content
  - `name` string — Name of the content
  - `key` string
  - `is_dir` boolean
  - `kind` string, nullable — The mime type of the content
  - `hash` string — Hash string of the content
  - `size` string — Size of the content in bytes
  - `path` string — Path to the content
  - `permissions` string — The permssion string for the content
  - `tags` string[] — Tags for the content
  - `description` string, nullable — Description for the content
  - `created` string, date-time
  - `modified` string, date-time
  - `enterprise` string, url — URL of the enterprise resource
  - `owner` object — Owner of the content
    - `id` integer
    - `username` string

## Other responses

- `400` — Bad request
- `401` — Authorization information is missing or invalid.
- `403` — Forbidden, no permission to perform this action.
- `404` — Not Found.
- `415` — Unsupported media type.
- `500` — Internal server error

---

[API](https://skmtc.net/esper/apis/esper-api-reference.md) · [All operations](https://skmtc.net/esper/apis/esper-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/esper/esper-api-reference/versions/e1f64cbb488e/schema)