All products

Choose Contentful APIs with AI

Match the content task to the appropriate API or guide, whether the reader needs a published article, an editorial preview or a management operation.

Editors and developers can choose Contentful APIs with AI by starting with the version of the content a person should see. The contentful-guide skill explains the platform’s vocabulary and routes a concrete need towards delivery, preview, management, GraphQL or image handling.

Picture a magazine preparing its next issue. A public article page needs the published entry, while an editor reviewing a draft needs access to unpublished changes. Separating those tasks early helps the team avoid requesting overly broad credentials for the public site.

What it does

  • Explain how a content type differs from an entry or asset.
  • Identify the right route for previewing unpublished content.
  • Distinguish read-only delivery from a write to the content model.
  • Decide when a specific GraphQL response shape would be helpful.
  • Find the appropriate guidance for image transformations or environment aliases.

Install and use

  1. Install the skill in a compatible agent. Public conceptual guidance does not require a Contentful account; live access needs the correct scope.
  2. Ask “Our editors need a draft preview and our readers need the published page. Which APIs serve those two audiences?”
  3. Review the proposed route with the team before moving on to implementation or credentials.

FAQ

Source

Made by Contentful. Original skill: contentful-guide, published on GitHub under the MIT licence.

View on GitHub