Content Management API | Documentation

Contentful’s Content Management API (CMA) helps you manage content in your spaces. To learn more about how to model your content, read our modeling guide.

You can use the CMA to deliver and manage content, but you shouldn’t use it to deliver large amounts of content and instead use the Content Delivery API. The structure of responses from the CMA differs from the CDA as GET responses retrieve the entirety of items (i.e. all localized and unpublished content).

For EU data residency customers, the Base URL is https://api.eu.contentful.com.

Authentication

You access the API securely via HTTPS, and it will be available to clients authenticating with an access token.

Learn about authenticating to the CMA and get your access token from the developer center.

Resource IDs

When creating resources, you can specify an ID or let the API generate a random ID for you. If you choose an ID yourself it must adhere to the following rules:

It has a length between 1 and 64 characters.
It only includes alphanumeric characters, dots ., hyphens - or underscores _.

Represented as a regular expression, this is /^[a-zA-Z0-9-_.]{1,64}$/.

Spaces

Spaces are containers for content types and content, and API clients can fetch data from one or more spaces. You can be a member of multiple organizations, and owner and admin roles in the organization can create spaces in organizations.

When you sign up to Contentul for the first time, you create a new organization. When you’re invited to an existing organization, you become a member of that organization.

If you have a single organization, any space you create will be automatically associated with that organization. If you’re an admin or an owner in multiple organizations you need to pass the ID of the organization with the X-Contentful-Organization header that you want to create the space in.

If you are on our latest pricing model and have plans attached to your spaces, creating a new space via the API will assign the smallest available plan to it. If you’ve reached your limit of free spaces and have no payment details on file, you won’t be able to create more spaces until you add payment details.