From 8a9a25ea43c27381a6aad9bd51d576d434d3fa5a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Julien=20Fastr=C3=A9?= <julien.fastre@champs-libres.coop>
Date: Mon, 23 Feb 2026 12:47:29 +0100
Subject: [PATCH] Add documentation for "is-ready" endpoint to check stored
 object status

- Introduced `/1.0/doc-store/stored-object/{uuid}/is-ready` endpoint to retrieve the status of a stored object.
- Added path parameter for `uuid` and returned `status` property with `empty`, `ready`, `pending`, or `failure` states.
---
 .../ChillDocStoreBundle/chill.api.specs.yaml  | 32 +++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/src/Bundle/ChillDocStoreBundle/chill.api.specs.yaml b/src/Bundle/ChillDocStoreBundle/chill.api.specs.yaml
index 8570116aa..cdca3cf93 100644
--- a/src/Bundle/ChillDocStoreBundle/chill.api.specs.yaml
+++ b/src/Bundle/ChillDocStoreBundle/chill.api.specs.yaml
@@ -54,6 +54,38 @@ paths:
                 422:
                     description: "Invalid data"
 
+    /1.0/doc-store/stored-object/{uuid}/is-ready:
+        get:
+            tags:
+                - storedobject
+            summary: Get the status of a stored object
+            parameters:
+                -   in: path
+                    name: uuid
+                    required: true
+                    allowEmptyValue: false
+                    description: The UUID of the storedObject
+                    schema:
+                        type: string
+                        format: uuid
+            responses:
+                200:
+                    description: "OK"
+                    content:
+                        application/json:
+                            schema:
+                                type: object
+                                properties:
+                                    id:
+                                        type: integer
+                                    filename:
+                                        type: string
+                                    status:
+                                        type: string
+                                        enum: [empty, ready, pending, failure]
+                                    type:
+                                        type: string
+
     /1.0/doc-store/async-upload/temp_url/{uuid}/generate/post:
         get:
             tags: