Create a locale-based bulk action | Documentation

curl -X POST https://api.contentful.com/spaces/yadj1kx9rmg0/environments/staging/bulk_actions \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/vnd.contentful.management.v1+json" \
     -d '{
  "action": "publish",
  "entities": [
    {
      "entity": {
        "sys": {
          "type": "Link",
          "linkType": "<Entry|Asset>",
          "id": "<entity_id>",
          "version": "10"
        }
      },
      "add": {
        "fields": {
          "*": [
            "en-US"
          ]
        }
      }
    }
  ]
}'

{
  "sys": {
    "id": "<bulk_action_id>",
    "type": "BulkAction",
    "status": "<status>",
    "createdBy": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "7BslKh9TdKGOK41VmLDjFZ"
      }
    },
    "createdAt": "2026-02-26T22:19:00.000Z",
    "updatedAt": "2026-05-11T05:41:00.000Z",
    "space": {
      "sys": {
        "type": "Link",
        "id": "yadj1kx9rmg0"
      }
    },
    "environment": {
      "sys": {
        "type": "Link",
        "id": "staging"
      }
    }
  },
  "action": "publish",
  "payload": {
    "action": "publish",
    "entities": [
      {
        "entity": {
          "sys": {
            "type": "Link",
            "linkType": "<Entry|Asset>",
            "id": "<entity_id>",
            "version": "10"
          }
        },
        "add": {
          "fields": {
            "*": [
              "en-US"
            ]
          }
        }
      }
    ]
  },
  "error": {
    "sys": {
      "id": "<error_type>",
      "type": "Error"
    }
  }
}

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.

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

OK - Request successful