From 4dc776d8c600f4ea602c910114c2bd22c95bb5c2 Mon Sep 17 00:00:00 2001
From: Jan Kuzelik <jan.kuzelik@apify.com>
Date: Fri, 10 Apr 2026 16:35:41 +0200
Subject: [PATCH] docs: add responseFormat and includeUnrunnableActors params
 to store search

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 apify-api/openapi/paths/store/store.yaml | 30 ++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/apify-api/openapi/paths/store/store.yaml b/apify-api/openapi/paths/store/store.yaml
index bffbc04ff8..1738ceec39 100644
--- a/apify-api/openapi/paths/store/store.yaml
+++ b/apify-api/openapi/paths/store/store.yaml
@@ -75,6 +75,36 @@ get:
       schema:
         type: boolean
         example: true
+    - name: responseFormat
+      in: query
+      description: |
+        Controls the shape of the response. Use `full` (default) for the
+        complete response including image URLs and all fields. Use `agent`
+        for a reduced field set optimized for LLM consumers, which only
+        includes `id`, `title`, `name`, `username`, `description`, `notice`,
+        `badge`, `categories`, and minimal `stats`.
+      style: form
+      explode: true
+      schema:
+        type: string
+        enum:
+          - full
+          - agent
+        default: full
+        example: agent
+    - name: includeUnrunnableActors
+      in: query
+      description: |
+        By default, search results exclude Actors that are not safe to run
+        automatically (e.g. Actors from developers who haven't passed KYC, or
+        full-permission Actors without a large user base). Set to `true` to
+        bypass this safety filtering and include all Actors in the results.
+      style: form
+      explode: true
+      schema:
+        type: boolean
+        default: false
+        example: true
   responses:
     "200":
       description: ""