HTTP Conventions

curl -X PUT https://api.contentful.com/spaces/{space_id}/environments/{env_id}/entries/{entry_id} \
  -H "Authorization: Bearer {cma_token}" \
  -H "Content-Type: application/vnd.contentful.management.v1+json" \
  -H "X-Contentful-Version: {version}"

curl https://cdn.contentful.com/spaces/{space_id}/environments/{env_id}/entries \
  -H "Authorization: Bearer {cda_token}"

# 1. Get entry (note the version in sys.version)
curl https://api.contentful.com/spaces/{space_id}/environments/master/entries/{entry_id} \
  -H "Authorization: Bearer {cma_token}"
# Response: { "sys": { "version": 5, ... }, "fields": { ... } }

# 2. Update with version header — include ALL fields you want to keep
curl -X PUT https://api.contentful.com/spaces/{space_id}/environments/master/entries/{entry_id} \
  -H "Authorization: Bearer {cma_token}" \
  -H "Content-Type: application/vnd.contentful.management.v1+json" \
  -H "X-Contentful-Version: 5" \
  -d '{"fields":{"title":{"en-US":"Updated Title"},"body":{"en-US":"Existing body"}}}'
# NOTE: CMA PUT replaces the entire `fields` object. Omitted fields are removed.

# When rate limited, check Retry-After or X-Contentful-RateLimit-Reset header
# HTTP/1.1 429 Too Many Requests
# X-Contentful-RateLimit-Reset: 1

{
  "sys": { "type": "Array" },
  "total": 250,
  "skip": 0,
  "limit": 100,
  "items": [ ... ]
}

# Page 1
curl "https://cdn.contentful.com/spaces/{space_id}/environments/master/entries?limit=100&skip=0" \
  -H "Authorization: Bearer {cda_token}"

# Page 2
curl "https://cdn.contentful.com/spaces/{space_id}/environments/master/entries?limit=100&skip=100" \
  -H "Authorization: Bearer {cda_token}"

# Continue until items.length < limit or skip >= total

{
  "sys": {
    "type": "Error",
    "id": "NotFound"
  },
  "message": "The resource could not be found.",
  "details": { ... },
  "requestId": "abc123"
}

# 1. GET the entry to get current version
# 2. Update with the correct X-Contentful-Version
# 3. If 409 again, repeat from step 1

{
  "sys": { "type": "Error", "id": "ValidationFailed" },
  "message": "Validation error",
  "details": {
    "errors": [
      {
        "name": "required",
        "path": ["fields", "title", "en-US"],
        "details": "The property \"title\" is required."
      }
    ]
  }
}

{
  "fields": {
    "title": {
      "en-US": "English Title",
      "de-DE": "German Title"
    },
    "body": {
      "en-US": "English content"
    }
  }
}

{
  "fields": {
    "title": "English Title",
    "body": "English content"
  }
}

{
  "sys": {
    "type": "Link",
    "linkType": "Entry",
    "id": "referenced-entry-id"
  }
}

{
  "fields": {
    "author": {
      "en-US": {
        "sys": { "type": "Link", "linkType": "Entry", "id": "author-id" }
      }
    },
    "gallery": {
      "en-US": [
        { "sys": { "type": "Link", "linkType": "Asset", "id": "image-1" } },
        { "sys": { "type": "Link", "linkType": "Asset", "id": "image-2" } }
      ]
    }
  }
}