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
- Install the skill in a compatible agent. Public conceptual guidance does not require a Contentful account; live access needs the correct scope.
- Ask “Our editors need a draft preview and our readers need the published page. Which APIs serve those two audiences?”
- 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