Sorry, no results found for "".
DatoCMS offers a single GraphQL endpoint:
https://graphql.datocms.com/The endpoint remains constant no matter what operation you perform, and it's read only — that is, it does not offer any mutation operation. You can use our Content Management API for that.
To explicitly read data from a specific environment you can add the following header:
X-Environment: <ENVIRONMENT-NAME>If no X-Environment header is provided, the primary environment will be used.
If you have the Draft/Published system active on some of your models, you can add a header to access records at their latest version available, instead of the currently published one. This can be useful on staging environments, or your local development machine:
X-Include-Drafts: truePlease note that this header must be set to true if it's specified at all. If you don't want to see drafts, exclude the header entirely. If you attempt to set X-Include-Drafts:false, you'll get an error:
{ "code": "INVALID_X_INCLUDE_DRAFTS_HEADER", "details": { "message": "X-Include-Drafts header can only be set to `true`" }}If you need to conditionally set this header, you can use a pattern like:
const headers = { 'Authorization': 'Bearer YOUR_API_TOKEN', 'Content-Type': 'application/json', ...(isStagingEnvironment && {'X-Include-Drafts': true})};This will add the header and set it to true if isStagingEnvironment == true. Otherwise, the header will be omitted altogether.
If you want to make sure that no invalid record is ever returned without the need to always specify an _isValid filter in your queries, you can add the following header:
X-Exclude-Invalid: trueIn contrast to the _isValid filter, this header will also have the effect of narrowing down GraphQL types:
Every field with a "Required?" validation enforced, will be associated with a non-nullable GraphQL type (e.g., String becomes String!)
Asset fields (both single and multiple) that have a "Image transformable by imgix" format validation, will have the following properties associated with a non-nullable type: focalPoint, width, height, responsiveImage
Asset fields (both single and multiple) that have a "Video" format validation, will have the following properties associated with a non-nullable type: video
Asset fields (both single and multiple) that have a required alt and/or title validation will have the alt and/or title properties marked as non-null
You can read a little bit more about Strict Mode in our announcement blog post.
When you add/remove validations to a model that already has a set of records created, DatoCMS is forced to launch a new set of checks to verify that these existing records continue to be valid or not.
If you make a GraphQL request with the X-Exclude-Invalid header during this re-validation phase — which depending on the amount of records may take several minutes to complete — the response will be an error, because X-Exclude-Invalid can only return records that are certain to have been properly checked using the latest validation rules available!
For this reason, we strongly suggest using this header in conjunction with migration scripts, so that you can make changes to your validation rules inside a sandbox environment, wait for the validation checks to finish, and only after that promote the sandbox environment as primary. This will avoid potential issues and errors for your final visitors.
To receive the Cache Tags associated with your query, you need to add the following header:
X-Cache-Tags: trueIf you have Content Link available on your project, you must add two headers to signal to DatoCMS Content Delivery API to embed metadata that enable Content Link on websites hosted on Vercel.
X-Visual-Editing: vercel-v1X-Base-Editing-Url: https://<YOUR-PROJECT-NAME>.admin.datocms.comX-Base-Editing-Url can also be used in isolation: it enables the usage of the _editingUrl field in the GraphQL API.