---
title: "Update an asset"
method: PATCH
path: "/v2/assets/{id}"
tags: ["Assets"]
---

# Update an asset

`PATCH /v2/assets/{id}`

Updates the name or visibility of an asset. With API-key auth the asset must be owned by the key owner; organization-shared assets can only be updated by an admin/owner session.

## Path parameters

- `id` string, required

## Request body

- UpdateAssetDto
  - `name` string
  - `visibility` 'USER' | 'ORGANIZATION'
  - `durationSeconds` number
  - `size` integer
  - `format` string
  - `width` integer
  - `height` integer

## Response `200`

Asset updated successfully

- AssetDto
  - `id` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `deletedAt` string, date-time, nullable, required
  - `name` string, nullable, required
  - `url` string, nullable, required
  - `size` number, nullable, required
  - `format` string, nullable, required
  - `type` 'AUDIO' | 'VIDEO' | 'IMAGE', required
  - `inputType` 'UPLOAD' | 'URL' | 'RECORD' | 'TTS' | 'EXTRACT' | 'DUB' | 'DUB_SOURCE' | 'PLATFORM_IMPORT' | 'PLUGIN_PREMIERE_FILE' | 'PLUGIN_PREMIERE_TIMELINE_SELECTION' | 'PLUGIN_RESOLVE_FILE' | 'PLUGIN_RESOLVE_TIMELINE_SELECTION' | 'null', nullable, required
  - `durationSeconds` number, nullable, required
  - `thumbnailUrl` string, nullable, required
  - `visibility` 'USER' | 'ORGANIZATION', required
  - `userId` string, nullable, required
  - `apiKeyId` string, nullable, required
  - `organizationId` string, required
  - `width` number, nullable, required
  - `height` number, nullable, required
  - `proxyPath` string, nullable
  - `projectId` string, nullable

## Other responses

- `403` — Asset is visible but not writable by the caller (only the owner or an org admin/owner can update it)
- `404` — Asset not found
- `422` — API key has no owner to scope the update

---

[API](https://skmtc.dev/sync/apis/sync-api-v2.md) · [All operations](https://skmtc.dev/sync/apis/sync-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sync/sync-api-v2/revisions/595901a0ee97/schema)