update bundles

Author: jloleysens

oas_docs/output/kibana.serverless.yaml

@@ -3779,10 +3779,42 @@ paths:
           schema:
             default: false
             type: boolean
-      responses: {}
+      responses:
+        '200':
+          content:
+            application/json:
+              examples:
+                listSkillsResponseExample:
+                  description: Example response returning a list of skills
+                  value:
+                    results:
+                      - description: A built-in skill provided by the platform.
+                        experimental: false
+                        id: built-in-skill-id
+                        name: Built-in Skill
+                        readonly: true
+                        referenced_content_count: 0
+                      - description: A user-created skill for data analysis.
+                        experimental: false
+                        id: custom-skill-id
+                        name: Custom Skill
+                        readonly: false
+                        referenced_content_count: 1
+                        tool_ids:
+                          - platform.core.search
+          description: Indicates a successful response
       summary: List skills
       tags:
         - agent builder
+      x-codeSamples:
+        - lang: curl
+          source: |
+            curl \
+              -X GET "https://${KIBANA_URL}/api/agent_builder/skills" \
+              -H "Authorization: ApiKey ${API_KEY}"
+        - lang: Console
+          source: |
+            GET kbn:/api/agent_builder/skills
       x-state: Technical Preview
       x-metaTags:
         - content: Kibana, Elastic Cloud Serverless
@@ -3808,6 +3840,16 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              createSkillRequestExample:
+                description: Example request to create a user-defined skill
+                value:
+                  content: You are an expert data analyst. Use the available tools to query and analyze data.
+                  description: A skill for performing custom data analysis.
+                  id: my-custom-skill
+                  name: Custom Analysis Skill
+                  tool_ids:
+                    - platform.core.search
             schema:
               additionalProperties: false
               type: object
@@ -3857,10 +3899,51 @@ paths:
                 - name
                 - description
                 - content
-      responses: {}
+      responses:
+        '200':
+          content:
+            application/json:
+              examples:
+                createSkillResponseExample:
+                  description: Example response returning the created skill
+                  value:
+                    content: You are an expert data analyst. Use the available tools to query and analyze data.
+                    description: A skill for performing custom data analysis.
+                    experimental: false
+                    id: my-custom-skill
+                    name: Custom Analysis Skill
+                    readonly: false
+                    tool_ids:
+                      - platform.core.search
+          description: Indicates a successful response
       summary: Create a skill
       tags:
         - agent builder
+      x-codeSamples:
+        - lang: curl
+          source: |
+            curl \
+              -X POST "https://${KIBANA_URL}/api/agent_builder/skills" \
+              -H "Authorization: ApiKey ${API_KEY}" \
+              -H "kbn-xsrf: true" \
+              -H "Content-Type: application/json" \
+              -d '{
+                "id": "my-custom-skill",
+                "name": "Custom Analysis Skill",
+                "description": "A skill for performing custom data analysis.",
+                "content": "You are an expert data analyst.",
+                "tool_ids": ["platform.core.search"]
+              }'
+        - lang: Console
+          source: |
+            POST kbn:/api/agent_builder/skills
+            {
+              "id": "my-custom-skill",
+              "name": "Custom Analysis Skill",
+              "description": "A skill for performing custom data analysis.",
+              "content": "You are an expert data analyst.",
+              "tool_ids": ["platform.core.search"]
+            }
       x-state: Technical Preview
       x-metaTags:
         - content: Kibana, Elastic Cloud Serverless
@@ -3945,10 +4028,35 @@ paths:
             maxLength: 512
             minLength: 1
             type: string
-      responses: {}
+      responses:
+        '200':
+          content:
+            application/json:
+              examples:
+                getSkillResponseExample:
+                  description: Example response returning a skill by ID
+                  value:
+                    content: You are an expert data analyst. Use the available tools to query and analyze data.
+                    description: A skill for performing custom data analysis.
+                    experimental: false
+                    id: my-custom-skill
+                    name: Custom Analysis Skill
+                    readonly: false
+                    tool_ids:
+                      - platform.core.search
+          description: Indicates a successful response
       summary: Get a skill by id
       tags:
         - agent builder
+      x-codeSamples:
+        - lang: curl
+          source: |
+            curl \
+              -X GET "https://${KIBANA_URL}/api/agent_builder/skills/{skillId}" \
+              -H "Authorization: ApiKey ${API_KEY}"
+        - lang: Console
+          source: |
+            GET kbn:/api/agent_builder/skills/{skillId}
       x-state: Technical Preview
       x-metaTags:
         - content: Kibana, Elastic Cloud Serverless
@@ -3982,6 +4090,16 @@ paths:
       requestBody:
         content:
           application/json:
+            examples:
+              updateSkillRequestExample:
+                description: Example request to update a user-defined skill
+                value:
+                  content: Updated skill instructions content.
+                  description: Updated description for the skill.
+                  name: Updated Skill Name
+                  tool_ids:
+                    - platform.core.search
+                    - platform.core.execute_esql
             schema:
               additionalProperties: false
               type: object
@@ -4022,10 +4140,46 @@ paths:
                     type: string
                   maxItems: 100
                   type: array
-      responses: {}
+      responses:
+        '200':
+          content:
+            application/json:
+              examples:
+                updateSkillResponseExample:
+                  description: Example response returning the updated skill
+                  value:
+                    content: Updated skill instructions content.
+                    description: Updated description for the skill.
+                    experimental: false
+                    id: my-custom-skill
+                    name: Updated Skill Name
+                    readonly: false
+                    tool_ids:
+                      - platform.core.search
+                      - platform.core.execute_esql
+          description: Indicates a successful response
       summary: Update a skill
       tags:
         - agent builder
+      x-codeSamples:
+        - lang: curl
+          source: |
+            curl \
+              -X PUT "https://${KIBANA_URL}/api/agent_builder/skills/{skillId}" \
+              -H "Authorization: ApiKey ${API_KEY}" \
+              -H "kbn-xsrf: true" \
+              -H "Content-Type: application/json" \
+              -d '{
+                "name": "Updated Skill Name",
+                "description": "Updated description for the skill."
+              }'
+        - lang: Console
+          source: |
+            PUT kbn:/api/agent_builder/skills/{skillId}
+            {
+              "name": "Updated Skill Name",
+              "description": "Updated description for the skill."
+            }
       x-state: Technical Preview
       x-metaTags:
         - content: Kibana, Elastic Cloud Serverless
@@ -77178,6 +77332,7 @@ paths:
                           view: logs.errors-view
                         type: query
                         updated_at: '2025-01-20T14:00:00.000Z'
+          description: A list of all streams.
       summary: Get stream list
       tags:
         - streams
@@ -77214,7 +77369,9 @@ paths:
                   properties: {}
                 - nullable: true
                 - {}
-      responses: {}
+      responses:
+        '200':
+          description: Streams were disabled successfully.
       summary: Disable streams
       tags:
         - streams
@@ -77251,7 +77408,9 @@ paths:
                   properties: {}
                 - nullable: true
                 - {}
-      responses: {}
+      responses:
+        '200':
+          description: Streams were enabled successfully.
       summary: Enable streams
       tags:
         - streams
@@ -77288,7 +77447,9 @@ paths:
                   properties: {}
                 - nullable: true
                 - {}
-      responses: {}
+      responses:
+        '200':
+          description: Streams were resynced successfully.
       summary: Resync streams
       tags:
         - streams