In Strapi v5, how do I create a new document as a draft version through the REST API?

Discord Q&A strapi-questions
1

Or is it really not possible?

At my company, we are currently evaluating the usage of Strapi v5 for a new project. We have a data pipeline set up that gathers different resources and then should create a new document in Strapi. Ideally, this would create a draft version first, as we need some human oversight before publishing.

After reading the docs, looking through the GitHub issues, asking the AI bot, extensive googling and just trying to set the status in my POST request I wasn’t able to find any solution. Is this not supported on purpose? I don’t want to write a plugin to interact with the Document Service API in the backend; this seems to be an important feature to not have.

This topic has been created from a Discord post (1290622243134636083) to give it more visibility.
It will be on Read-Only mode here.
Join the conversation on Discord

2

Good catch

An issue has been opened status:draft not working when creating a document with the Rest API · Issue #21544 · strapi/strapi · GitHub

3

errata corrige: you can save a document as draft passing ?status=draft in the query

4

Thank you so much, that worked! I had read that in the docs here, but somwhow assumed it would apply to GET requests only. Especially because in Create a document localization is specifically mentioned as a body field. Might be helpful to clarify that the params are intended as query params for the POST requests too.

5

Also, small bug: the Create a document link in the REST API docs sidebar uses the wrong hash identifier and so the link doesn’t jump to the correct heading.