runloop-api-client 1.31.0__tar.gz → 1.32.0__tar.gz

runloop_api_client-1.32.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.32.0"
+}

{runloop_api_client-1.31.0 → runloop_api_client-1.32.0}/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## [1.32.0](https://github.com/runloopai/api-client-python/compare/v1.31.0...v1.32.0) (2026-09-08)
+
+
+### Features
+
+* **axon:** accept user metadata at creation ([d2a4242](https://github.com/runloopai/api-client-python/commit/d2a42420be6a0b355a5511eefedc83044d7f11fe))
+* **axon:** add axon metadata update endpoint ([f66ff15](https://github.com/runloopai/api-client-python/commit/f66ff15436bf522020ebc8dd5b891fd21f0081af))
+* **axon:** filter axon lists by metadata and add metadata discovery endpoints ([a8dc212](https://github.com/runloopai/api-client-python/commit/a8dc212b840327a430d7f98f45172fd110f7a9f6))
+* **stlc:** automate SDK generation ([a33c2a4](https://github.com/runloopai/api-client-python/commit/a33c2a470b6701da37a2c9869d9216d67daa0d2a))
+
+
+### Bug Fixes
+
+* **ci:** authenticate SDK back-sync pushes ([#4](https://github.com/runloopai/api-client-python/issues/4)) ([04cae15](https://github.com/runloopai/api-client-python/commit/04cae15abe12cbf205b1d645592a89c9a530752f))
+* **docs:** deploy documentation for releases ([#835](https://github.com/runloopai/api-client-python/issues/835)) ([68023fb](https://github.com/runloopai/api-client-python/commit/68023fb7c86dd5c9d23360fb8f4e680914d99e52))
+
+
+### Chores
+
+* **stlc:** run Promote SDKs on a daily schedule ([582ab9d](https://github.com/runloopai/api-client-python/commit/582ab9d957684efadcf585f3632ec58084232bcc))
+* **stlc:** run Promote SDKs on a daily schedule ([63c6ef1](https://github.com/runloopai/api-client-python/commit/63c6ef146a0ec0ea5cf5487f01e4ae51ca0e2b54))
+
+
+### Documentation
+
+* **readme:** lead with the sandbox category and add package keywords ([#840](https://github.com/runloopai/api-client-python/issues/840)) ([8353d09](https://github.com/runloopai/api-client-python/commit/8353d097d2ae185cf9082f4c59db468a6fcd15c8))
+
 ## [1.31.0](https://github.com/runloopai/api-client-python/compare/v1.30.0...v1.31.0) (2026-08-25)
 
 

{runloop_api_client-1.31.0 → runloop_api_client-1.32.0}/PKG-INFO

@@ -1,12 +1,14 @@
 Metadata-Version: 2.3
 Name: runloop_api_client
-Version: 1.31.0
-Summary: The official Python library for the runloop API
-Project-URL: Homepage, https://github.com/runloopai/api-client-python
+Version: 1.32.0
+Summary: Official Python SDK for Runloop — secure Linux sandboxes (Devboxes) where AI agents run code, edit files, and expose ports
+Project-URL: Homepage, https://runloop.ai
 Project-URL: Repository, https://github.com/runloopai/api-client-python
-Project-URL: Documentation, https://runloopai.github.io/api-client-python/
+Project-URL: Documentation, https://docs.runloop.ai
+Project-URL: API Reference, https://runloopai.github.io/api-client-python/
 Author-email: Runloop <support@runloop.ai>
 License: MIT
+Keywords: agent-runtime,ai-agents,code-execution,code-interpreter,devbox,llm,microvm,runloop,sandbox
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: MacOS
@@ -20,6 +22,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.9
@@ -35,54 +38,75 @@ Requires-Dist: aiohttp; extra == 'aiohttp'
 Requires-Dist: httpx-aiohttp>=0.1.9; extra == 'aiohttp'
 Description-Content-Type: text/markdown
 
-# Runloop Python API library
+# Runloop Python SDK — secure sandboxes for AI agents
 
 <!-- prettier-ignore -->
 [![PyPI version](https://img.shields.io/pypi/v/runloop_api_client.svg?label=pypi%20(stable))](https://pypi.org/project/runloop_api_client/)
 
-The Runloop Python library provides convenient access to the Runloop REST API from any Python 3.9+
-application. The library includes type definitions for all request params and response fields,
-and offers both synchronous and asynchronous clients powered by [httpx](https://github.com/encode/httpx).
+Run AI agents and AI-generated code in **Devboxes**: isolated Linux sandboxes with a shell, a
+filesystem, networking, and optional GPUs. Use this library to create a sandbox, run commands in it,
+read and write files, expose ports over HTTPS, and snapshot the whole machine so you can pause and
+resume it later.
 
-It is generated with [Stainless](https://www.stainless.com/).
+Why teams pick Runloop:
 
-## Documentation
-
-The REST API documentation can be found on
-[runloop.ai](https://runloop.ai). The full API of this library can be found in
-[api.md](https://github.com/runloopai/api-client-python/blob/main/api.md).
+- **Safe by default.** Every devbox is isolated at both the VM and container level, so untrusted
+  agent output never touches your infrastructure.
+- **Built for long-running agents.** Devboxes persist for as long as you need, and snapshots let you
+  suspend, resume, and branch an agent's machine state.
+- **Fast starts.** Blueprints bake your dependencies into a reusable image so agents boot in seconds
+  instead of installing tooling every run.
+- **Ready for production.** Secrets injection, AI gateways, network policies, and VPC deployment are
+  part of the platform.
+- **Measurable.** Built-in benchmarks and evaluations score agent runs so you can tell whether a
+  change actually helped.
 
 ## Installation
 
 ```sh
-# install from PyPI
 pip install runloop_api_client
 ```
 
-## Usage
-
-The full API of this library can be found in [api.md](api.md).
-
-### Object-Oriented SDK
+## Quickstart
 
-For a higher-level, Pythonic interface, check out the new [`RunloopSDK`](README-SDK.md) which layers an object-oriented API on top of the generated client (including synchronous and asynchronous variants).
+Set `RUNLOOP_API_KEY` in your environment ([get a free key](https://runloop.ai) — new accounts start
+with $50 in credits), then:
 
 ```python
 from runloop_api_client import RunloopSDK
 
 runloop = RunloopSDK()  # Uses RUNLOOP_API_KEY environment variable by default
 
-# Create a devbox and execute commands with a clean, object-oriented interface
+# Create a sandbox, run a command in it, and clean it up on exit.
 with runloop.devbox.create(name="my-devbox") as devbox:
-    result = devbox.cmd.exec("echo 'Hello from Runloop!'")
+    devbox.file.write(file_path="main.py", contents="print('hello from a sandbox')")
+    result = devbox.cmd.exec("python main.py")
     print(result.stdout())
 ```
 
-**See the [SDK documentation](README-SDK.md) for complete examples and API reference.**
+**See the [SDK documentation](README-SDK.md) for complete examples and API reference**, and
+[docs.runloop.ai](https://docs.runloop.ai) for platform guides. Agents and LLM tooling can read
+[llms.txt](llms.txt) for a condensed overview of the whole platform.
+
+## Documentation
+
+- [Platform documentation](https://docs.runloop.ai) — devboxes, blueprints, snapshots, tunnels, agents, benchmarks
+- [`RunloopSDK` reference](README-SDK.md) — the high-level, object-oriented Python interface
+- [api.md](https://github.com/runloopai/api-client-python/blob/main/api.md) — the full generated REST surface
+- [examples/](examples) — runnable end-to-end scripts
+- [llms.txt](llms.txt) — condensed platform summary for AI coding agents
+
+## Usage
+
+This library ships two layers: the object-oriented `RunloopSDK` shown above, and the generated REST
+client it is built on. Both have synchronous and asynchronous variants, include type definitions for
+all request params and response fields, and are powered by
+[httpx](https://github.com/encode/httpx). The generated client is produced with
+[Stainless](https://www.stainless.com/).
 
 ### REST API Client
 
-Alternatively, you can use the generated REST API client directly:
+To use the generated REST API client directly:
 
 ```python
 import os

{runloop_api_client-1.31.0 → runloop_api_client-1.32.0}/README.md

@@ -1,51 +1,72 @@
-# Runloop Python API library
+# Runloop Python SDK — secure sandboxes for AI agents
 
 <!-- prettier-ignore -->
 [![PyPI version](https://img.shields.io/pypi/v/runloop_api_client.svg?label=pypi%20(stable))](https://pypi.org/project/runloop_api_client/)
 
-The Runloop Python library provides convenient access to the Runloop REST API from any Python 3.9+
-application. The library includes type definitions for all request params and response fields,
-and offers both synchronous and asynchronous clients powered by [httpx](https://github.com/encode/httpx).
+Run AI agents and AI-generated code in **Devboxes**: isolated Linux sandboxes with a shell, a
+filesystem, networking, and optional GPUs. Use this library to create a sandbox, run commands in it,
+read and write files, expose ports over HTTPS, and snapshot the whole machine so you can pause and
+resume it later.
 
-It is generated with [Stainless](https://www.stainless.com/).
+Why teams pick Runloop:
 
-## Documentation
-
-The REST API documentation can be found on
-[runloop.ai](https://runloop.ai). The full API of this library can be found in
-[api.md](https://github.com/runloopai/api-client-python/blob/main/api.md).
+- **Safe by default.** Every devbox is isolated at both the VM and container level, so untrusted
+  agent output never touches your infrastructure.
+- **Built for long-running agents.** Devboxes persist for as long as you need, and snapshots let you
+  suspend, resume, and branch an agent's machine state.
+- **Fast starts.** Blueprints bake your dependencies into a reusable image so agents boot in seconds
+  instead of installing tooling every run.
+- **Ready for production.** Secrets injection, AI gateways, network policies, and VPC deployment are
+  part of the platform.
+- **Measurable.** Built-in benchmarks and evaluations score agent runs so you can tell whether a
+  change actually helped.
 
 ## Installation
 
 ```sh
-# install from PyPI
 pip install runloop_api_client
 ```
 
-## Usage
-
-The full API of this library can be found in [api.md](api.md).
-
-### Object-Oriented SDK
+## Quickstart
 
-For a higher-level, Pythonic interface, check out the new [`RunloopSDK`](README-SDK.md) which layers an object-oriented API on top of the generated client (including synchronous and asynchronous variants).
+Set `RUNLOOP_API_KEY` in your environment ([get a free key](https://runloop.ai) — new accounts start
+with $50 in credits), then:
 
 ```python
 from runloop_api_client import RunloopSDK
 
 runloop = RunloopSDK()  # Uses RUNLOOP_API_KEY environment variable by default
 
-# Create a devbox and execute commands with a clean, object-oriented interface
+# Create a sandbox, run a command in it, and clean it up on exit.
 with runloop.devbox.create(name="my-devbox") as devbox:
-    result = devbox.cmd.exec("echo 'Hello from Runloop!'")
+    devbox.file.write(file_path="main.py", contents="print('hello from a sandbox')")
+    result = devbox.cmd.exec("python main.py")
     print(result.stdout())
 ```
 
-**See the [SDK documentation](README-SDK.md) for complete examples and API reference.**
+**See the [SDK documentation](README-SDK.md) for complete examples and API reference**, and
+[docs.runloop.ai](https://docs.runloop.ai) for platform guides. Agents and LLM tooling can read
+[llms.txt](llms.txt) for a condensed overview of the whole platform.
+
+## Documentation
+
+- [Platform documentation](https://docs.runloop.ai) — devboxes, blueprints, snapshots, tunnels, agents, benchmarks
+- [`RunloopSDK` reference](README-SDK.md) — the high-level, object-oriented Python interface
+- [api.md](https://github.com/runloopai/api-client-python/blob/main/api.md) — the full generated REST surface
+- [examples/](examples) — runnable end-to-end scripts
+- [llms.txt](llms.txt) — condensed platform summary for AI coding agents
+
+## Usage
+
+This library ships two layers: the object-oriented `RunloopSDK` shown above, and the generated REST
+client it is built on. Both have synchronous and asynchronous variants, include type definitions for
+all request params and response fields, and are powered by
+[httpx](https://github.com/encode/httpx). The generated client is produced with
+[Stainless](https://www.stainless.com/).
 
 ### REST API Client
 
-Alternatively, you can use the generated REST API client directly:
+To use the generated REST API client directly:
 
 ```python
 import os

{runloop_api_client-1.31.0 → runloop_api_client-1.32.0}/api.md

@@ -122,6 +122,7 @@ from runloop_api_client.types import (
     AxonCreateParams,
     AxonEventView,
     AxonListView,
+    AxonUpdateParams,
     AxonView,
     PublishParams,
     PublishResultView,
@@ -132,6 +133,7 @@ Methods:
 
 - <code title="post /v1/axons">client.axons.<a href="./src/runloop_api_client/resources/axons/axons.py">create</a>(\*\*<a href="src/runloop_api_client/types/axon_create_params.py">params</a>) -> <a href="./src/runloop_api_client/types/axon_view.py">AxonView</a></code>
 - <code title="get /v1/axons/{id}">client.axons.<a href="./src/runloop_api_client/resources/axons/axons.py">retrieve</a>(id) -> <a href="./src/runloop_api_client/types/axon_view.py">AxonView</a></code>
+- <code title="post /v1/axons/{id}">client.axons.<a href="./src/runloop_api_client/resources/axons/axons.py">update</a>(id, \*\*<a href="src/runloop_api_client/types/axon_update_params.py">params</a>) -> <a href="./src/runloop_api_client/types/axon_view.py">AxonView</a></code>
 - <code title="get /v1/axons">client.axons.<a href="./src/runloop_api_client/resources/axons/axons.py">list</a>(\*\*<a href="src/runloop_api_client/types/axon_list_params.py">params</a>) -> <a href="./src/runloop_api_client/types/axon_view.py">SyncAxonsCursorIDPage[AxonView]</a></code>
 - <code title="delete /v1/axons/{id}">client.axons.<a href="./src/runloop_api_client/resources/axons/axons.py">delete</a>(id) -> object</code>
 - <code title="post /v1/axons/{id}/publish">client.axons.<a href="./src/runloop_api_client/resources/axons/axons.py">publish</a>(id, \*\*<a href="src/runloop_api_client/types/axon_publish_params.py">params</a>) -> <a href="./src/runloop_api_client/types/publish_result_view.py">PublishResultView</a></code>

{runloop_api_client-1.31.0 → runloop_api_client-1.32.0}/pyproject.toml

@@ -1,8 +1,19 @@
 [project]
 name = "runloop_api_client"
-version = "1.31.0"
-description = "The official Python library for the runloop API"
+version = "1.32.0"
+description = "Official Python SDK for Runloop — secure Linux sandboxes (Devboxes) where AI agents run code, edit files, and expose ports"
 dynamic = ["readme"]
+keywords = [
+  "runloop",
+  "sandbox",
+  "devbox",
+  "ai-agents",
+  "code-execution",
+  "code-interpreter",
+  "agent-runtime",
+  "microvm",
+  "llm",
+]
 license = "MIT"
 authors = [
 { name = "Runloop", email = "support@runloop.ai" },
@@ -34,13 +45,15 @@ classifiers = [
   "Operating System :: POSIX :: Linux",
   "Operating System :: Microsoft :: Windows",
   "Topic :: Software Development :: Libraries :: Python Modules",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
   "License :: OSI Approved :: MIT License"
 ]
 
 [project.urls]
-Homepage = "https://github.com/runloopai/api-client-python"
+Homepage = "https://runloop.ai"
 Repository = "https://github.com/runloopai/api-client-python"
-Documentation = "https://runloopai.github.io/api-client-python/"
+Documentation = "https://docs.runloop.ai"
+"API Reference" = "https://runloopai.github.io/api-client-python/"
 
 [project.optional-dependencies]
 aiohttp = ["aiohttp", "httpx_aiohttp>=0.1.9"]

{runloop_api_client-1.31.0 → runloop_api_client-1.32.0}/src/runloop_api_client/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "runloop_api_client"
-__version__ = "1.31.0"  # x-release-please-version
+__version__ = "1.32.0"  # x-release-please-version

{runloop_api_client-1.31.0 → runloop_api_client-1.32.0}/src/runloop_api_client/resources/axons/axons.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Dict, Optional
 from typing_extensions import Literal
 
 import httpx
@@ -23,7 +23,13 @@ from .events import (
     EventsResourceWithStreamingResponse,
     AsyncEventsResourceWithStreamingResponse,
 )
-from ...types import axon_list_params, axon_create_params, axon_publish_params, axon_subscribe_sse_params
+from ...types import (
+    axon_list_params,
+    axon_create_params,
+    axon_update_params,
+    axon_publish_params,
+    axon_subscribe_sse_params,
+)
 from ..._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
 from ..._utils import path_template, maybe_transform, async_maybe_transform
 from ..._compat import cached_property
@@ -75,6 +81,7 @@ class AxonsResource(SyncAPIResource):
     def create(
         self,
         *,
+        metadata: Optional[Dict[str, str]] | Omit = omit,
         name: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -88,6 +95,8 @@ class AxonsResource(SyncAPIResource):
         [Beta] Create a new axon.
 
         Args:
+          metadata: User defined metadata to attach to the axon for organization.
+
           name: (Optional) Name for the axon.
 
           extra_headers: Send extra headers
@@ -102,7 +111,13 @@ class AxonsResource(SyncAPIResource):
         """
         return self._post(
             "/v1/axons",
-            body=maybe_transform({"name": name}, axon_create_params.AxonCreateParams),
+            body=maybe_transform(
+                {
+                    "metadata": metadata,
+                    "name": name,
+                },
+                axon_create_params.AxonCreateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -146,12 +161,61 @@ class AxonsResource(SyncAPIResource):
             cast_to=AxonView,
         )
 
+    def update(
+        self,
+        id: str,
+        *,
+        metadata: Optional[Dict[str, str]] | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+        idempotency_key: str | None = None,
+    ) -> AxonView:
+        """[Beta] Updates the specified axon fields.
+
+        Omitted fields are left unchanged. An
+        empty metadata map clears the metadata.
+
+        Args:
+          metadata: User defined metadata to replace the axon metadata. Omit or set to null to leave
+              unchanged, or set to an empty map to clear it.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._post(
+            path_template("/v1/axons/{id}", id=id),
+            body=maybe_transform({"metadata": metadata}, axon_update_params.AxonUpdateParams),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
+            ),
+            cast_to=AxonView,
+        )
+
     def list(
         self,
         *,
         id: str | Omit = omit,
         include_total_count: bool | Omit = omit,
         limit: int | Omit = omit,
+        metadata_key: str | Omit = omit,
+        metadata_key_in: str | Omit = omit,
         name: str | Omit = omit,
         search: str | Omit = omit,
         starting_after: str | Omit = omit,
@@ -173,6 +237,11 @@ class AxonsResource(SyncAPIResource):
 
           limit: The limit of items to return. Default is 20. Max is 5000.
 
+          metadata_key: Filter axons by metadata key-value pair. Can be used multiple times for
+              different keys.
+
+          metadata_key_in: Filter axons by metadata key with multiple possible values (OR condition).
+
           name: Filter by axon name (prefix match supported).
 
           search: Search by axon ID or name.
@@ -200,6 +269,8 @@ class AxonsResource(SyncAPIResource):
                         "id": id,
                         "include_total_count": include_total_count,
                         "limit": limit,
+                        "metadata_key": metadata_key,
+                        "metadata_key_in": metadata_key_in,
                         "name": name,
                         "search": search,
                         "starting_after": starting_after,
@@ -390,6 +461,7 @@ class AsyncAxonsResource(AsyncAPIResource):
     async def create(
         self,
         *,
+        metadata: Optional[Dict[str, str]] | Omit = omit,
         name: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -403,6 +475,8 @@ class AsyncAxonsResource(AsyncAPIResource):
         [Beta] Create a new axon.
 
         Args:
+          metadata: User defined metadata to attach to the axon for organization.
+
           name: (Optional) Name for the axon.
 
           extra_headers: Send extra headers
@@ -417,7 +491,13 @@ class AsyncAxonsResource(AsyncAPIResource):
         """
         return await self._post(
             "/v1/axons",
-            body=await async_maybe_transform({"name": name}, axon_create_params.AxonCreateParams),
+            body=await async_maybe_transform(
+                {
+                    "metadata": metadata,
+                    "name": name,
+                },
+                axon_create_params.AxonCreateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -461,12 +541,61 @@ class AsyncAxonsResource(AsyncAPIResource):
             cast_to=AxonView,
         )
 
+    async def update(
+        self,
+        id: str,
+        *,
+        metadata: Optional[Dict[str, str]] | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+        idempotency_key: str | None = None,
+    ) -> AxonView:
+        """[Beta] Updates the specified axon fields.
+
+        Omitted fields are left unchanged. An
+        empty metadata map clears the metadata.
+
+        Args:
+          metadata: User defined metadata to replace the axon metadata. Omit or set to null to leave
+              unchanged, or set to an empty map to clear it.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._post(
+            path_template("/v1/axons/{id}", id=id),
+            body=await async_maybe_transform({"metadata": metadata}, axon_update_params.AxonUpdateParams),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
+            ),
+            cast_to=AxonView,
+        )
+
     def list(
         self,
         *,
         id: str | Omit = omit,
         include_total_count: bool | Omit = omit,
         limit: int | Omit = omit,
+        metadata_key: str | Omit = omit,
+        metadata_key_in: str | Omit = omit,
         name: str | Omit = omit,
         search: str | Omit = omit,
         starting_after: str | Omit = omit,
@@ -488,6 +617,11 @@ class AsyncAxonsResource(AsyncAPIResource):
 
           limit: The limit of items to return. Default is 20. Max is 5000.
 
+          metadata_key: Filter axons by metadata key-value pair. Can be used multiple times for
+              different keys.
+
+          metadata_key_in: Filter axons by metadata key with multiple possible values (OR condition).
+
           name: Filter by axon name (prefix match supported).
 
           search: Search by axon ID or name.
@@ -515,6 +649,8 @@ class AsyncAxonsResource(AsyncAPIResource):
                         "id": id,
                         "include_total_count": include_total_count,
                         "limit": limit,
+                        "metadata_key": metadata_key,
+                        "metadata_key_in": metadata_key_in,
                         "name": name,
                         "search": search,
                         "starting_after": starting_after,
@@ -684,6 +820,9 @@ class AxonsResourceWithRawResponse:
         self.retrieve = to_raw_response_wrapper(
             axons.retrieve,
         )
+        self.update = to_raw_response_wrapper(
+            axons.update,
+        )
         self.list = to_raw_response_wrapper(
             axons.list,
         )
@@ -716,6 +855,9 @@ class AsyncAxonsResourceWithRawResponse:
         self.retrieve = async_to_raw_response_wrapper(
             axons.retrieve,
         )
+        self.update = async_to_raw_response_wrapper(
+            axons.update,
+        )
         self.list = async_to_raw_response_wrapper(
             axons.list,
         )
@@ -748,6 +890,9 @@ class AxonsResourceWithStreamingResponse:
         self.retrieve = to_streamed_response_wrapper(
             axons.retrieve,
         )
+        self.update = to_streamed_response_wrapper(
+            axons.update,
+        )
         self.list = to_streamed_response_wrapper(
             axons.list,
         )
@@ -780,6 +925,9 @@ class AsyncAxonsResourceWithStreamingResponse:
         self.retrieve = async_to_streamed_response_wrapper(
             axons.retrieve,
         )
+        self.update = async_to_streamed_response_wrapper(
+            axons.update,
+        )
         self.list = async_to_streamed_response_wrapper(
             axons.list,
         )

{runloop_api_client-1.31.0 → runloop_api_client-1.32.0}/src/runloop_api_client/types/__init__.py

@@ -50,6 +50,7 @@ from .agent_list_params import AgentListParams as AgentListParams
 from .scenario_run_view import ScenarioRunView as ScenarioRunView
 from .allowed_cidr_param import AllowedCidrParam as AllowedCidrParam
 from .axon_create_params import AxonCreateParams as AxonCreateParams
+from .axon_update_params import AxonUpdateParams as AxonUpdateParams
 from .benchmark_job_view import BenchmarkJobView as BenchmarkJobView
 from .benchmark_run_view import BenchmarkRunView as BenchmarkRunView
 from .devbox_list_params import DevboxListParams as DevboxListParams

{runloop_api_client-1.31.0 → runloop_api_client-1.32.0}/src/runloop_api_client/types/axon_create_params.py

@@ -2,12 +2,15 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Dict, Optional
 from typing_extensions import TypedDict
 
 __all__ = ["AxonCreateParams"]
 
 
 class AxonCreateParams(TypedDict, total=False):
+    metadata: Optional[Dict[str, str]]
+    """User defined metadata to attach to the axon for organization."""
+
     name: Optional[str]
     """(Optional) Name for the axon."""