Get a bulk action

GET

https://api.contentful.com/spaces/:space_id/environments/:environment_id/bulk_actions/actions/:bulk_action_id

GET

/spaces/:space_id/environments/:environment_id/bulk_actions/actions/:bulk_action_id

$ curl https://api.contentful.com/spaces/yadj1kx9rmg0/environments/staging/bulk_actions/actions/%3Cbulk_action_id%3E \
>      -H "Authorization: Bearer <token>"

200Bulk Actions_getABulkAction_example

1 {
2   "sys": {
3     "id": "<bulk_action_id>",
4     "type": "BulkAction",
5     "status": "<status>",
6     "createdBy": {
7       "sys": {
8         "type": "Link",
9         "linkType": "User",
10         "id": "7BslKh9TdKGOK41VmLDjFZ"
11       }
12     },
13     "createdAt": "2025-03-15T09:00:00.000Z",
14     "updatedAt": "2025-03-15T09:00:00.000Z",
15     "space": {
16       "sys": {
17         "type": "Link",
18         "linkType": "Space",
19         "id": "yadj1kx9rmg0"
20       }
21     },
22     "environment": {
23       "sys": {
24         "type": "Link",
25         "linkType": "Environment",
26         "id": "staging"
27       }
28     }
29   },
30   "action": "<action>",
31   "payload": {
32     "entities": {
33       "items": [
34         {
35           "sys": {
36             "id": "<entity_id>",
37             "type": "Link",
38             "linkType": "<Entry|Asset>",
39             "version": 0
40           }
41         }
42       ]
43     }
44   },
45   "error": {
46     "sys": {
47       "id": "<error_type>",
48       "type": "Error"
49     }
50   }
51 }

Returns a bulk action by ID. Records are retained for 7 days.

Authentication

AuthorizationBearer

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

Path parameters

space_idstringRequired

ID of the space as a string

environment_idstringRequired

ID of the environment as a string, falls back to master if not specified.

bulk_action_idstringRequired

ID of the bulk action as a string

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful