Archive an asset

PUT

https://api.contentful.com/spaces/:space_id/environments/:environment_id/assets/:asset_id/archived

PUT

/spaces/:space_id/environments/:environment_id/assets/:asset_id/archived

$ curl -X PUT https://api.contentful.com/spaces/yadj1kx9rmg0/environments/staging/assets/wtrHxeu3zEoEce2MokCSi/archived \
>      -H "X-Contentful-Version: 15" \
>      -H "Authorization: Bearer <token>"

200Assets_archiveAnAsset_example

1 {
2   "fields": {
3     "title": {
4       "en-US": "Playsam Streamliner"
5     },
6     "file": {
7       "en-US": {
8         "contentType": "image/jpeg",
9         "fileName": "example.jpeg",
10         "upload": "https://example.com/example.jpg"
11       }
12     }
13   },
14   "metadata": {
15     "tags": [
16       {
17         "sys": {
18           "type": "Link",
19           "linkType": "Tag",
20           "id": "nyCampaign"
21         }
22       }
23     ]
24   },
25   "sys": {
26     "id": "wtrHxeu3zEoEce2MokCSi",
27     "type": "Asset",
28     "version": 1,
29     "space": {
30       "sys": {
31         "type": "Link",
32         "linkType": "Space",
33         "id": "yadj1kx9rmg0"
34       }
35     },
36     "environment": {
37       "sys": {
38         "type": "Link",
39         "linkType": "Environment",
40         "id": "staging"
41       }
42     },
43     "createdAt": "2025-11-09T17:24:16.000Z",
44     "createdBy": {
45       "sys": {
46         "type": "Link",
47         "linkType": "User",
48         "id": "7BslKh9TdKGOK41VmLDjFZ"
49       }
50     },
51     "updatedAt": "2025-11-09T17:24:16.000Z",
52     "updatedBy": {
53       "sys": {
54         "type": "Link",
55         "linkType": "User",
56         "id": "4FLrUHftHW3v2BLi9fzfjU"
57       }
58     }
59   }
60 }

Archives an asset, removing it and its CDN files. CDN removal can take up to 48 hours.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

space_idstringRequired

ID of the Space in form of a string

environment_idstringRequired

ID of the environment in form of a string

asset_idstringRequired

ID of the Asset in form of a string

Headers

X-Contentful-VersionstringOptional

Version of the asset to archive

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful