Create bulk operation export | Documentation

curl -X POST "https://api.contentful.com/spaces/<space_id>/environments/<environment_id>/bulk_operations/entries/export" \
  -H "Authorization: Bearer <cma_token>" \
  -H "Content-Type: application/vnd.contentful.management.v1+json" \
  -d '{
    "query": {
      "content_type": "article",
      "sys.updatedAt[gte]": "2026-01-01T00:00:00Z",
      "select": "sys.id,fields.title"
    }
  }'

{
  "sys": {
    "type": "BulkContentOperation",
    "id": "3JPPci1LiUOeR13oVS7RmB",
    "bulkType": "EntriesExport",
    "status": "in_progress",
    "space": {
      "sys": {
        "type": "Link",
        "linkType": "Space",
        "id": "ncbxgqx5v0xe"
      }
    },
    "environment": {
      "sys": {
        "type": "Link",
        "linkType": "Environment",
        "id": "master"
      }
    },
    "createdBy": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "6Ynia2PFrjsO15piM8eljZ"
      }
    },
    "createdAt": "2026-01-20T10:59:53.963Z",
    "updatedAt": "2026-01-20T10:59:53.963Z"
  },
  "payload": {
    "query": {
      "content_type": "article",
      "sys.updatedAt[gte]": "2026-01-01T00:00:00Z",
      "select": "sys.id,fields.title"
    }
  }
}

Creates an async export operation for entries matching an optional query (max 10,000 entries). Poll the bulk operation endpoint until sys.status is completed, then download from result.files.

Authentication

AuthorizationBearer

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

Path parameters

space_idstringRequired

Alphanumeric id of the space.

environment_idstringRequired

Alphanumeric id of the environment. Defaults to master.

Request

This endpoint expects a map from strings to any.

Response

Created - Bulk export operation created successfully

Errors

403

Forbidden Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

500

Internal Server Error