feat(api): api update

stainless-app[bot] · stainless-app[bot] · commit 32f77e19c7bd · 2026-05-15T20:32:39.000Z
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 23
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta/warp-api-410e07a5c3a6e0ff043e5f414d501e171d4dd9f8c91b3404cd9e3e93afebae46.yml
-openapi_spec_hash: ab7a6a235e8b2484df1747c69a096ab0
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta/warp-api-4bc83c682f151e3779dabdac7cc9c83ec591510b4befc86a3b2995ccd6e61151.yml
+openapi_spec_hash: 35d33a8f98079873af81763e7381046e
 config_hash: 236823a4936c76818117c16aa5c188df
diff --git a/src/oz_agent_sdk/resources/agent/agent.py b/src/oz_agent_sdk/resources/agent/agent.py
@@ -302,7 +302,7 @@ def run(
               hierarchies.
 
           prompt: The prompt/instruction for the agent to execute. Required unless a skill is
-              specified via the skill field or config.skill_spec.
+              specified via the skill field, config.skill_spec, or config.skills.
 
           skill:
               Skill specification to use as the base prompt for the agent. Supported formats:
@@ -593,7 +593,7 @@ async def run(
               hierarchies.
 
           prompt: The prompt/instruction for the agent to execute. Required unless a skill is
-              specified via the skill field or config.skill_spec.
+              specified via the skill field, config.skill_spec, or config.skills.
 
           skill:
               Skill specification to use as the base prompt for the agent. Supported formats:
diff --git a/src/oz_agent_sdk/resources/agent/agent_.py b/src/oz_agent_sdk/resources/agent/agent_.py
@@ -53,6 +53,7 @@ def create(
         base_harness: Optional[str] | Omit = omit,
         base_model: Optional[str] | Omit = omit,
         description: Optional[str] | Omit = omit,
+        environment_id: Optional[str] | Omit = omit,
         harness_auth_secrets: agent_create_params.HarnessAuthSecrets | Omit = omit,
         inference_providers: agent_create_params.InferenceProviders | Omit = omit,
         memory_stores: Iterable[agent_create_params.MemoryStore] | Omit = omit,
@@ -80,6 +81,9 @@ def create(
 
           description: Optional description of the agent
 
+          environment_id: Optional default cloud environment ID for runs executed by this agent. The
+              environment must be owned by the same team as the agent.
+
           harness_auth_secrets: Authentication secrets for third-party harnesses. Only the secret for the
               harness specified gets injected into the environment.
 
@@ -118,6 +122,7 @@ def create(
                     "base_harness": base_harness,
                     "base_model": base_model,
                     "description": description,
+                    "environment_id": environment_id,
                     "harness_auth_secrets": harness_auth_secrets,
                     "inference_providers": inference_providers,
                     "memory_stores": memory_stores,
@@ -140,6 +145,7 @@ def update(
         base_harness: Optional[str] | Omit = omit,
         base_model: Optional[str] | Omit = omit,
         description: Optional[str] | Omit = omit,
+        environment_id: Optional[str] | Omit = omit,
         harness_auth_secrets: Optional[agent_update_params.HarnessAuthSecrets] | Omit = omit,
         inference_providers: Optional[agent_update_params.InferenceProviders] | Omit = omit,
         memory_stores: Optional[Iterable[agent_update_params.MemoryStore]] | Omit = omit,
@@ -168,6 +174,9 @@ def update(
           description: Replacement description. Omit or pass `null` to leave unchanged, or use an empty
               value to clear.
 
+          environment_id: Replacement default cloud environment ID. Omit or pass `null` to leave
+              unchanged, or pass an empty string to clear.
+
           harness_auth_secrets: Authentication secrets for third-party harnesses. Only the secret for the
               harness specified gets injected into the environment.
 
@@ -204,6 +213,7 @@ def update(
                     "base_harness": base_harness,
                     "base_model": base_model,
                     "description": description,
+                    "environment_id": environment_id,
                     "harness_auth_secrets": harness_auth_secrets,
                     "inference_providers": inference_providers,
                     "memory_stores": memory_stores,
@@ -344,6 +354,7 @@ async def create(
         base_harness: Optional[str] | Omit = omit,
         base_model: Optional[str] | Omit = omit,
         description: Optional[str] | Omit = omit,
+        environment_id: Optional[str] | Omit = omit,
         harness_auth_secrets: agent_create_params.HarnessAuthSecrets | Omit = omit,
         inference_providers: agent_create_params.InferenceProviders | Omit = omit,
         memory_stores: Iterable[agent_create_params.MemoryStore] | Omit = omit,
@@ -371,6 +382,9 @@ async def create(
 
           description: Optional description of the agent
 
+          environment_id: Optional default cloud environment ID for runs executed by this agent. The
+              environment must be owned by the same team as the agent.
+
           harness_auth_secrets: Authentication secrets for third-party harnesses. Only the secret for the
               harness specified gets injected into the environment.
 
@@ -409,6 +423,7 @@ async def create(
                     "base_harness": base_harness,
                     "base_model": base_model,
                     "description": description,
+                    "environment_id": environment_id,
                     "harness_auth_secrets": harness_auth_secrets,
                     "inference_providers": inference_providers,
                     "memory_stores": memory_stores,
@@ -431,6 +446,7 @@ async def update(
         base_harness: Optional[str] | Omit = omit,
         base_model: Optional[str] | Omit = omit,
         description: Optional[str] | Omit = omit,
+        environment_id: Optional[str] | Omit = omit,
         harness_auth_secrets: Optional[agent_update_params.HarnessAuthSecrets] | Omit = omit,
         inference_providers: Optional[agent_update_params.InferenceProviders] | Omit = omit,
         memory_stores: Optional[Iterable[agent_update_params.MemoryStore]] | Omit = omit,
@@ -459,6 +475,9 @@ async def update(
           description: Replacement description. Omit or pass `null` to leave unchanged, or use an empty
               value to clear.
 
+          environment_id: Replacement default cloud environment ID. Omit or pass `null` to leave
+              unchanged, or pass an empty string to clear.
+
           harness_auth_secrets: Authentication secrets for third-party harnesses. Only the secret for the
               harness specified gets injected into the environment.
 
@@ -495,6 +514,7 @@ async def update(
                     "base_harness": base_harness,
                     "base_model": base_model,
                     "description": description,
+                    "environment_id": environment_id,
                     "harness_auth_secrets": harness_auth_secrets,
                     "inference_providers": inference_providers,
                     "memory_stores": memory_stores,
diff --git a/src/oz_agent_sdk/resources/agent/schedules.py b/src/oz_agent_sdk/resources/agent/schedules.py
@@ -88,7 +88,7 @@ def create(
               omitted. The server does not infer mode from prompt prefixes such as `/plan`.
 
           prompt: The prompt/instruction for the agent to execute. Required unless
-              agent_config.skill_spec is provided.
+              agent_config.skill_spec or agent_config.skills is provided.
 
           team: Whether to create a team-owned schedule. Defaults to true for users on a single
               team.
@@ -195,7 +195,7 @@ def update(
               omitted. The server does not infer mode from prompt prefixes such as `/plan`.
 
           prompt: The prompt/instruction for the agent to execute. Required unless
-              agent_config.skill_spec is provided.
+              agent_config.skill_spec or agent_config.skills is provided.
 
           extra_headers: Send extra headers
 
@@ -416,7 +416,7 @@ async def create(
               omitted. The server does not infer mode from prompt prefixes such as `/plan`.
 
           prompt: The prompt/instruction for the agent to execute. Required unless
-              agent_config.skill_spec is provided.
+              agent_config.skill_spec or agent_config.skills is provided.
 
           team: Whether to create a team-owned schedule. Defaults to true for users on a single
               team.
@@ -523,7 +523,7 @@ async def update(
               omitted. The server does not infer mode from prompt prefixes such as `/plan`.
 
           prompt: The prompt/instruction for the agent to execute. Required unless
-              agent_config.skill_spec is provided.
+              agent_config.skill_spec or agent_config.skills is provided.
 
           extra_headers: Send extra headers
 
diff --git a/src/oz_agent_sdk/types/agent/agent_create_params.py b/src/oz_agent_sdk/types/agent/agent_create_params.py
@@ -30,6 +30,12 @@ class AgentCreateParams(TypedDict, total=False):
     description: Optional[str]
     """Optional description of the agent"""
 
+    environment_id: Optional[str]
+    """
+    Optional default cloud environment ID for runs executed by this agent. The
+    environment must be owned by the same team as the agent.
+    """
+
     harness_auth_secrets: HarnessAuthSecrets
     """
     Authentication secrets for third-party harnesses. Only the secret for the
diff --git a/src/oz_agent_sdk/types/agent/agent_response.py b/src/oz_agent_sdk/types/agent/agent_response.py
@@ -128,6 +128,16 @@ class AgentResponse(BaseModel):
     description: Optional[str] = None
     """Optional description of the agent"""
 
+    environment_id: Optional[str] = None
+    """Default cloud environment ID for runs executed by this agent.
+
+    The precedence order for environment resolution is:
+
+    1. The environment specified on the run itself
+    2. The agent's default environment
+    3. An empty environment
+    """
+
     harness_auth_secrets: Optional[HarnessAuthSecrets] = None
     """
     Authentication secrets for third-party harnesses. Only the secret for the
diff --git a/src/oz_agent_sdk/types/agent/agent_update_params.py b/src/oz_agent_sdk/types/agent/agent_update_params.py
@@ -36,6 +36,12 @@ class AgentUpdateParams(TypedDict, total=False):
     Omit or pass `null` to leave unchanged, or use an empty value to clear.
     """
 
+    environment_id: Optional[str]
+    """Replacement default cloud environment ID.
+
+    Omit or pass `null` to leave unchanged, or pass an empty string to clear.
+    """
+
     harness_auth_secrets: Optional[HarnessAuthSecrets]
     """
     Authentication secrets for third-party harnesses. Only the secret for the
diff --git a/src/oz_agent_sdk/types/agent/schedule_create_params.py b/src/oz_agent_sdk/types/agent/schedule_create_params.py
@@ -41,7 +41,7 @@ class ScheduleCreateParams(TypedDict, total=False):
     prompt: str
     """
     The prompt/instruction for the agent to execute. Required unless
-    agent_config.skill_spec is provided.
+    agent_config.skill_spec or agent_config.skills is provided.
     """
 
     team: bool
diff --git a/src/oz_agent_sdk/types/agent/schedule_update_params.py b/src/oz_agent_sdk/types/agent/schedule_update_params.py
@@ -38,5 +38,5 @@ class ScheduleUpdateParams(TypedDict, total=False):
     prompt: str
     """
     The prompt/instruction for the agent to execute. Required unless
-    agent_config.skill_spec is provided.
+    agent_config.skill_spec or agent_config.skills is provided.
     """
diff --git a/src/oz_agent_sdk/types/agent_run_params.py b/src/oz_agent_sdk/types/agent_run_params.py
@@ -55,7 +55,7 @@ class AgentRunParams(TypedDict, total=False):
     prompt: str
     """
     The prompt/instruction for the agent to execute. Required unless a skill is
-    specified via the skill field or config.skill_spec.
+    specified via the skill field, config.skill_spec, or config.skills.
     """
 
     skill: str
diff --git a/src/oz_agent_sdk/types/ambient_agent_config.py b/src/oz_agent_sdk/types/ambient_agent_config.py
@@ -177,10 +177,20 @@ class AmbientAgentConfig(BaseModel):
 
     skill_spec: Optional[str] = None
     """
-    Skill specification identifying which agent skill to use. Format:
+    Skill specification identifying the primary agent skill to use. Format:
     "{owner}/{repo}:{skill_path}" Example:
-    "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md" Use the list agents
-    endpoint to discover available skills.
+    "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md" Mutually exclusive with
+    skills in create/update requests. Responses include the first skills entry here
+    for backward compatibility. Use the list agents endpoint to discover available
+    skills.
+    """
+
+    skills: Optional[List[str]] = None
+    """
+    Ordered skill specifications to attach to the run. Format:
+    "{owner}/{repo}:{skill_path}" Example:
+    "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md" Mutually exclusive with
+    skill_spec in create/update requests.
     """
 
     worker_host: Optional[str] = None
diff --git a/src/oz_agent_sdk/types/ambient_agent_config_param.py b/src/oz_agent_sdk/types/ambient_agent_config_param.py
@@ -5,6 +5,7 @@
 from typing import Dict, Iterable
 from typing_extensions import Literal, Required, TypedDict
 
+from .._types import SequenceNotStr
 from .mcp_server_config_param import McpServerConfigParam
 
 __all__ = [
@@ -176,10 +177,20 @@ class AmbientAgentConfigParam(TypedDict, total=False):
 
     skill_spec: str
     """
-    Skill specification identifying which agent skill to use. Format:
+    Skill specification identifying the primary agent skill to use. Format:
     "{owner}/{repo}:{skill_path}" Example:
-    "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md" Use the list agents
-    endpoint to discover available skills.
+    "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md" Mutually exclusive with
+    skills in create/update requests. Responses include the first skills entry here
+    for backward compatibility. Use the list agents endpoint to discover available
+    skills.
+    """
+
+    skills: SequenceNotStr[str]
+    """
+    Ordered skill specifications to attach to the run. Format:
+    "{owner}/{repo}:{skill_path}" Example:
+    "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md" Mutually exclusive with
+    skill_spec in create/update requests.
     """
 
     worker_host: str
diff --git a/tests/api_resources/agent/test_agent_.py b/tests/api_resources/agent/test_agent_.py
@@ -36,6 +36,7 @@ def test_method_create_with_all_params(self, client: OzAPI) -> None:
             base_harness="base_harness",
             base_model="base_model",
             description="description",
+            environment_id="environment_id",
             harness_auth_secrets={
                 "claude_auth_secret_name": "claude_auth_secret_name",
                 "codex_auth_secret_name": "codex_auth_secret_name",
@@ -101,6 +102,7 @@ def test_method_update_with_all_params(self, client: OzAPI) -> None:
             base_harness="base_harness",
             base_model="base_model",
             description="description",
+            environment_id="environment_id",
             harness_auth_secrets={
                 "claude_auth_secret_name": "claude_auth_secret_name",
                 "codex_auth_secret_name": "codex_auth_secret_name",
@@ -293,6 +295,7 @@ async def test_method_create_with_all_params(self, async_client: AsyncOzAPI) ->
             base_harness="base_harness",
             base_model="base_model",
             description="description",
+            environment_id="environment_id",
             harness_auth_secrets={
                 "claude_auth_secret_name": "claude_auth_secret_name",
                 "codex_auth_secret_name": "codex_auth_secret_name",
@@ -358,6 +361,7 @@ async def test_method_update_with_all_params(self, async_client: AsyncOzAPI) ->
             base_harness="base_harness",
             base_model="base_model",
             description="description",
+            environment_id="environment_id",
             harness_auth_secrets={
                 "claude_auth_secret_name": "claude_auth_secret_name",
                 "codex_auth_secret_name": "codex_auth_secret_name",
diff --git a/tests/api_resources/agent/test_schedules.py b/tests/api_resources/agent/test_schedules.py
@@ -73,6 +73,7 @@ def test_method_create_with_all_params(self, client: OzAPI) -> None:
                 "name": "name",
                 "session_sharing": {"public_access": "VIEWER"},
                 "skill_spec": "skill_spec",
+                "skills": ["string"],
                 "worker_host": "worker_host",
             },
             agent_uid="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
@@ -209,6 +210,7 @@ def test_method_update_with_all_params(self, client: OzAPI) -> None:
                 "name": "name",
                 "session_sharing": {"public_access": "VIEWER"},
                 "skill_spec": "skill_spec",
+                "skills": ["string"],
                 "worker_host": "worker_host",
             },
             agent_uid="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
@@ -472,6 +474,7 @@ async def test_method_create_with_all_params(self, async_client: AsyncOzAPI) ->
                 "name": "name",
                 "session_sharing": {"public_access": "VIEWER"},
                 "skill_spec": "skill_spec",
+                "skills": ["string"],
                 "worker_host": "worker_host",
             },
             agent_uid="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
@@ -608,6 +611,7 @@ async def test_method_update_with_all_params(self, async_client: AsyncOzAPI) ->
                 "name": "name",
                 "session_sharing": {"public_access": "VIEWER"},
                 "skill_spec": "skill_spec",
+                "skills": ["string"],
                 "worker_host": "worker_host",
             },
             agent_uid="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
diff --git a/tests/api_resources/test_agent.py b/tests/api_resources/test_agent.py
@@ -194,6 +194,7 @@ def test_method_run_with_all_params(self, client: OzAPI) -> None:
                 "name": "name",
                 "session_sharing": {"public_access": "VIEWER"},
                 "skill_spec": "skill_spec",
+                "skills": ["string"],
                 "worker_host": "worker_host",
             },
             conversation_id="conversation_id",
@@ -407,6 +408,7 @@ async def test_method_run_with_all_params(self, async_client: AsyncOzAPI) -> Non
                 "name": "name",
                 "session_sharing": {"public_access": "VIEWER"},
                 "skill_spec": "skill_spec",
+                "skills": ["string"],
                 "worker_host": "worker_host",
             },
             conversation_id="conversation_id",
