Update an asset

PUT

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

PUT

/spaces/:space_id/environments/:environment_id/releases/:release_id/assets/:asset_id

$ curl -X PUT https://api.contentful.com/spaces/yadj1kx9rmg0/environments/staging/releases/black-friday-1pQyHCh6c6Ic2qFzXzAWmW/assets/wtrHxeu3zEoEce2MokCSi \
>      -H "X-Contentful-Version: 1" \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/vnd.contentful.management.v1+json" \
>      -d '{
>   "fields": {
>     "title": {
>       "en-US": "Playsam Streamliner"
>     },
>     "file": {
>       "en-US": {
>         "contentType": "image/jpeg",
>         "fileName": "example.jpeg",
>         "upload": "https://example.com/example.jpg"
>       }
>     }
>   },
>   "metadata": {
>     "tags": [
>       {
>         "sys": {
>           "type": "Link",
>           "linkType": "Tag",
>           "id": "nyCampaign"
>         }
>       }
>     ]
>   }
> }'

201Timeline assets_updateAnAsset_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     "release": {
29       "sys": {
30         "type": "Link",
31         "linkType": "Release",
32         "id": "black"
33       }
34     },
35     "version": 1,
36     "space": {
37       "sys": {
38         "type": "Link",
39         "linkType": "Space",
40         "id": "yadj1kx9rmg0"
41       }
42     },
43     "environment": {
44       "sys": {
45         "type": "Link",
46         "linkType": "Environment",
47         "id": "staging"
48       }
49     },
50     "createdAt": "2025-07-09T17:47:29.000Z",
51     "createdBy": {
52       "sys": {
53         "type": "Link",
54         "linkType": "User",
55         "id": "7BslKh9TdKGOK41VmLDjFZ"
56       }
57     },
58     "updatedAt": "2025-07-09T17:47:29.000Z",
59     "updatedBy": {
60       "sys": {
61         "type": "Link",
62         "linkType": "User",
63         "id": "4FLrUHftHW3v2BLi9fzfjU"
64       }
65     }
66   }
67 }

Creates a new asset with the specified ID or updates an existing one within the release. Include the current version in X-Contentful-Version when updating.

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

release_idstringRequired

ID of the release 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 update

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

Created - Resource created successfully