> This page is for Platform, version Legacy. > For other versions, use one of these documentation indexes: > - V4 (default): https://next.developer.frame.io/platform/v4/llms.txt > - V4 Experimental: https://next.developer.frame.io/platform/v4-experimental/llms.txt > - Legacy: https://next.developer.frame.io/platform/v2/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://next.developer.frame.io/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://next.developer.frame.io/_mcp/server. # Delete an Asset DELETE https://api.frame.io/v2/assets/{asset_id} Delete the referenced Asset ID Reference: https://next.developer.frame.io/platform/v2/api-reference/assets/delete-asset ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Request ### Path parameters - `asset_id` (string, required) ## Response ### 200 Asset success response - `Asset` ## Errors ### 401 Unauthorized Error Unauthorized response - `code` (integer, optional) - `errors` (list of HttpErrorErrorsItems, optional) - `message` (string, optional) ### 404 Not Found Error Not Found response - `code` (integer, optional) - `errors` (list of HttpErrorErrorsItems, optional) - `message` (string, optional) ## Types ### Asset0 - `` (string, optional) ### HttpErrorErrorsItems - `code` (integer, optional) - `detail` (string, optional) - `status` (integer, optional) - `title` (string, optional) ## Examples **Request** ```json {} ``` **Response** ```json { "account_id": "a3f1c9d2-4b7e-4f3a-9d2e-1b2c3d4e5f6a", "archive_from": "2024-01-15T09:30:00Z", "archive_scheduled_at": "2024-01-15T09:30:00Z", "archive_status": "scheduled", "archived_at": "2024-01-15T09:30:00Z", "asset_type": "document", "bundle": true, "bundle_view": "thumbnail", "cover_asset_id": "b7e3f9a1-2c4d-4e5f-8a9b-0c1d2e3f4a5b", "creator": { "_type": "user", "account_id": "a3f1c9d2-4b7e-4f3a-9d2e-1b2c3d4e5f6a", "avatar_color": "#4A90E2", "digest_frequency": "weekly", "email": "jane.doe@example.com", "first_login_at": "2022-05-15T09:00:00Z", "from_adobe": true, "from_google": true, "highest_account_role": "admin", "id": "user-1234-5678-9012", "image_128": "https://cdn.frame.io/images/users/128/user123.png", "image_256": "https://cdn.frame.io/images/users/256/user123.png", "image_32": "https://cdn.frame.io/images/users/32/user123.png", "image_64": "https://cdn.frame.io/images/users/64/user123.png", "inserted_at": "2022-05-15T09:00:00Z", "integrations": [ "slack", "dropbox" ], "joined_via": "google_oauth", "last_seen": "2024-04-12T16:30:00Z", "mfa_enforced_at": "2023-11-01T12:00:00Z", "name": "Jane Doe", "next_digest_date": "2024-04-17T00:00:00Z", "profile_image": "https://cdn.frame.io/images/users/profile/user123.png", "roles": { "admin": true, "id": "role-5678", "sales": true, "service_desk": true, "support": true }, "timezone_value": "America/Los_Angeles", "updated_at": "2024-04-10T08:45:00Z", "upload_url": "https://upload.frame.io/user123", "user_default_color": "#FF5733", "user_hash": "hash_abc123xyz" }, "frames": 2400, "hard_deleted_at": "2024-02-14T09:30:00Z", "id": "eefb57e0-79f2-4bc7-9b70-99fbc175175c", "index": 1.1, "is_bundle_child": true, "is_hls_required": true, "is_session_watermarked": true, "item_count": 12, "label": "approved", "metadata": { "camera": "RED Komodo", "location": "Los Angeles Studio", "scene": "Interview" }, "metadata_flags": { "id": "d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f7a", "is_360": false, "is_hdr": true, "is_original_player_compatible": true }, "name": "Interview_Session_01.mov", "original": "https://cdn.frame.io/assets/eefb57e0-79f2-4bc7-9b70-99fbc175175c/original.mov", "parent_asset_id": "c1d2e3f4-a5b6-7c8d-9e0f-1a2b3c4d5e6f", "project_id": "f1e2d3c4-b5a6-7890-1234-56789abcdef0", "properties": { "color_grade": "cinematic", "editor": "John Smith" }, "required_transcodes": { "cover": true, "finalized": [ "thumb", "h264_720", "image_high" ], "h264_1080_best": true, "h264_2160": false, "h264_360": true, "h264_540": true, "h264_720": true, "image_full": true, "image_high": true, "page_proxy": true, "thumb": true, "thumb_540": true, "thumb_orig_ar_540": false, "thumb_scrub": true }, "team_id": "team-9876-5432-10ab-cdef12345678", "type": "file", "user_permissions": { "can_download": true, "can_modify_template": false, "can_public_share_presentation": true, "can_public_share_review_link": true, "can_share_downloadable_presentation": true, "can_share_downloadable_review_link": true, "can_share_unwatermarked_presentation": false, "can_share_unwatermarked_review_link": false }, "view_count": 152 } ``` **SDK Code** ```python import requests url = "https://api.frame.io/v2/assets/asset_id" payload = {} headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.delete(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.frame.io/v2/assets/asset_id'; const options = { method: 'DELETE', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.frame.io/v2/assets/asset_id" payload := strings.NewReader("{}") req, _ := http.NewRequest("DELETE", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.frame.io/v2/assets/asset_id") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Delete.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.delete("https://api.frame.io/v2/assets/asset_id") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{}") .asString(); ``` ```php request('DELETE', 'https://api.frame.io/v2/assets/asset_id', [ 'body' => '{}', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.frame.io/v2/assets/asset_id"); var request = new RestRequest(Method.DELETE); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.frame.io/v2/assets/asset_id")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "DELETE" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```