Publish an asset

PUT

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

PUT

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

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

200Assets_publishAnAsset_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     "firstPublishedAt": "2025-02-12T01:49:26.000Z",
27     "publishedCounter": 2,
28     "publishedAt": "2025-02-16T20:29:20.000Z",
29     "publishedBy": {
30       "sys": {
31         "type": "Link",
32         "linkType": "User",
33         "id": "4FLrUHftHW3v2BLi9fzfjU"
34       }
35     },
36     "publishedVersion": 9
37   }
38 }

Publishes an asset, making it available on the CDA and CDN. Image assets become accessible from images.ctfassets.net with Images API query parameter support.

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 publish

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful