feat!: improve consistency of post-training API endpoints

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 108
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/llamastack%2Fllama-stack-client-958e990011d6b4c27513743a151ec4c80c3103650a80027380d15f1d6b108e32.yml
-openapi_spec_hash: 5b49d825dbc2a26726ca752914a65114
-config_hash: 19b84a0a93d566334ae134dafc71991f
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/llamastack%2Fllama-stack-client-7082771a4cef842834c167a755a9eafb9e9f412349e06abae9ee0331adcc8c49.yml
+openapi_spec_hash: 711015fd57cb31962ee3683ea7dafe32
+config_hash: 07e70c7f1980785685ea4f2618dfde62

api.md

@@ -474,9 +474,9 @@ from llama_stack_client.types.alpha.post_training import (
 Methods:
 
 - <code title="get /v1alpha/post-training/jobs">client.alpha.post_training.job.<a href="./src/llama_stack_client/resources/alpha/post_training/job.py">list</a>() -> <a href="./src/llama_stack_client/types/alpha/post_training/job_list_response.py">JobListResponse</a></code>
-- <code title="get /v1alpha/post-training/job/artifacts">client.alpha.post_training.job.<a href="./src/llama_stack_client/resources/alpha/post_training/job.py">artifacts</a>() -> <a href="./src/llama_stack_client/types/alpha/post_training/job_artifacts_response.py">JobArtifactsResponse</a></code>
-- <code title="post /v1alpha/post-training/job/cancel">client.alpha.post_training.job.<a href="./src/llama_stack_client/resources/alpha/post_training/job.py">cancel</a>() -> None</code>
-- <code title="get /v1alpha/post-training/job/status">client.alpha.post_training.job.<a href="./src/llama_stack_client/resources/alpha/post_training/job.py">status</a>() -> <a href="./src/llama_stack_client/types/alpha/post_training/job_status_response.py">JobStatusResponse</a></code>
+- <code title="get /v1alpha/post-training/jobs/{job_uuid}/artifacts">client.alpha.post_training.job.<a href="./src/llama_stack_client/resources/alpha/post_training/job.py">artifacts</a>(job_uuid) -> <a href="./src/llama_stack_client/types/alpha/post_training/job_artifacts_response.py">JobArtifactsResponse</a></code>
+- <code title="post /v1alpha/post-training/jobs/{job_uuid}/cancel">client.alpha.post_training.job.<a href="./src/llama_stack_client/resources/alpha/post_training/job.py">cancel</a>(job_uuid) -> None</code>
+- <code title="get /v1alpha/post-training/jobs/{job_uuid}/status">client.alpha.post_training.job.<a href="./src/llama_stack_client/resources/alpha/post_training/job.py">status</a>(job_uuid) -> <a href="./src/llama_stack_client/types/alpha/post_training/job_status_response.py">JobStatusResponse</a></code>
 
 ## Benchmarks
 

src/llama_stack_client/resources/alpha/post_training/job.py

@@ -75,6 +75,7 @@ def list(
 
     def artifacts(
         self,
+        job_uuid: str,
         *,
         # 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.
@@ -83,9 +84,24 @@ def artifacts(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> JobArtifactsResponse:
-        """Get the artifacts of a training job."""
+        """
+        Get the artifacts of a training job.
+
+        Args:
+          job_uuid: The UUID of the job to get the artifacts of.
+
+          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
+        """
+        if not job_uuid:
+            raise ValueError(f"Expected a non-empty value for `job_uuid` but received {job_uuid!r}")
         return self._get(
-            "/v1alpha/post-training/job/artifacts",
+            f"/v1alpha/post-training/jobs/{job_uuid}/artifacts",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -94,6 +110,7 @@ def artifacts(
 
     def cancel(
         self,
+        job_uuid: str,
         *,
         # 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.
@@ -102,10 +119,25 @@ def cancel(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
-        """Cancel a training job."""
+        """
+        Cancel a training job.
+
+        Args:
+          job_uuid: The UUID of the job to cancel.
+
+          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
+        """
+        if not job_uuid:
+            raise ValueError(f"Expected a non-empty value for `job_uuid` but received {job_uuid!r}")
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._post(
-            "/v1alpha/post-training/job/cancel",
+            f"/v1alpha/post-training/jobs/{job_uuid}/cancel",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -114,6 +146,7 @@ def cancel(
 
     def status(
         self,
+        job_uuid: str,
         *,
         # 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.
@@ -122,9 +155,24 @@ def status(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> JobStatusResponse:
-        """Get the status of a training job."""
+        """
+        Get the status of a training job.
+
+        Args:
+          job_uuid: The UUID of the job to get the status of.
+
+          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
+        """
+        if not job_uuid:
+            raise ValueError(f"Expected a non-empty value for `job_uuid` but received {job_uuid!r}")
         return self._get(
-            "/v1alpha/post-training/job/status",
+            f"/v1alpha/post-training/jobs/{job_uuid}/status",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -177,6 +225,7 @@ async def list(
 
     async def artifacts(
         self,
+        job_uuid: str,
         *,
         # 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.
@@ -185,9 +234,24 @@ async def artifacts(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> JobArtifactsResponse:
-        """Get the artifacts of a training job."""
+        """
+        Get the artifacts of a training job.
+
+        Args:
+          job_uuid: The UUID of the job to get the artifacts of.
+
+          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
+        """
+        if not job_uuid:
+            raise ValueError(f"Expected a non-empty value for `job_uuid` but received {job_uuid!r}")
         return await self._get(
-            "/v1alpha/post-training/job/artifacts",
+            f"/v1alpha/post-training/jobs/{job_uuid}/artifacts",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -196,6 +260,7 @@ async def artifacts(
 
     async def cancel(
         self,
+        job_uuid: str,
         *,
         # 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.
@@ -204,10 +269,25 @@ async def cancel(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
-        """Cancel a training job."""
+        """
+        Cancel a training job.
+
+        Args:
+          job_uuid: The UUID of the job to cancel.
+
+          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
+        """
+        if not job_uuid:
+            raise ValueError(f"Expected a non-empty value for `job_uuid` but received {job_uuid!r}")
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._post(
-            "/v1alpha/post-training/job/cancel",
+            f"/v1alpha/post-training/jobs/{job_uuid}/cancel",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -216,6 +296,7 @@ async def cancel(
 
     async def status(
         self,
+        job_uuid: str,
         *,
         # 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.
@@ -224,9 +305,24 @@ async def status(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> JobStatusResponse:
-        """Get the status of a training job."""
+        """
+        Get the status of a training job.
+
+        Args:
+          job_uuid: The UUID of the job to get the status of.
+
+          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
+        """
+        if not job_uuid:
+            raise ValueError(f"Expected a non-empty value for `job_uuid` but received {job_uuid!r}")
         return await self._get(
-            "/v1alpha/post-training/job/status",
+            f"/v1alpha/post-training/jobs/{job_uuid}/status",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),