Overview
Authentication
JSON Schema
Official clients
We just released a new status page to better communicate downtime and system outages to our customers: http://status.datocms.com
(Yes, it's not in HTTPS.. we're having some problems with Let's Encrypt)
Some of the perks you'll find inside:
A completely renewed UI (which we hope you'll like it);
A better flow to upgrade plan and change billing information;
New project demos (PHP, Rails, Express.JS, React Native);
You can now download not only DatoCMS invoices, but also credit notes;
If users invited to a DatoCMS project erroneously try to login to the Account dashboard, they will be automatically redirected to their project;
We'll soon release the following much needed changes:
Better management of project transfers to a different account (destination accounts will have to manually accept the transfer request);
Ability to completely delete your account;
We silently released v2 of our Content Management API. The major change is how file uploads are now handled:
We no longer have an "Image" and "Image gallery" field. Every existing image field has been converted to a "Single file" field, and every "Image gallery" field has been converted into a "Multiple files" field. We made sure to add a format validation so that only images can be uploaded, so everything should work exactly as before.
When fetching records from the API that contain single/multiple file fields, you will no longer receive the complete "Upload" payload, but just its ID. You can fetch all the info regarding an Upload using the GET /uploads/:id endpoint.
When creating/updating records that contain single/multiple file fields, you no longer have to pass the complete "Upload" payload, but just its ID (or array of IDs, in case it's a "multiple files" field).
We released a new version of all of our clients (JS/Ruby/GatsbyJS/Middleman) to reflect this change, while mantaining the old methods signature.
Despite the big change, we tried not to break sites using our old clients. If no X-Api-Version: 2 header is passed, we assume Version 1 of our API is requested, so the GET /items and GET /items/:id endpoints will keep on returning data in the old format.
Important: Content Management API v1 will be sunsetted on September 1st, and so please upgrade your projects dependencies before this date!