> **contentful-api** — chapter 3 of 9 in [contentful/skills](https://skillsdocs.com/contentful/skills).
>
> Book (all chapters, one file): https://skillsdocs.com/contentful/skills.md
> Machine manifest: https://skillsdocs.com/contentful/skills/.well-known/agent-skills/index.json
> Install the book: `npx skills add contentful/skills`
> Upstream: https://github.com/contentful/skills/blob/main/skills/contentful-api/SKILL.md @ `main`
> Raw bytes, no header: https://raw.githubusercontent.com/contentful/skills/main/skills/contentful-api/SKILL.md
> Base for relative paths: https://raw.githubusercontent.com/contentful/skills/main/skills/contentful-api/
> Licence: MIT — https://spdx.org/licenses/MIT.html
>
> Bundled files (17), referenced from this skill's directory:
>   - `package.json` — https://raw.githubusercontent.com/contentful/skills/main/skills/contentful-api/package.json
>   - `references/authentication.md` — https://raw.githubusercontent.com/contentful/skills/main/skills/contentful-api/references/authentication.md
>   - `references/content-delivery/includes-links.md` — https://raw.githubusercontent.com/contentful/skills/main/skills/contentful-api/references/content-delivery/includes-links.md
>   - `references/content-delivery/localization.md` — https://raw.githubusercontent.com/contentful/skills/main/skills/contentful-api/references/content-delivery/localization.md
>   - `references/content-delivery/overview.md` — https://raw.githubusercontent.com/contentful/skills/main/skills/contentful-api/references/content-delivery/overview.md
>   - `references/content-delivery/querying.md` — https://raw.githubusercontent.com/contentful/skills/main/skills/contentful-api/references/content-delivery/querying.md
>   - `references/content-delivery/sync.md` — https://raw.githubusercontent.com/contentful/skills/main/skills/contentful-api/references/content-delivery/sync.md
>   - `references/content-management/assets.md` — https://raw.githubusercontent.com/contentful/skills/main/skills/contentful-api/references/content-management/assets.md
>   - `references/content-management/bulk-actions.md` — https://raw.githubusercontent.com/contentful/skills/main/skills/contentful-api/references/content-management/bulk-actions.md
>   - `references/content-management/content-types.md` — https://raw.githubusercontent.com/contentful/skills/main/skills/contentful-api/references/content-management/content-types.md
>   - `references/content-management/entries.md` — https://raw.githubusercontent.com/contentful/skills/main/skills/contentful-api/references/content-management/entries.md
>   - `references/content-management/environments.md` — https://raw.githubusercontent.com/contentful/skills/main/skills/contentful-api/references/content-management/environments.md
>   - `references/content-management/overview.md` — https://raw.githubusercontent.com/contentful/skills/main/skills/contentful-api/references/content-management/overview.md
>   - `references/content-preview/overview.md` — https://raw.githubusercontent.com/contentful/skills/main/skills/contentful-api/references/content-preview/overview.md
>   - `references/graphql/overview.md` — https://raw.githubusercontent.com/contentful/skills/main/skills/contentful-api/references/graphql/overview.md
>   - `references/http-conventions.md` — https://raw.githubusercontent.com/contentful/skills/main/skills/contentful-api/references/http-conventions.md
>   - `references/images/overview.md` — https://raw.githubusercontent.com/contentful/skills/main/skills/contentful-api/references/images/overview.md
>
> Content © its authors, served unmodified. Takedown: https://github.com/DreambaseAI/skillsdocs/issues/new?labels=takedown&title=Takedown+request

<!-- Verbatim upstream SKILL.md follows, YAML frontmatter included. -->

---
name: contentful-api
description: Comprehensive Contentful REST API guide. Covers Content Management API (CMA) for creating/updating content, Content Delivery API (CDA) for fetching published content, Preview API, Images API, and GraphQL API. All examples use curl/HTTP — language-agnostic.
---

# Contentful REST API Guide

Language-agnostic guide for Contentful APIs using HTTP/curl.

## Shared References

- **[Authentication](references/authentication.md)** — Token types, auth headers, API base URLs (US/EU)
- **[HTTP Conventions](references/http-conventions.md)** — Version locking, rate limits, pagination, errors, locale structure

## Content Management API (CMA)

Read/write API for managing content, content types, assets, and environments.

**Start here**: [references/content-management/overview.md](references/content-management/overview.md)

- [**entries.md**](references/content-management/entries.md) — CRUD, publish/unpublish, versioning, query parameters
- [**content-types.md**](references/content-management/content-types.md) — Define/update content models, field types, validations
- [**assets.md**](references/content-management/assets.md) — Upload, process, publish media files
- [**environments.md**](references/content-management/environments.md) — Create, clone, manage environments and aliases

## Content Delivery API (CDA)

Read-only API for fetching published content.

**Start here**: [references/content-delivery/overview.md](references/content-delivery/overview.md)

- [**querying.md**](references/content-delivery/querying.md) — Filters, search operators, pagination, ordering
- [**includes-links.md**](references/content-delivery/includes-links.md) — Include parameter, link resolution
- [**localization.md**](references/content-delivery/localization.md) — Locale parameter, fallback chains
- [**sync.md**](references/content-delivery/sync.md) — Incremental content synchronization

## Content Preview API

Draft + published content via same CDA endpoints, different host/token.

**Reference**: [references/content-preview/overview.md](references/content-preview/overview.md)

## Images API

On-the-fly image transformations via URL parameters. No authentication needed.

**Reference**: [references/images/overview.md](references/images/overview.md)

## GraphQL API

Query content via GraphQL with CDA tokens.

**Reference**: [references/graphql/overview.md](references/graphql/overview.md)

## Quick Reference

```bash
# CMA: Create a draft entry
curl -X POST https://api.contentful.com/spaces/{space_id}/environments/{env_id}/entries \
  -H "Authorization: Bearer {cma_token}" \
  -H "Content-Type: application/vnd.contentful.management.v1+json" \
  -H "X-Contentful-Content-Type: blogPost" \
  -d '{"fields":{"title":{"en-US":"Hello"}}}'
# Then publish: PUT .../entries/{id}/published with X-Contentful-Version header

# CDA: Fetch entries
curl "https://cdn.contentful.com/spaces/{space_id}/environments/{env_id}/entries?content_type=blogPost" \
  -H "Authorization: Bearer {cda_token}"
```