feat: Add actor_path to Actor version models

pyproject.toml

@@ -251,7 +251,7 @@ keep_model_order = true
 # workflow committing nothing unless the models changed. A local regeneration that only moves this line is that
 # same case - drop it rather than committing it alone.
 [tool.apify.openapi-spec]
-version = "v2-2026-11-01T214220Z"
+version = "v2-2026-11-04T151257Z"
 
 [tool.uv]
 # Minimal defense against supply-chain atatcks.

src/apify_client/_models.py

@@ -90,6 +90,10 @@ class ActVersion(BaseModel):
     """
     URL of the tarball or ZIP file, present when sourceType is TARBALL. Returned only to the Actor owner.
     """
+    actor_path: Annotated[str | None, Field(examples=['actors/typescript-actor'])] = None
+    """
+    The Actor's directory inside the uploaded source, present when the version sets it. Applies when sourceType is SOURCE_FILES or TARBALL. On a TARBALL version, only users with write access to the Actor get it.
+    """
 
 
 @docs_group('Models')
@@ -1111,6 +1115,10 @@ class CreateVersionRequest(BaseModel):
     """
     URL of the GitHub Gist to clone the source code from. Applies when the `sourceType` is `GITHUB_GIST`.
     """
+    actor_path: Annotated[str | None, Field(examples=['actors/typescript-actor'], max_length=255, min_length=1)] = None
+    """
+    The Actor's directory inside the uploaded source, as a path relative to the upload root with `/` separators, for example `actors/typescript-actor`. Applies when the `sourceType` is `SOURCE_FILES` or `TARBALL`. The API rejects a path when the `sourceType` is `GIT_REPO` or `GITHUB_GIST`. When omitted or `null`, the upload root is the Actor's directory. It has 1 to 255 characters, with no leading, trailing, or repeated `/` and no `.` or `..` segments.
+    """
 
 
 @docs_group('Models')
@@ -4745,6 +4753,10 @@ class UpdateVersionRequest(BaseModel):
     """
     URL of the GitHub Gist to clone the source code from. Applies when the `sourceType` is `GITHUB_GIST`.
     """
+    actor_path: Annotated[str | None, Field(examples=['actors/typescript-actor'], max_length=255, min_length=1)] = None
+    """
+    The Actor's directory inside the uploaded source, as a path relative to the upload root with `/` separators, for example `actors/typescript-actor`. Applies when the `sourceType` is `SOURCE_FILES` or `TARBALL`. The API rejects it when the `sourceType` is `GIT_REPO` or `GITHUB_GIST`. On an update without `sourceType`, the API checks it against the version's stored source type. When the version has no `actorPath`, the upload root is the Actor's directory. It has 1 to 255 characters, with no leading, trailing, or repeated `/` and no `.` or `..` segments. An update that sends `sourceType`, `sourceFiles`, or `tarballUrl` without `actorPath` removes the stored `actorPath`, so send it again with every upload. An update of other fields, such as `envVars` or `buildTag`, keeps it. Send `null` to remove it.
+    """
 
 
 @docs_group('Models')
@@ -5000,6 +5012,10 @@ class Version(BaseModel):
     """
     URL of the GitHub Gist to clone the source code from. Applies when the `sourceType` is `GITHUB_GIST`.
     """
+    actor_path: Annotated[str | None, Field(examples=['actors/typescript-actor'], max_length=255, min_length=1)] = None
+    """
+    The Actor's directory inside the uploaded source, as a path relative to the upload root with `/` separators, for example `actors/typescript-actor`. Applies when the `sourceType` is `SOURCE_FILES` or `TARBALL`. When absent or `null`, the upload root is the Actor's directory. On a `TARBALL` version, only users with write access to the Actor get it. It has 1 to 255 characters, with no leading, trailing, or repeated `/` and no `.` or `..` segments.
+    """
     github_webhook_id: int | None = None
     """
     ID of the GitHub webhook that triggers a build on push. Present when build on push is enabled for a GitHub repository.