Update a scheduled action

PUT

https://api.contentful.com/spaces/:space_id/scheduled_actions/:scheduled_action_id

PUT

/spaces/:space_id/scheduled_actions/:scheduled_action_id

$ curl -X PUT https://api.contentful.com/spaces/yadj1kx9rmg0/scheduled_actions/3A13SXSDwO8c46NrjigFYT \
>      -H "X-Contentful-Version: 1" \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/vnd.contentful.management.v1+json" \
>      -d '{
>   "entity": {
>     "sys": {
>       "type": "Link",
>       "linkType": "Entry",
>       "id": "5KsDBWseXY6QegucYAoacS"
>     }
>   },
>   "environment": {
>     "sys": {
>       "type": "Link",
>       "linkType": "Environment",
>       "id": "staging"
>     }
>   },
>   "scheduledFor": {
>     "datetime": "2022-01-01T12:00:00.000Z",
>     "timezone": "Europe/Berlin"
>   },
>   "action": "publish"
> }'

200Scheduled Actions_updateAScheduledAction_example

1 {
2   "entity": {
3     "sys": {
4       "type": "Link",
5       "linkType": "Entry",
6       "id": "5KsDBWseXY6QegucYAoacS"
7     }
8   },
9   "environment": {
10     "sys": {
11       "type": "Link",
12       "linkType": "Environment",
13       "id": "staging"
14     }
15   },
16   "scheduledFor": {
17     "datetime": "2022-01-01T12:00:00.000Z",
18     "timezone": "Europe/Berlin"
19   },
20   "action": "publish",
21   "sys": {
22     "createdAt": "2025-06-08T15:40:02.000Z",
23     "createdBy": {
24       "sys": {
25         "type": "Link",
26         "linkType": "User",
27         "id": "7BslKh9TdKGOK41VmLDjFZ"
28       }
29     },
30     "id": "3A13SXSDwO8c46NrjigFYT",
31     "space": {
32       "sys": {
33         "type": "Link",
34         "id": "yadj1kx9rmg0"
35       }
36     },
37     "status": "scheduled",
38     "type": "ScheduledAction",
39     "updatedAt": "2025-08-17T16:14:30.000Z",
40     "updatedBy": {
41       "sys": {
42         "type": "Link",
43         "linkType": "User",
44         "id": "7BslKh9TdKGOK41VmLDjFZ"
45       }
46     },
47     "version": 2
48   }
49 }

Updates the scheduledFor.datetime or scheduledFor.timezone of a scheduled action. Only fields under scheduledFor can be changed; include X-Contentful-Version.

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

scheduled_action_idstringRequired

ID of the scheduled action in form of a string

Headers

X-Contentful-VersionstringRequired

Version of the scheduled action to update

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful