feat(config): custom_headers on McpConfig/GatewayConfig — persistence, REST, validation, provisioner, OpenAPI (#11096)

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 121
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai/runloop-7b9d926e46ee0dca27286795e6d90d3ba75643c897ea21c3ce05a7d999a1d33b.yml
-openapi_spec_hash: 19d9c8ceae252900eca5fbb84eb19285
-config_hash: 2b0535779b180339d10766ba74a96700
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai/runloop-ae0f5383aa4cb3defa2a011375d3524b89a9fed30e2ef6c8d225192a4ea8eb1f.yml
+openapi_spec_hash: a4f906d2af71050ead8673bad44a65d7
+config_hash: 25409d286d89763213d1155725bba77a

api.md

@@ -7,6 +7,7 @@ from runloop_api_client.types import (
     AgentSource,
     BrokerMount,
     CodeMountParameters,
+    CustomHeader,
     LaunchParameters,
     LifecycleConfiguration,
     LifecycleHooks,

src/runloop_api_client/resources/gateway_configs.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Iterable, Optional
 
 import httpx
 
@@ -20,6 +20,7 @@
 from ..pagination import SyncGatewayConfigsCursorIDPage, AsyncGatewayConfigsCursorIDPage
 from .._base_client import AsyncPaginator, make_request_options
 from ..types.gateway_config_view import GatewayConfigView
+from ..types.shared_params.custom_header import CustomHeader
 
 __all__ = ["GatewayConfigsResource", "AsyncGatewayConfigsResource"]
 
@@ -50,6 +51,7 @@ def create(
         auth_mechanism: gateway_config_create_params.AuthMechanism,
         endpoint: str,
         name: str,
+        custom_headers: Optional[Iterable[CustomHeader]] | Omit = omit,
         description: 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.
@@ -73,6 +75,9 @@ def create(
           name: The human-readable name for the GatewayConfig. Must be unique within your
               account.
 
+          custom_headers: Additional headers applied to proxied requests after the auth mechanism. At most
+              8 entries.
+
           description: Optional description for this gateway configuration.
 
           extra_headers: Send extra headers
@@ -92,6 +97,7 @@ def create(
                     "auth_mechanism": auth_mechanism,
                     "endpoint": endpoint,
                     "name": name,
+                    "custom_headers": custom_headers,
                     "description": description,
                 },
                 gateway_config_create_params.GatewayConfigCreateParams,
@@ -144,6 +150,7 @@ def update(
         id: str,
         *,
         auth_mechanism: Optional[gateway_config_update_params.AuthMechanism] | Omit = omit,
+        custom_headers: Optional[Iterable[CustomHeader]] | Omit = omit,
         description: Optional[str] | Omit = omit,
         endpoint: Optional[str] | Omit = omit,
         name: Optional[str] | Omit = omit,
@@ -163,6 +170,9 @@ def update(
           auth_mechanism: Defines how credentials are applied to HTTP requests when proxying through the
               gateway.
 
+          custom_headers: New list of additional headers. Replaces the existing list entirely; use an
+              empty list to clear all custom headers. At most 8 entries.
+
           description: New description for this gateway configuration.
 
           endpoint: New target endpoint URL (e.g., 'https://api.anthropic.com').
@@ -186,6 +196,7 @@ def update(
             body=maybe_transform(
                 {
                     "auth_mechanism": auth_mechanism,
+                    "custom_headers": custom_headers,
                     "description": description,
                     "endpoint": endpoint,
                     "name": name,
@@ -335,6 +346,7 @@ async def create(
         auth_mechanism: gateway_config_create_params.AuthMechanism,
         endpoint: str,
         name: str,
+        custom_headers: Optional[Iterable[CustomHeader]] | Omit = omit,
         description: 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.
@@ -358,6 +370,9 @@ async def create(
           name: The human-readable name for the GatewayConfig. Must be unique within your
               account.
 
+          custom_headers: Additional headers applied to proxied requests after the auth mechanism. At most
+              8 entries.
+
           description: Optional description for this gateway configuration.
 
           extra_headers: Send extra headers
@@ -377,6 +392,7 @@ async def create(
                     "auth_mechanism": auth_mechanism,
                     "endpoint": endpoint,
                     "name": name,
+                    "custom_headers": custom_headers,
                     "description": description,
                 },
                 gateway_config_create_params.GatewayConfigCreateParams,
@@ -429,6 +445,7 @@ async def update(
         id: str,
         *,
         auth_mechanism: Optional[gateway_config_update_params.AuthMechanism] | Omit = omit,
+        custom_headers: Optional[Iterable[CustomHeader]] | Omit = omit,
         description: Optional[str] | Omit = omit,
         endpoint: Optional[str] | Omit = omit,
         name: Optional[str] | Omit = omit,
@@ -448,6 +465,9 @@ async def update(
           auth_mechanism: Defines how credentials are applied to HTTP requests when proxying through the
               gateway.
 
+          custom_headers: New list of additional headers. Replaces the existing list entirely; use an
+              empty list to clear all custom headers. At most 8 entries.
+
           description: New description for this gateway configuration.
 
           endpoint: New target endpoint URL (e.g., 'https://api.anthropic.com').
@@ -471,6 +491,7 @@ async def update(
             body=await async_maybe_transform(
                 {
                     "auth_mechanism": auth_mechanism,
+                    "custom_headers": custom_headers,
                     "description": description,
                     "endpoint": endpoint,
                     "name": name,

src/runloop_api_client/resources/mcp_configs.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Iterable, Optional
 
 import httpx
 
@@ -20,6 +20,7 @@
 from ..pagination import SyncMcpConfigsCursorIDPage, AsyncMcpConfigsCursorIDPage
 from .._base_client import AsyncPaginator, make_request_options
 from ..types.mcp_config_view import McpConfigView
+from ..types.shared_params.custom_header import CustomHeader
 
 __all__ = ["McpConfigsResource", "AsyncMcpConfigsResource"]
 
@@ -50,6 +51,7 @@ def create(
         allowed_tools: SequenceNotStr[str],
         endpoint: str,
         name: str,
+        custom_headers: Optional[Iterable[CustomHeader]] | Omit = omit,
         description: 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.
@@ -75,6 +77,9 @@ def create(
               The first segment before '-' is used as the service name for tool routing (e.g.,
               'github-readonly' uses 'github' as the service name).
 
+          custom_headers: Additional headers applied to upstream requests after the credential. At most 8
+              entries.
+
           description: Optional description for this MCP configuration.
 
           extra_headers: Send extra headers
@@ -94,6 +99,7 @@ def create(
                     "allowed_tools": allowed_tools,
                     "endpoint": endpoint,
                     "name": name,
+                    "custom_headers": custom_headers,
                     "description": description,
                 },
                 mcp_config_create_params.McpConfigCreateParams,
@@ -146,6 +152,7 @@ def update(
         id: str,
         *,
         allowed_tools: Optional[SequenceNotStr[str]] | Omit = omit,
+        custom_headers: Optional[Iterable[CustomHeader]] | Omit = omit,
         description: Optional[str] | Omit = omit,
         endpoint: Optional[str] | Omit = omit,
         name: Optional[str] | Omit = omit,
@@ -165,6 +172,9 @@ def update(
           allowed_tools: New glob patterns specifying which tools are allowed. Examples: ['*'] for all
               tools, ['github.search_*'] for specific patterns.
 
+          custom_headers: New list of additional headers. Replaces the existing list entirely; use an
+              empty list to clear all custom headers. At most 8 entries.
+
           description: New description for this MCP configuration.
 
           endpoint: New target MCP server endpoint URL.
@@ -188,6 +198,7 @@ def update(
             body=maybe_transform(
                 {
                     "allowed_tools": allowed_tools,
+                    "custom_headers": custom_headers,
                     "description": description,
                     "endpoint": endpoint,
                     "name": name,
@@ -336,6 +347,7 @@ async def create(
         allowed_tools: SequenceNotStr[str],
         endpoint: str,
         name: str,
+        custom_headers: Optional[Iterable[CustomHeader]] | Omit = omit,
         description: 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.
@@ -361,6 +373,9 @@ async def create(
               The first segment before '-' is used as the service name for tool routing (e.g.,
               'github-readonly' uses 'github' as the service name).
 
+          custom_headers: Additional headers applied to upstream requests after the credential. At most 8
+              entries.
+
           description: Optional description for this MCP configuration.
 
           extra_headers: Send extra headers
@@ -380,6 +395,7 @@ async def create(
                     "allowed_tools": allowed_tools,
                     "endpoint": endpoint,
                     "name": name,
+                    "custom_headers": custom_headers,
                     "description": description,
                 },
                 mcp_config_create_params.McpConfigCreateParams,
@@ -432,6 +448,7 @@ async def update(
         id: str,
         *,
         allowed_tools: Optional[SequenceNotStr[str]] | Omit = omit,
+        custom_headers: Optional[Iterable[CustomHeader]] | Omit = omit,
         description: Optional[str] | Omit = omit,
         endpoint: Optional[str] | Omit = omit,
         name: Optional[str] | Omit = omit,
@@ -451,6 +468,9 @@ async def update(
           allowed_tools: New glob patterns specifying which tools are allowed. Examples: ['*'] for all
               tools, ['github.search_*'] for specific patterns.
 
+          custom_headers: New list of additional headers. Replaces the existing list entirely; use an
+              empty list to clear all custom headers. At most 8 entries.
+
           description: New description for this MCP configuration.
 
           endpoint: New target MCP server endpoint URL.
@@ -474,6 +494,7 @@ async def update(
             body=await async_maybe_transform(
                 {
                     "allowed_tools": allowed_tools,
+                    "custom_headers": custom_headers,
                     "description": description,
                     "endpoint": endpoint,
                     "name": name,

src/runloop_api_client/types/__init__.py

@@ -10,6 +10,7 @@
     AgentSource as AgentSource,
     BrokerMount as BrokerMount,
     ObjectMount as ObjectMount,
+    CustomHeader as CustomHeader,
     LifecycleHooks as LifecycleHooks,
     ResumeTriggers as ResumeTriggers,
     LaunchParameters as LaunchParameters,

src/runloop_api_client/types/gateway_config_create_params.py

@@ -2,9 +2,11 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Iterable, Optional
 from typing_extensions import Required, TypedDict
 
+from .shared_params.custom_header import CustomHeader
+
 __all__ = ["GatewayConfigCreateParams", "AuthMechanism"]
 
 
@@ -24,6 +26,12 @@ class GatewayConfigCreateParams(TypedDict, total=False):
     Must be unique within your account.
     """
 
+    custom_headers: Optional[Iterable[CustomHeader]]
+    """Additional headers applied to proxied requests after the auth mechanism.
+
+    At most 8 entries.
+    """
+
     description: Optional[str]
     """Optional description for this gateway configuration."""
 

src/runloop_api_client/types/gateway_config_update_params.py

@@ -2,9 +2,11 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Iterable, Optional
 from typing_extensions import Required, TypedDict
 
+from .shared_params.custom_header import CustomHeader
+
 __all__ = ["GatewayConfigUpdateParams", "AuthMechanism"]
 
 
@@ -15,6 +17,13 @@ class GatewayConfigUpdateParams(TypedDict, total=False):
     gateway.
     """
 
+    custom_headers: Optional[Iterable[CustomHeader]]
+    """New list of additional headers.
+
+    Replaces the existing list entirely; use an empty list to clear all custom
+    headers. At most 8 entries.
+    """
+
     description: Optional[str]
     """New description for this gateway configuration."""
 

src/runloop_api_client/types/gateway_config_view.py

@@ -1,8 +1,9 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Optional
+from typing import List, Optional
 
 from .._models import BaseModel
+from .shared.custom_header import CustomHeader
 
 __all__ = ["GatewayConfigView", "AuthMechanism"]
 
@@ -47,5 +48,12 @@ class GatewayConfigView(BaseModel):
     account_id: Optional[str] = None
     """The account ID that owns this config."""
 
+    custom_headers: Optional[List[CustomHeader]] = None
+    """Additional headers applied to proxied requests after the auth mechanism.
+
+    Secret-backed entries reference the secret by 'sec\\__' id; values are never
+    returned.
+    """
+
     description: Optional[str] = None
     """Optional description for this gateway configuration."""

src/runloop_api_client/types/mcp_config_create_params.py

@@ -2,10 +2,11 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Iterable, Optional
 from typing_extensions import Required, TypedDict
 
 from .._types import SequenceNotStr
+from .shared_params.custom_header import CustomHeader
 
 __all__ = ["McpConfigCreateParams"]
 
@@ -29,5 +30,11 @@ class McpConfigCreateParams(TypedDict, total=False):
     service name).
     """
 
+    custom_headers: Optional[Iterable[CustomHeader]]
+    """Additional headers applied to upstream requests after the credential.
+
+    At most 8 entries.
+    """
+
     description: Optional[str]
     """Optional description for this MCP configuration."""

src/runloop_api_client/types/mcp_config_update_params.py

@@ -2,10 +2,11 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Iterable, Optional
 from typing_extensions import TypedDict
 
 from .._types import SequenceNotStr
+from .shared_params.custom_header import CustomHeader
 
 __all__ = ["McpConfigUpdateParams"]
 
@@ -17,6 +18,13 @@ class McpConfigUpdateParams(TypedDict, total=False):
     Examples: ['*'] for all tools, ['github.search_*'] for specific patterns.
     """
 
+    custom_headers: Optional[Iterable[CustomHeader]]
+    """New list of additional headers.
+
+    Replaces the existing list entirely; use an empty list to clear all custom
+    headers. At most 8 entries.
+    """
+
     description: Optional[str]
     """New description for this MCP configuration."""