_models.py

# generated by datamodel-codegen:
#   filename:  openapi.json
#   timestamp: 2026-02-25T14:54:37+00:00

from __future__ import annotations

from enum import StrEnum
from typing import Annotated, Any, Literal

from pydantic import AnyUrl, AwareDatetime, BaseModel, ConfigDict, EmailStr, Field


class PaginationResponse(BaseModel):
    """Common pagination fields for list responses."""

    model_config = ConfigDict(
        extra='allow',
    )
    total: Annotated[int, Field(examples=[2], ge=0)]
    """
    The total number of items available across all pages.
    """
    offset: Annotated[int, Field(examples=[0], ge=0)]
    """
    The starting position for this page of results.
    """
    limit: Annotated[int, Field(examples=[1000], ge=1)]
    """
    The maximum number of items returned per page.
    """
    desc: Annotated[bool, Field(examples=[False])]
    """
    Whether the results are sorted in descending order.
    """
    count: Annotated[int, Field(examples=[2], ge=0)]
    """
    The number of items returned in this response.
    """


class ActorStats(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    total_builds: Annotated[int | None, Field(alias='totalBuilds', examples=[9])] = None
    total_runs: Annotated[int | None, Field(alias='totalRuns', examples=[16])] = None
    total_users: Annotated[int | None, Field(alias='totalUsers', examples=[6])] = None
    total_users7_days: Annotated[int | None, Field(alias='totalUsers7Days', examples=[2])] = None
    total_users30_days: Annotated[int | None, Field(alias='totalUsers30Days', examples=[6])] = None
    total_users90_days: Annotated[int | None, Field(alias='totalUsers90Days', examples=[6])] = None
    total_metamorphs: Annotated[int | None, Field(alias='totalMetamorphs', examples=[2])] = None
    last_run_started_at: Annotated[
        AwareDatetime | None, Field(alias='lastRunStartedAt', examples=['2019-07-08T14:01:05.546Z'])
    ] = None


class ActorShort(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['br9CKmk457'])]
    created_at: Annotated[AwareDatetime, Field(alias='createdAt', examples=['2019-10-29T07:34:24.202Z'])]
    modified_at: Annotated[AwareDatetime, Field(alias='modifiedAt', examples=['2019-10-30T07:34:24.202Z'])]
    name: Annotated[str, Field(examples=['MyAct'])]
    username: Annotated[str, Field(examples=['janedoe'])]
    title: Annotated[str | None, Field(examples=['Hello World Example'])] = None
    stats: ActorStats | None = None


class ListOfActors(PaginationResponse):
    model_config = ConfigDict(
        extra='allow',
    )
    items: list[ActorShort]


class ListOfActorsResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: ListOfActors


class Error(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    type: Annotated[str, Field(examples=['run-failed'])]
    message: Annotated[str, Field(examples=['Actor run did not succeed (run ID: 55uatRrZib4xbZs, status: FAILED)'])]


class ErrorResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    error: Error


class VersionSourceType(StrEnum):
    SOURCE_FILES = 'SOURCE_FILES'
    GIT_REPO = 'GIT_REPO'
    TARBALL = 'TARBALL'
    GITHUB_GIST = 'GITHUB_GIST'


class EnvVar(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    name: Annotated[str, Field(examples=['MY_ENV_VAR'])]
    value: Annotated[str, Field(examples=['my-value'])]
    is_secret: Annotated[bool | None, Field(alias='isSecret', examples=[False])] = None


class SourceCodeFileFormat(StrEnum):
    BASE64 = 'BASE64'
    TEXT = 'TEXT'


class SourceCodeFile(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    format: SourceCodeFileFormat
    content: Annotated[str, Field(examples=["console.log('This is the main.js file');"])]
    name: Annotated[str, Field(examples=['src/main.js'])]


class SourceCodeFolder(BaseModel):
    """Represents a folder in the Actor's source code structure. Distinguished from
    SourceCodeFile by the presence of the `folder` property set to `true`.

    """

    model_config = ConfigDict(
        extra='allow',
    )
    name: Annotated[str, Field(examples=['src/utils'])]
    """
    The folder path relative to the Actor's root directory.
    """
    folder: Annotated[bool, Field(examples=[True])]
    """
    Always `true` for folders. Used to distinguish folders from files.
    """


class Version(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    version_number: Annotated[str, Field(alias='versionNumber', examples=['0.0'])]
    source_type: Annotated[VersionSourceType | None, Field(alias='sourceType')] = None
    env_vars: Annotated[list[EnvVar] | None, Field(alias='envVars')] = None
    apply_env_vars_to_build: Annotated[bool | None, Field(alias='applyEnvVarsToBuild', examples=[False])] = None
    build_tag: Annotated[str | None, Field(alias='buildTag', examples=['latest'])] = None
    source_files: Annotated[
        list[SourceCodeFile | SourceCodeFolder] | None, Field(alias='sourceFiles', title='VersionSourceFiles')
    ] = None
    git_repo_url: Annotated[str | None, Field(alias='gitRepoUrl')] = None
    """
    URL of the Git repository when sourceType is GIT_REPO.
    """
    tarball_url: Annotated[str | None, Field(alias='tarballUrl')] = None
    """
    URL of the tarball when sourceType is TARBALL.
    """
    github_gist_url: Annotated[str | None, Field(alias='gitHubGistUrl')] = None
    """
    URL of the GitHub Gist when sourceType is GITHUB_GIST.
    """


class CommonActorPricingInfo(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    apify_margin_percentage: Annotated[float, Field(alias='apifyMarginPercentage')]
    """
    In [0, 1], fraction of pricePerUnitUsd that goes to Apify
    """
    created_at: Annotated[AwareDatetime, Field(alias='createdAt')]
    """
    When this pricing info record has been created
    """
    started_at: Annotated[AwareDatetime, Field(alias='startedAt')]
    """
    Since when is this pricing info record effective for a given Actor
    """
    notified_about_future_change_at: Annotated[AwareDatetime | None, Field(alias='notifiedAboutFutureChangeAt')] = None
    notified_about_change_at: Annotated[AwareDatetime | None, Field(alias='notifiedAboutChangeAt')] = None
    reason_for_change: Annotated[str | None, Field(alias='reasonForChange')] = None


class PricingModel(StrEnum):
    PAY_PER_EVENT = 'PAY_PER_EVENT'
    PRICE_PER_DATASET_ITEM = 'PRICE_PER_DATASET_ITEM'
    FLAT_PRICE_PER_MONTH = 'FLAT_PRICE_PER_MONTH'
    FREE = 'FREE'


class ActorChargeEvent(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    event_price_usd: Annotated[float, Field(alias='eventPriceUsd')]
    event_title: Annotated[str, Field(alias='eventTitle')]
    event_description: Annotated[str, Field(alias='eventDescription')]


class PricingPerEvent(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    actor_charge_events: Annotated[dict[str, ActorChargeEvent] | None, Field(alias='actorChargeEvents')] = None


class PayPerEventActorPricingInfo(CommonActorPricingInfo):
    model_config = ConfigDict(
        extra='allow',
    )
    pricing_model: Annotated[Literal['PAY_PER_EVENT'], Field(alias='pricingModel')]
    pricing_per_event: Annotated[PricingPerEvent, Field(alias='pricingPerEvent')]
    minimal_max_total_charge_usd: Annotated[float | None, Field(alias='minimalMaxTotalChargeUsd')] = None


class PricePerDatasetItemActorPricingInfo(CommonActorPricingInfo):
    model_config = ConfigDict(
        extra='allow',
    )
    pricing_model: Annotated[Literal['PRICE_PER_DATASET_ITEM'], Field(alias='pricingModel')]
    unit_name: Annotated[str, Field(alias='unitName')]
    """
    Name of the unit that is being charged
    """
    price_per_unit_usd: Annotated[float, Field(alias='pricePerUnitUsd')]


class FlatPricePerMonthActorPricingInfo(CommonActorPricingInfo):
    model_config = ConfigDict(
        extra='allow',
    )
    pricing_model: Annotated[Literal['FLAT_PRICE_PER_MONTH'], Field(alias='pricingModel')]
    trial_minutes: Annotated[int, Field(alias='trialMinutes')]
    """
    For how long this Actor can be used for free in trial period
    """
    price_per_unit_usd: Annotated[float, Field(alias='pricePerUnitUsd')]
    """
    Monthly flat price in USD
    """


class FreeActorPricingInfo(CommonActorPricingInfo):
    model_config = ConfigDict(
        extra='allow',
    )
    pricing_model: Annotated[Literal['FREE'], Field(alias='pricingModel')]


class DefaultRunOptions(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    build: Annotated[str, Field(examples=['latest'])]
    timeout_secs: Annotated[int | None, Field(alias='timeoutSecs', examples=[3600])] = None
    memory_mbytes: Annotated[int, Field(alias='memoryMbytes', examples=[2048])]
    restart_on_error: Annotated[bool | None, Field(alias='restartOnError', examples=[False])] = None


class CreateActorRequest(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    name: Annotated[str | None, Field(examples=['MyActor'])] = None
    description: Annotated[str | None, Field(examples=['My favourite actor!'])] = None
    title: Annotated[str | None, Field(examples=['My actor'])] = None
    is_public: Annotated[bool | None, Field(alias='isPublic', examples=[False])] = None
    seo_title: Annotated[str | None, Field(alias='seoTitle', examples=['My actor'])] = None
    seo_description: Annotated[str | None, Field(alias='seoDescription', examples=['My actor is the best'])] = None
    restart_on_error: Annotated[bool | None, Field(alias='restartOnError', examples=[False])] = None
    versions: list[Version] | None = None
    pricing_infos: Annotated[
        list[
            PayPerEventActorPricingInfo
            | PricePerDatasetItemActorPricingInfo
            | FlatPricePerMonthActorPricingInfo
            | FreeActorPricingInfo
        ]
        | None,
        Field(alias='pricingInfos'),
    ] = None
    categories: list[str] | None = None
    default_run_options: Annotated[DefaultRunOptions | None, Field(alias='defaultRunOptions')] = None


class ActorPermissionLevel(StrEnum):
    """Determines permissions that the Actor requires to run. For more information, see the [Actor permissions documentation](https://docs.apify.com/platform/actors/development/permissions)."""

    LIMITED_PERMISSIONS = 'LIMITED_PERMISSIONS'
    FULL_PERMISSIONS = 'FULL_PERMISSIONS'


class ExampleRunInput(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    body: Annotated[str, Field(examples=['{ "helloWorld": 123 }'])]
    content_type: Annotated[str, Field(alias='contentType', examples=['application/json; charset=utf-8'])]


class TaggedBuildInfo(BaseModel):
    """Information about a tagged build."""

    model_config = ConfigDict(
        extra='allow',
    )
    build_id: Annotated[str | None, Field(alias='buildId', examples=['z2EryhbfhgSyqj6Hn'])] = None
    """
    The ID of the build associated with this tag.
    """
    build_number: Annotated[str | None, Field(alias='buildNumber', examples=['0.0.2'])] = None
    """
    The build number/version string.
    """
    finished_at: Annotated[AwareDatetime | None, Field(alias='finishedAt', examples=['2019-06-10T11:15:49.286Z'])] = (
        None
    )
    """
    The timestamp when the build finished.
    """


class Actor(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['zdc3Pyhyz3m8vjDeM'])]
    user_id: Annotated[str, Field(alias='userId', examples=['wRsJZtadYvn4mBZmm'])]
    name: Annotated[str, Field(examples=['MyActor'])]
    username: Annotated[str, Field(examples=['jane35'])]
    description: Annotated[str | None, Field(examples=['My favourite actor!'])] = None
    restart_on_error: Annotated[bool | None, Field(alias='restartOnError', examples=[False])] = None
    is_public: Annotated[bool, Field(alias='isPublic', examples=[False])]
    actor_permission_level: Annotated[ActorPermissionLevel | None, Field(alias='actorPermissionLevel')] = None
    created_at: Annotated[AwareDatetime, Field(alias='createdAt', examples=['2019-07-08T11:27:57.401Z'])]
    modified_at: Annotated[AwareDatetime, Field(alias='modifiedAt', examples=['2019-07-08T14:01:05.546Z'])]
    stats: ActorStats
    versions: list[Version]
    pricing_infos: Annotated[
        list[
            PayPerEventActorPricingInfo
            | PricePerDatasetItemActorPricingInfo
            | FlatPricePerMonthActorPricingInfo
            | FreeActorPricingInfo
        ]
        | None,
        Field(alias='pricingInfos'),
    ] = None
    default_run_options: Annotated[DefaultRunOptions, Field(alias='defaultRunOptions')]
    example_run_input: Annotated[ExampleRunInput | None, Field(alias='exampleRunInput')] = None
    is_deprecated: Annotated[bool | None, Field(alias='isDeprecated', examples=[False])] = None
    deployment_key: Annotated[str | None, Field(alias='deploymentKey', examples=['ssh-rsa AAAA ...'])] = None
    title: Annotated[str | None, Field(examples=['My Actor'])] = None
    tagged_builds: Annotated[dict[str, TaggedBuildInfo | None] | None, Field(alias='taggedBuilds')] = None
    readme_summary: Annotated[str | None, Field(alias='readmeSummary')] = None
    """
    A brief, LLM-generated readme summary
    """


class ActorResponse(BaseModel):
    """Response containing Actor data."""

    model_config = ConfigDict(
        extra='allow',
    )
    data: Actor


class CreateOrUpdateVersionRequest(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    version_number: Annotated[str | None, Field(alias='versionNumber', examples=['0.0'])] = None
    source_type: Annotated[VersionSourceType | None, Field(alias='sourceType')] = None
    env_vars: Annotated[list[EnvVar] | None, Field(alias='envVars')] = None
    apply_env_vars_to_build: Annotated[bool | None, Field(alias='applyEnvVarsToBuild', examples=[False])] = None
    build_tag: Annotated[str | None, Field(alias='buildTag', examples=['latest'])] = None
    source_files: Annotated[
        list[SourceCodeFile | SourceCodeFolder] | None, Field(alias='sourceFiles', title='VersionSourceFiles')
    ] = None
    git_repo_url: Annotated[str | None, Field(alias='gitRepoUrl')] = None
    """
    URL of the Git repository when sourceType is GIT_REPO.
    """
    tarball_url: Annotated[str | None, Field(alias='tarballUrl')] = None
    """
    URL of the tarball when sourceType is TARBALL.
    """
    github_gist_url: Annotated[str | None, Field(alias='gitHubGistUrl')] = None
    """
    URL of the GitHub Gist when sourceType is GITHUB_GIST.
    """


class BuildTag(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    build_id: Annotated[str, Field(alias='buildId')]


class UpdateActorRequest(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    name: Annotated[str, Field(examples=['MyActor'])]
    description: Annotated[str | None, Field(examples=['My favourite actor!'])] = None
    is_public: Annotated[bool, Field(alias='isPublic', examples=[False])]
    actor_permission_level: Annotated[ActorPermissionLevel | None, Field(alias='actorPermissionLevel')] = None
    seo_title: Annotated[str | None, Field(alias='seoTitle', examples=['My actor'])] = None
    seo_description: Annotated[str | None, Field(alias='seoDescription', examples=['My actor is the best'])] = None
    title: Annotated[str | None, Field(examples=['My Actor'])] = None
    restart_on_error: Annotated[bool | None, Field(alias='restartOnError', examples=[False])] = None
    versions: list[CreateOrUpdateVersionRequest]
    pricing_infos: Annotated[
        list[
            PayPerEventActorPricingInfo
            | PricePerDatasetItemActorPricingInfo
            | FlatPricePerMonthActorPricingInfo
            | FreeActorPricingInfo
        ]
        | None,
        Field(alias='pricingInfos'),
    ] = None
    categories: list[str] | None = None
    default_run_options: Annotated[DefaultRunOptions | None, Field(alias='defaultRunOptions')] = None
    tagged_builds: Annotated[
        dict[str, Any] | None,
        Field(alias='taggedBuilds', examples=[{'latest': {'buildId': 'z2EryhbfhgSyqj6Hn'}, 'beta': None}]),
    ] = None
    """
    An object to modify tags on the Actor's builds. The key is the tag name (e.g., _latest_), and the value is either an object with a `buildId` or `null`.

    This operation is a patch; any existing tags that you omit from this object will be preserved.

    - **To create or reassign a tag**, provide the tag name with a `buildId`. e.g., to assign the _latest_ tag:

       

      ```json
      {
        "latest": {
          "buildId": "z2EryhbfhgSyqj6Hn"
        }
      }
      ```

    - **To remove a tag**, provide the tag name with a `null` value. e.g., to remove the _beta_ tag:

       

      ```json
      {
        "beta": null
      }
      ```

    - **To perform multiple operations**, combine them. The following reassigns _latest_ and removes _beta_, while preserving any other existing tags.

       

      ```json
      {
        "latest": {
          "buildId": "z2EryhbfhgSyqj6Hn"
        },
        "beta": null
      }
      ```

    """


class ListOfVersions(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    total: Annotated[int, Field(examples=[5])]
    items: list[Version]


class ListOfVersionsResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: ListOfVersions


class VersionResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: Version


class ListOfEnvVars(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    total: Annotated[int, Field(examples=[5])]
    items: list[EnvVar]


class ListOfEnvVarsResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: ListOfEnvVars


class EnvVarResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: EnvVar


class WebhookEventType(StrEnum):
    """Type of event that triggers the webhook."""

    ACTOR_BUILD_ABORTED = 'ACTOR.BUILD.ABORTED'
    ACTOR_BUILD_CREATED = 'ACTOR.BUILD.CREATED'
    ACTOR_BUILD_FAILED = 'ACTOR.BUILD.FAILED'
    ACTOR_BUILD_SUCCEEDED = 'ACTOR.BUILD.SUCCEEDED'
    ACTOR_BUILD_TIMED_OUT = 'ACTOR.BUILD.TIMED_OUT'
    ACTOR_RUN_ABORTED = 'ACTOR.RUN.ABORTED'
    ACTOR_RUN_CREATED = 'ACTOR.RUN.CREATED'
    ACTOR_RUN_FAILED = 'ACTOR.RUN.FAILED'
    ACTOR_RUN_RESURRECTED = 'ACTOR.RUN.RESURRECTED'
    ACTOR_RUN_SUCCEEDED = 'ACTOR.RUN.SUCCEEDED'
    ACTOR_RUN_TIMED_OUT = 'ACTOR.RUN.TIMED_OUT'
    TEST = 'TEST'


class WebhookCondition(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    actor_id: Annotated[str | None, Field(alias='actorId', examples=['hksJZtadYvn4mBuin'])] = None
    actor_task_id: Annotated[str | None, Field(alias='actorTaskId', examples=['asdLZtadYvn4mBZmm'])] = None
    actor_run_id: Annotated[str | None, Field(alias='actorRunId', examples=['hgdKZtadYvn4mBpoi'])] = None


class WebhookDispatchStatus(StrEnum):
    """Status of the webhook dispatch indicating whether the HTTP request was successful."""

    ACTIVE = 'ACTIVE'
    SUCCEEDED = 'SUCCEEDED'
    FAILED = 'FAILED'


class ExampleWebhookDispatch(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    status: WebhookDispatchStatus
    finished_at: Annotated[AwareDatetime | None, Field(alias='finishedAt', examples=['2019-12-13T08:36:13.202Z'])] = (
        None
    )


class WebhookStats(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    total_dispatches: Annotated[int, Field(alias='totalDispatches', examples=[1])]


class WebhookShort(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['YiKoxjkaS9gjGTqhF'])]
    created_at: Annotated[AwareDatetime, Field(alias='createdAt', examples=['2019-12-12T07:34:14.202Z'])]
    modified_at: Annotated[AwareDatetime, Field(alias='modifiedAt', examples=['2019-12-13T08:36:13.202Z'])]
    user_id: Annotated[str, Field(alias='userId', examples=['wRsJZtadYvn4mBZmm'])]
    is_ad_hoc: Annotated[bool | None, Field(alias='isAdHoc', examples=[False])] = None
    should_interpolate_strings: Annotated[bool | None, Field(alias='shouldInterpolateStrings', examples=[False])] = None
    event_types: Annotated[list[WebhookEventType], Field(alias='eventTypes', examples=[['ACTOR.RUN.SUCCEEDED']])]
    condition: WebhookCondition
    ignore_ssl_errors: Annotated[bool, Field(alias='ignoreSslErrors', examples=[False])]
    do_not_retry: Annotated[bool, Field(alias='doNotRetry', examples=[False])]
    request_url: Annotated[AnyUrl, Field(alias='requestUrl', examples=['http://example.com/'])]
    last_dispatch: Annotated[ExampleWebhookDispatch | None, Field(alias='lastDispatch')] = None
    stats: WebhookStats | None = None


class ListOfWebhooks(PaginationResponse):
    model_config = ConfigDict(
        extra='allow',
    )
    items: list[WebhookShort]


class ListOfWebhooksResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: ListOfWebhooks


class ActorJobStatus(StrEnum):
    """Status of an Actor job (run or build)."""

    READY = 'READY'
    RUNNING = 'RUNNING'
    SUCCEEDED = 'SUCCEEDED'
    FAILED = 'FAILED'
    TIMING_OUT = 'TIMING-OUT'
    TIMED_OUT = 'TIMED-OUT'
    ABORTING = 'ABORTING'
    ABORTED = 'ABORTED'


class RunOrigin(StrEnum):
    DEVELOPMENT = 'DEVELOPMENT'
    WEB = 'WEB'
    API = 'API'
    SCHEDULER = 'SCHEDULER'
    TEST = 'TEST'
    WEBHOOK = 'WEBHOOK'
    ACTOR = 'ACTOR'
    CLI = 'CLI'
    STANDBY = 'STANDBY'


class BuildsMeta(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    origin: RunOrigin
    client_ip: Annotated[str | None, Field(alias='clientIp', examples=['172.234.12.34'])] = None
    """
    IP address of the client that started the build.
    """
    user_agent: Annotated[str | None, Field(alias='userAgent', examples=['Mozilla/5.0 (iPad)'])] = None
    """
    User agent of the client that started the build.
    """


class BuildShort(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['HG7ML7M8z78YcAPEB'])]
    act_id: Annotated[str | None, Field(alias='actId', examples=['janedoe~my-actor'])] = None
    status: ActorJobStatus
    started_at: Annotated[AwareDatetime, Field(alias='startedAt', examples=['2019-11-30T07:34:24.202Z'])]
    finished_at: Annotated[AwareDatetime | None, Field(alias='finishedAt', examples=['2019-12-12T09:30:12.202Z'])] = (
        None
    )
    usage_total_usd: Annotated[float, Field(alias='usageTotalUsd', examples=[0.02])]
    meta: BuildsMeta | None = None


class ListOfBuilds(PaginationResponse):
    model_config = ConfigDict(
        extra='allow',
    )
    items: list[BuildShort]


class ListOfBuildsResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: ListOfBuilds


class BuildStats(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    duration_millis: Annotated[int | None, Field(alias='durationMillis', examples=[1000])] = None
    run_time_secs: Annotated[float | None, Field(alias='runTimeSecs', examples=[45.718])] = None
    compute_units: Annotated[float, Field(alias='computeUnits', examples=[0.0126994444444444])]


class BuildOptions(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    use_cache: Annotated[bool | None, Field(alias='useCache', examples=[False])] = None
    beta_packages: Annotated[bool | None, Field(alias='betaPackages', examples=[False])] = None
    memory_mbytes: Annotated[int | None, Field(alias='memoryMbytes', examples=[1024])] = None
    disk_mbytes: Annotated[int | None, Field(alias='diskMbytes', examples=[2048])] = None


class BuildUsage(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    actor_compute_units: Annotated[float | None, Field(alias='ACTOR_COMPUTE_UNITS', examples=[0.08])] = None


class Storages(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    dataset: dict[str, Any] | None = None
    """
    Defines the schema of items in your dataset, the full specification can be found in [Apify docs](https://docs.apify.com/platform/actors/development/actor-definition/dataset-schema)
    """


class ActorDefinition(BaseModel):
    """The definition of the Actor, the full specification of this field can be found in [Apify docs](https://docs.apify.com/platform/actors/development/actor-definition/actor-json)"""

    model_config = ConfigDict(
        extra='allow',
    )
    actor_specification: Annotated[Literal[1], Field(alias='actorSpecification')] = 1
    """
    The Actor specification version that this Actor follows. This property must be set to 1.
    """
    name: str | None = None
    """
    The name of the Actor.
    """
    version: Annotated[str | None, Field(pattern='^[0-9]+\\.[0-9]+$')] = None
    """
    The version of the Actor, specified in the format [Number].[Number], e.g., 0.1, 1.0.
    """
    build_tag: Annotated[str | None, Field(alias='buildTag')] = None
    """
    The tag name to be applied to a successful build of the Actor. Defaults to 'latest' if not specified.
    """
    environment_variables: Annotated[dict[str, str] | None, Field(alias='environmentVariables')] = None
    """
    A map of environment variables to be used during local development and deployment.
    """
    dockerfile: str | None = None
    """
    The path to the Dockerfile used for building the Actor on the platform.
    """
    docker_context_dir: Annotated[str | None, Field(alias='dockerContextDir')] = None
    """
    The path to the directory used as the Docker context when building the Actor.
    """
    readme: str | None = None
    """
    The path to the README file for the Actor.
    """
    input: dict[str, Any] | None = None
    """
    The input schema object, the full specification can be found in [Apify docs](https://docs.apify.com/platform/actors/development/actor-definition/input-schema)
    """
    changelog: str | None = None
    """
    The path to the CHANGELOG file displayed in the Actor's information tab.
    """
    storages: Storages | None = None
    default_memory_mbytes: Annotated[str | int | None, Field(alias='defaultMemoryMbytes')] = None
    """
    Specifies the default amount of memory in megabytes to be used when the Actor is started. Can be an integer or a [dynamic memory expression](/platform/actors/development/actor-definition/dynamic-actor-memory).
    """
    min_memory_mbytes: Annotated[int | None, Field(alias='minMemoryMbytes', ge=256)] = None
    """
    Specifies the minimum amount of memory in megabytes required by the Actor.
    """
    max_memory_mbytes: Annotated[int | None, Field(alias='maxMemoryMbytes', ge=256)] = None
    """
    Specifies the maximum amount of memory in megabytes required by the Actor.
    """
    uses_standby_mode: Annotated[bool | None, Field(alias='usesStandbyMode')] = None
    """
    Specifies whether Standby mode is enabled for the Actor.
    """


class Build(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['HG7ML7M8z78YcAPEB'])]
    act_id: Annotated[str, Field(alias='actId', examples=['janedoe~my-actor'])]
    user_id: Annotated[str, Field(alias='userId', examples=['klmdEpoiojmdEMlk3'])]
    started_at: Annotated[AwareDatetime, Field(alias='startedAt', examples=['2019-11-30T07:34:24.202Z'])]
    finished_at: Annotated[AwareDatetime | None, Field(alias='finishedAt', examples=['2019-12-12T09:30:12.202Z'])] = (
        None
    )
    status: ActorJobStatus
    meta: BuildsMeta
    stats: BuildStats | None = None
    options: BuildOptions | None = None
    usage: BuildUsage | None = None
    usage_total_usd: Annotated[float | None, Field(alias='usageTotalUsd', examples=[0.02])] = None
    usage_usd: Annotated[BuildUsage | None, Field(alias='usageUsd')] = None
    input_schema: Annotated[str | None, Field(alias='inputSchema', examples=['{\\n  "title": "Schema for ... }'])] = (
        None
    )
    readme: Annotated[str | None, Field(examples=['# Magic Actor\\nThis Actor is magic.'])] = None
    build_number: Annotated[str, Field(alias='buildNumber', examples=['0.1.1'])]
    actor_definition: Annotated[ActorDefinition | None, Field(alias='actorDefinition')] = None


class BuildResponse(BaseModel):
    """Response containing Actor build data."""

    model_config = ConfigDict(
        extra='allow',
    )
    data: Build


class RunMeta(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    origin: RunOrigin
    client_ip: Annotated[str | None, Field(alias='clientIp')] = None
    """
    IP address of the client that started the run.
    """
    user_agent: Annotated[str | None, Field(alias='userAgent')] = None
    """
    User agent of the client that started the run.
    """
    schedule_id: Annotated[str | None, Field(alias='scheduleId')] = None
    """
    ID of the schedule that triggered the run.
    """
    scheduled_at: Annotated[AwareDatetime | None, Field(alias='scheduledAt')] = None
    """
    Time when the run was scheduled.
    """


class RunShort(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['HG7ML7M8z78YcAPEB'])]
    act_id: Annotated[str, Field(alias='actId', examples=['HDSasDasz78YcAPEB'])]
    actor_task_id: Annotated[str | None, Field(alias='actorTaskId', examples=['KJHSKHausidyaJKHs'])] = None
    status: ActorJobStatus
    started_at: Annotated[AwareDatetime, Field(alias='startedAt', examples=['2019-11-30T07:34:24.202Z'])]
    finished_at: Annotated[AwareDatetime | None, Field(alias='finishedAt', examples=['2019-12-12T09:30:12.202Z'])] = (
        None
    )
    build_id: Annotated[str, Field(alias='buildId', examples=['HG7ML7M8z78YcAPEB'])]
    build_number: Annotated[str | None, Field(alias='buildNumber', examples=['0.0.2'])] = None
    meta: RunMeta
    usage_total_usd: Annotated[float, Field(alias='usageTotalUsd', examples=[0.2])]
    default_key_value_store_id: Annotated[str, Field(alias='defaultKeyValueStoreId', examples=['sfAjeR4QmeJCQzTfe'])]
    default_dataset_id: Annotated[str, Field(alias='defaultDatasetId', examples=['3ZojQDdFTsyE7Moy4'])]
    default_request_queue_id: Annotated[str, Field(alias='defaultRequestQueueId', examples=['so93g2shcDzK3pA85'])]


class ListOfRuns(PaginationResponse):
    model_config = ConfigDict(
        extra='allow',
    )
    items: list[RunShort]


class ListOfRunsResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: ListOfRuns


class RunStats(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    input_body_len: Annotated[int | None, Field(alias='inputBodyLen', examples=[240], ge=0)] = None
    migration_count: Annotated[int | None, Field(alias='migrationCount', examples=[0], ge=0)] = None
    reboot_count: Annotated[int | None, Field(alias='rebootCount', examples=[0], ge=0)] = None
    restart_count: Annotated[int, Field(alias='restartCount', examples=[0], ge=0)]
    resurrect_count: Annotated[int, Field(alias='resurrectCount', examples=[2], ge=0)]
    mem_avg_bytes: Annotated[float | None, Field(alias='memAvgBytes', examples=[267874071.9])] = None
    mem_max_bytes: Annotated[int | None, Field(alias='memMaxBytes', examples=[404713472], ge=0)] = None
    mem_current_bytes: Annotated[int | None, Field(alias='memCurrentBytes', examples=[0], ge=0)] = None
    cpu_avg_usage: Annotated[float | None, Field(alias='cpuAvgUsage', examples=[33.7532101107538])] = None
    cpu_max_usage: Annotated[float | None, Field(alias='cpuMaxUsage', examples=[169.650735534941])] = None
    cpu_current_usage: Annotated[float | None, Field(alias='cpuCurrentUsage', examples=[0])] = None
    net_rx_bytes: Annotated[int | None, Field(alias='netRxBytes', examples=[103508042], ge=0)] = None
    net_tx_bytes: Annotated[int | None, Field(alias='netTxBytes', examples=[4854600], ge=0)] = None
    duration_millis: Annotated[int | None, Field(alias='durationMillis', examples=[248472], ge=0)] = None
    run_time_secs: Annotated[float | None, Field(alias='runTimeSecs', examples=[248.472], ge=0.0)] = None
    metamorph: Annotated[int | None, Field(examples=[0], ge=0)] = None
    compute_units: Annotated[float, Field(alias='computeUnits', examples=[0.13804], ge=0.0)]


class RunOptions(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    build: Annotated[str, Field(examples=['latest'])]
    timeout_secs: Annotated[int, Field(alias='timeoutSecs', examples=[300], ge=0)]
    memory_mbytes: Annotated[int, Field(alias='memoryMbytes', examples=[1024], ge=128, le=32768)]
    disk_mbytes: Annotated[int, Field(alias='diskMbytes', examples=[2048], ge=0)]
    max_items: Annotated[int | None, Field(alias='maxItems', examples=[1000], ge=1)] = None
    max_total_charge_usd: Annotated[float | None, Field(alias='maxTotalChargeUsd', examples=[5], ge=0.0)] = None


class GeneralAccess(StrEnum):
    """Defines the general access level for the resource."""

    ANYONE_WITH_ID_CAN_READ = 'ANYONE_WITH_ID_CAN_READ'
    ANYONE_WITH_NAME_CAN_READ = 'ANYONE_WITH_NAME_CAN_READ'
    FOLLOW_USER_SETTING = 'FOLLOW_USER_SETTING'
    RESTRICTED = 'RESTRICTED'


class RunUsage(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    actor_compute_units: Annotated[float | None, Field(alias='ACTOR_COMPUTE_UNITS', examples=[3])] = None
    dataset_reads: Annotated[int | None, Field(alias='DATASET_READS', examples=[4])] = None
    dataset_writes: Annotated[int | None, Field(alias='DATASET_WRITES', examples=[4])] = None
    key_value_store_reads: Annotated[int | None, Field(alias='KEY_VALUE_STORE_READS', examples=[5])] = None
    key_value_store_writes: Annotated[int | None, Field(alias='KEY_VALUE_STORE_WRITES', examples=[3])] = None
    key_value_store_lists: Annotated[int | None, Field(alias='KEY_VALUE_STORE_LISTS', examples=[5])] = None
    request_queue_reads: Annotated[int | None, Field(alias='REQUEST_QUEUE_READS', examples=[2])] = None
    request_queue_writes: Annotated[int | None, Field(alias='REQUEST_QUEUE_WRITES', examples=[1])] = None
    data_transfer_internal_gbytes: Annotated[
        float | None, Field(alias='DATA_TRANSFER_INTERNAL_GBYTES', examples=[1])
    ] = None
    data_transfer_external_gbytes: Annotated[
        float | None, Field(alias='DATA_TRANSFER_EXTERNAL_GBYTES', examples=[3])
    ] = None
    proxy_residential_transfer_gbytes: Annotated[
        float | None, Field(alias='PROXY_RESIDENTIAL_TRANSFER_GBYTES', examples=[34])
    ] = None
    proxy_serps: Annotated[int | None, Field(alias='PROXY_SERPS', examples=[3])] = None


class RunUsageUsd(BaseModel):
    """Resource usage costs in USD. All values are monetary amounts in US dollars."""

    model_config = ConfigDict(
        extra='allow',
    )
    actor_compute_units: Annotated[float | None, Field(alias='ACTOR_COMPUTE_UNITS', examples=[0.0003])] = None
    dataset_reads: Annotated[float | None, Field(alias='DATASET_READS', examples=[0.0001])] = None
    dataset_writes: Annotated[float | None, Field(alias='DATASET_WRITES', examples=[0.0001])] = None
    key_value_store_reads: Annotated[float | None, Field(alias='KEY_VALUE_STORE_READS', examples=[0.0001])] = None
    key_value_store_writes: Annotated[float | None, Field(alias='KEY_VALUE_STORE_WRITES', examples=[5e-05])] = None
    key_value_store_lists: Annotated[float | None, Field(alias='KEY_VALUE_STORE_LISTS', examples=[0.0001])] = None
    request_queue_reads: Annotated[float | None, Field(alias='REQUEST_QUEUE_READS', examples=[0.0001])] = None
    request_queue_writes: Annotated[float | None, Field(alias='REQUEST_QUEUE_WRITES', examples=[0.0001])] = None
    data_transfer_internal_gbytes: Annotated[
        float | None, Field(alias='DATA_TRANSFER_INTERNAL_GBYTES', examples=[0.001])
    ] = None
    data_transfer_external_gbytes: Annotated[
        float | None, Field(alias='DATA_TRANSFER_EXTERNAL_GBYTES', examples=[0.003])
    ] = None
    proxy_residential_transfer_gbytes: Annotated[
        float | None, Field(alias='PROXY_RESIDENTIAL_TRANSFER_GBYTES', examples=[0.034])
    ] = None
    proxy_serps: Annotated[float | None, Field(alias='PROXY_SERPS', examples=[0.003])] = None


class Metamorph(BaseModel):
    """Information about a metamorph event that occurred during the run."""

    model_config = ConfigDict(
        extra='allow',
    )
    created_at: Annotated[AwareDatetime, Field(alias='createdAt', examples=['2019-11-30T07:39:24.202Z'])]
    """
    Time when the metamorph occurred.
    """
    actor_id: Annotated[str, Field(alias='actorId', examples=['nspoEjklmnsF2oosD'])]
    """
    ID of the Actor that the run was metamorphed to.
    """
    build_id: Annotated[str, Field(alias='buildId', examples=['ME6oKecqy5kXDS4KQ'])]
    """
    ID of the build used for the metamorphed Actor.
    """
    input_key: Annotated[str | None, Field(alias='inputKey', examples=['INPUT-METAMORPH-1'])] = None
    """
    Key of the input record in the key-value store.
    """


class Run(BaseModel):
    """Represents an Actor run and its associated data."""

    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['HG7ML7M8z78YcAPEB'])]
    """
    Unique identifier of the Actor run.
    """
    act_id: Annotated[str, Field(alias='actId', examples=['HDSasDasz78YcAPEB'])]
    """
    ID of the Actor that was run.
    """
    user_id: Annotated[str, Field(alias='userId', examples=['7sT5jcggjjA9fNcxF'])]
    """
    ID of the user who started the run.
    """
    actor_task_id: Annotated[str | None, Field(alias='actorTaskId', examples=['KJHSKHausidyaJKHs'])] = None
    """
    ID of the Actor task, if the run was started from a task.
    """
    started_at: Annotated[AwareDatetime, Field(alias='startedAt', examples=['2019-11-30T07:34:24.202Z'])]
    """
    Time when the Actor run started.
    """
    finished_at: Annotated[AwareDatetime | None, Field(alias='finishedAt', examples=['2019-12-12T09:30:12.202Z'])] = (
        None
    )
    """
    Time when the Actor run finished.
    """
    status: ActorJobStatus
    """
    Current status of the Actor run.
    """
    status_message: Annotated[str | None, Field(alias='statusMessage', examples=['Actor is running'])] = None
    """
    Detailed message about the run status.
    """
    is_status_message_terminal: Annotated[bool | None, Field(alias='isStatusMessageTerminal', examples=[False])] = None
    """
    Whether the status message is terminal (final).
    """
    meta: RunMeta
    """
    Metadata about the Actor run.
    """
    pricing_info: Annotated[
        PayPerEventActorPricingInfo
        | PricePerDatasetItemActorPricingInfo
        | FlatPricePerMonthActorPricingInfo
        | FreeActorPricingInfo
        | None,
        Field(alias='pricingInfo', discriminator='pricing_model', title='ActorRunPricingInfo'),
    ] = None
    """
    Pricing information for the Actor.
    """
    stats: RunStats
    """
    Statistics of the Actor run.
    """
    charged_event_counts: Annotated[
        dict[str, int] | None,
        Field(alias='chargedEventCounts', examples=[{'actor-start': 1, 'page-crawled': 150, 'data-extracted': 75}]),
    ] = None
    """
    A map of charged event types to their counts. The keys are event type identifiers defined by the Actor's pricing model (pay-per-event), and the values are the number of times each event was charged during this run.
    """
    options: RunOptions
    """
    Configuration options for the Actor run.
    """
    build_id: Annotated[str, Field(alias='buildId', examples=['7sT5jcggjjA9fNcxF'])]
    """
    ID of the Actor build used for this run.
    """
    exit_code: Annotated[int | None, Field(alias='exitCode', examples=[0])] = None
    """
    Exit code of the Actor run process.
    """
    general_access: Annotated[GeneralAccess, Field(alias='generalAccess')]
    """
    General access level for the Actor run.
    """
    default_key_value_store_id: Annotated[str, Field(alias='defaultKeyValueStoreId', examples=['eJNzqsbPiopwJcgGQ'])]
    """
    ID of the default key-value store for this run.
    """
    default_dataset_id: Annotated[str, Field(alias='defaultDatasetId', examples=['wmKPijuyDnPZAPRMk'])]
    """
    ID of the default dataset for this run.
    """
    default_request_queue_id: Annotated[str, Field(alias='defaultRequestQueueId', examples=['FL35cSF7jrxr3BY39'])]
    """
    ID of the default request queue for this run.
    """
    build_number: Annotated[str | None, Field(alias='buildNumber', examples=['0.0.36'])] = None
    """
    Build number of the Actor build used for this run.
    """
    container_url: Annotated[
        AnyUrl | None, Field(alias='containerUrl', examples=['https://g8kd8kbc5ge8.runs.apify.net'])
    ] = None
    """
    URL of the container running the Actor.
    """
    is_container_server_ready: Annotated[bool | None, Field(alias='isContainerServerReady', examples=[True])] = None
    """
    Whether the container's HTTP server is ready to accept requests.
    """
    git_branch_name: Annotated[str | None, Field(alias='gitBranchName', examples=['master'])] = None
    """
    Name of the git branch used for the Actor build.
    """
    usage: RunUsage | None = None
    """
    Resource usage statistics for the run.
    """
    usage_total_usd: Annotated[float | None, Field(alias='usageTotalUsd', examples=[0.2654])] = None
    """
    Total cost in USD for this run. Represents what you actually pay. For run owners: includes platform usage (compute units) and/or event costs depending on the Actor's pricing model. For run non-owners: only available for Pay-Per-Event Actors (event costs only). Not available for Pay-Per-Result Actors when you're not the Actor owner.
    """
    usage_usd: Annotated[RunUsageUsd | None, Field(alias='usageUsd')] = None
    """
    Platform usage costs breakdown in USD. Only present if you own the run AND are paying for platform usage (Pay-Per-Usage, Rental, or Pay-Per-Event with usage costs like standby Actors). Not available for standard Pay-Per-Event Actors or Pay-Per-Result Actors owned by others.
    """
    metamorphs: list[Metamorph] | None = None
    """
    List of metamorph events that occurred during the run.
    """


class RunResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: Run


class TaskStats(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    total_runs: Annotated[int | None, Field(alias='totalRuns', examples=[15])] = None


class TaskShort(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['zdc3Pyhyz3m8vjDeM'])]
    user_id: Annotated[str, Field(alias='userId', examples=['wRsJZtadYvn4mBZmm'])]
    act_id: Annotated[str, Field(alias='actId', examples=['asADASadYvn4mBZmm'])]
    act_name: Annotated[str | None, Field(alias='actName', examples=['my-actor'])] = None
    name: Annotated[str, Field(examples=['my-task'])]
    username: Annotated[str | None, Field(examples=['janedoe'])] = None
    act_username: Annotated[str | None, Field(alias='actUsername', examples=['janedoe'])] = None
    created_at: Annotated[AwareDatetime, Field(alias='createdAt', examples=['2018-10-26T07:23:14.855Z'])]
    modified_at: Annotated[AwareDatetime, Field(alias='modifiedAt', examples=['2018-10-26T13:30:49.578Z'])]
    stats: TaskStats | None = None


class ListOfTasks(PaginationResponse):
    model_config = ConfigDict(
        extra='allow',
    )
    items: list[TaskShort]


class ListOfTasksResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: ListOfTasks


class TaskOptions(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    build: Annotated[str | None, Field(examples=['latest'])] = None
    timeout_secs: Annotated[int | None, Field(alias='timeoutSecs', examples=[300])] = None
    memory_mbytes: Annotated[int | None, Field(alias='memoryMbytes', examples=[128])] = None
    restart_on_error: Annotated[bool | None, Field(alias='restartOnError', examples=[False])] = None


class TaskInput(BaseModel):
    """The input configuration for the Actor task. This is a user-defined JSON object
    that will be passed to the Actor when the task is run.

    """

    model_config = ConfigDict(
        extra='allow',
    )


class CreateTaskRequest(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    act_id: Annotated[str, Field(alias='actId', examples=['asADASadYvn4mBZmm'])]
    name: Annotated[str, Field(examples=['my-task'])]
    options: TaskOptions | None = None
    input: TaskInput | None = None


class Task(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['zdc3Pyhyz3m8vjDeM'])]
    user_id: Annotated[str, Field(alias='userId', examples=['wRsJZtadYvn4mBZmm'])]
    act_id: Annotated[str, Field(alias='actId', examples=['asADASadYvn4mBZmm'])]
    name: Annotated[str, Field(examples=['my-task'])]
    username: Annotated[str | None, Field(examples=['janedoe'])] = None
    created_at: Annotated[AwareDatetime, Field(alias='createdAt', examples=['2018-10-26T07:23:14.855Z'])]
    modified_at: Annotated[AwareDatetime, Field(alias='modifiedAt', examples=['2018-10-26T13:30:49.578Z'])]
    removed_at: Annotated[AwareDatetime | None, Field(alias='removedAt')] = None
    stats: TaskStats | None = None
    options: TaskOptions | None = None
    input: TaskInput | None = None
    standby_url: Annotated[AnyUrl | None, Field(alias='standbyUrl')] = None


class TaskResponse(BaseModel):
    """Response containing Actor task data."""

    model_config = ConfigDict(
        extra='allow',
    )
    data: Task


class UpdateTaskRequest(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['ZxLNxrRaZrSjuhT9y'])]
    user_id: Annotated[str, Field(alias='userId', examples=['BPWZBd7Z9c746JAnF'])]
    act_id: Annotated[str, Field(alias='actId', examples=['asADASadYvn4mBZmm'])]
    name: Annotated[str, Field(examples=['my-task'])]
    username: Annotated[str | None, Field(examples=['janedoe'])] = None
    created_at: Annotated[AwareDatetime, Field(alias='createdAt', examples=['2018-10-26T07:23:14.855Z'])]
    modified_at: Annotated[AwareDatetime, Field(alias='modifiedAt', examples=['2018-10-26T13:30:49.578Z'])]
    removed_at: Annotated[AwareDatetime | None, Field(alias='removedAt')] = None
    stats: TaskStats | None = None
    options: TaskOptions | None = None
    input: TaskInput | None = None


class Webhook(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['YiKoxjkaS9gjGTqhF'])]
    created_at: Annotated[AwareDatetime, Field(alias='createdAt', examples=['2019-12-12T07:34:14.202Z'])]
    modified_at: Annotated[AwareDatetime, Field(alias='modifiedAt', examples=['2019-12-13T08:36:13.202Z'])]
    user_id: Annotated[str, Field(alias='userId', examples=['wRsJZtadYvn4mBZmm'])]
    is_ad_hoc: Annotated[bool | None, Field(alias='isAdHoc', examples=[False])] = None
    should_interpolate_strings: Annotated[bool | None, Field(alias='shouldInterpolateStrings', examples=[False])] = None
    event_types: Annotated[list[WebhookEventType], Field(alias='eventTypes', examples=[['ACTOR.RUN.SUCCEEDED']])]
    condition: WebhookCondition
    ignore_ssl_errors: Annotated[bool, Field(alias='ignoreSslErrors', examples=[False])]
    do_not_retry: Annotated[bool | None, Field(alias='doNotRetry', examples=[False])] = None
    request_url: Annotated[AnyUrl, Field(alias='requestUrl', examples=['http://example.com/'])]
    payload_template: Annotated[
        str | None, Field(alias='payloadTemplate', examples=['{\\n "userId": {{userId}}...'])
    ] = None
    headers_template: Annotated[
        str | None, Field(alias='headersTemplate', examples=['{\\n "Authorization": "Bearer ..."}'])
    ] = None
    description: Annotated[str | None, Field(examples=['this is webhook description'])] = None
    last_dispatch: Annotated[ExampleWebhookDispatch | None, Field(alias='lastDispatch')] = None
    stats: WebhookStats | None = None


class UpdateRunRequest(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    run_id: Annotated[str | None, Field(alias='runId', examples=['3KH8gEpp4d8uQSe8T'])] = None
    status_message: Annotated[str | None, Field(alias='statusMessage', examples=['Actor has finished'])] = None
    is_status_message_terminal: Annotated[bool | None, Field(alias='isStatusMessageTerminal', examples=[True])] = None
    general_access: Annotated[GeneralAccess | None, Field(alias='generalAccess')] = None


class ChargeRunRequest(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    event_name: Annotated[str, Field(alias='eventName', examples=['ANALYZE_PAGE'])]
    count: Annotated[int, Field(examples=[1])]


class StorageOwnership(StrEnum):
    OWNED_BY_ME = 'ownedByMe'
    SHARED_WITH_ME = 'sharedWithMe'


class KeyValueStoreStats(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    read_count: Annotated[int, Field(alias='readCount', examples=[9])]
    write_count: Annotated[int, Field(alias='writeCount', examples=[3])]
    delete_count: Annotated[int, Field(alias='deleteCount', examples=[6])]
    list_count: Annotated[int, Field(alias='listCount', examples=[2])]
    s3_storage_bytes: Annotated[int | None, Field(alias='s3StorageBytes', examples=[18])] = None


class KeyValueStore(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['WkzbQMuFYuamGv3YF'])]
    name: Annotated[str | None, Field(examples=['d7b9MDYsbtX5L7XAj'])] = None
    user_id: Annotated[str | None, Field(alias='userId', examples=['BPWDBd7Z9c746JAnF'])] = None
    username: Annotated[str | None, Field(examples=['janedoe'])] = None
    created_at: Annotated[AwareDatetime, Field(alias='createdAt', examples=['2019-12-12T07:34:14.202Z'])]
    modified_at: Annotated[AwareDatetime, Field(alias='modifiedAt', examples=['2019-12-13T08:36:13.202Z'])]
    accessed_at: Annotated[AwareDatetime, Field(alias='accessedAt', examples=['2019-12-14T08:36:13.202Z'])]
    act_id: Annotated[str | None, Field(alias='actId', examples=[None])] = None
    act_run_id: Annotated[str | None, Field(alias='actRunId', examples=[None])] = None
    console_url: Annotated[
        AnyUrl | None,
        Field(alias='consoleUrl', examples=['https://console.apify.com/storage/key-value-stores/27TmTznX9YPeAYhkC']),
    ] = None
    keys_public_url: Annotated[
        AnyUrl | None,
        Field(
            alias='keysPublicUrl',
            examples=['https://api.apify.com/v2/key-value-stores/WkzbQMuFYuamGv3YF/keys?signature=abc123'],
        ),
    ] = None
    """
    A public link to access keys of the key-value store directly.
    """
    url_signing_secret_key: Annotated[str | None, Field(alias='urlSigningSecretKey')] = None
    """
    A secret key for generating signed public URLs. It is only provided to clients with WRITE permission for the key-value store.
    """
    general_access: Annotated[GeneralAccess | None, Field(alias='generalAccess')] = None
    stats: KeyValueStoreStats | None = None


class ListOfKeyValueStores(PaginationResponse):
    model_config = ConfigDict(
        extra='allow',
    )
    items: list[KeyValueStore]


class ListOfKeyValueStoresResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: ListOfKeyValueStores


class KeyValueStoreResponse(BaseModel):
    """Response containing key-value store data."""

    model_config = ConfigDict(
        extra='allow',
    )
    data: KeyValueStore


class UpdateStoreRequest(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    name: str | None = None
    general_access: Annotated[GeneralAccess | None, Field(alias='generalAccess')] = None


class KeyValueStoreKey(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    key: Annotated[str, Field(examples=['second-key'])]
    size: Annotated[int, Field(examples=[36])]
    record_public_url: Annotated[
        AnyUrl,
        Field(
            alias='recordPublicUrl',
            examples=['https://api.apify.com/v2/key-value-stores/WkzbQMuFYuamGv3YF/records/some-key?signature=abc123'],
        ),
    ]
    """
    A public link to access this record directly.
    """


class ListOfKeys(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    items: list[KeyValueStoreKey]
    count: Annotated[int, Field(examples=[2])]
    limit: Annotated[int, Field(examples=[2])]
    exclusive_start_key: Annotated[str | None, Field(alias='exclusiveStartKey', examples=['some-key'])] = None
    is_truncated: Annotated[bool, Field(alias='isTruncated', examples=[True])]
    next_exclusive_start_key: Annotated[str | None, Field(alias='nextExclusiveStartKey', examples=['third-key'])] = None


class ListOfKeysResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: ListOfKeys


class RecordResponse(BaseModel):
    """The response body contains the value of the record. The content type of the response
    is determined by the Content-Type header stored with the record.

    """

    model_config = ConfigDict(
        extra='allow',
    )


class PutRecordRequest(BaseModel):
    """The request body contains the value to store in the record. The content type
    should be specified in the Content-Type header.

    """

    model_config = ConfigDict(
        extra='allow',
    )


class DatasetListItem(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['WkzbQMuFYuamGv3YF'])]
    name: Annotated[str, Field(examples=['d7b9MDYsbtX5L7XAj'])]
    user_id: Annotated[str, Field(alias='userId', examples=['tbXmWu7GCxnyYtSiL'])]
    created_at: Annotated[AwareDatetime, Field(alias='createdAt', examples=['2019-12-12T07:34:14.202Z'])]
    modified_at: Annotated[AwareDatetime, Field(alias='modifiedAt', examples=['2019-12-13T08:36:13.202Z'])]
    accessed_at: Annotated[AwareDatetime, Field(alias='accessedAt', examples=['2019-12-14T08:36:13.202Z'])]
    item_count: Annotated[int, Field(alias='itemCount', examples=[7])]
    clean_item_count: Annotated[int, Field(alias='cleanItemCount', examples=[5])]
    act_id: Annotated[str | None, Field(alias='actId')] = None
    act_run_id: Annotated[str | None, Field(alias='actRunId')] = None


class ListOfDatasets(PaginationResponse):
    model_config = ConfigDict(
        extra='allow',
    )
    items: list[DatasetListItem]


class ListOfDatasetsResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: ListOfDatasets


class DatasetStats(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    read_count: Annotated[int, Field(alias='readCount', examples=[22])]
    write_count: Annotated[int, Field(alias='writeCount', examples=[3])]
    storage_bytes: Annotated[int, Field(alias='storageBytes', examples=[783])]


class Dataset(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['WkzbQMuFYuamGv3YF'])]
    name: Annotated[str | None, Field(examples=['d7b9MDYsbtX5L7XAj'])] = None
    user_id: Annotated[str, Field(alias='userId', examples=['wRsJZtadYvn4mBZmm'])]
    created_at: Annotated[AwareDatetime, Field(alias='createdAt', examples=['2019-12-12T07:34:14.202Z'])]
    modified_at: Annotated[AwareDatetime, Field(alias='modifiedAt', examples=['2019-12-13T08:36:13.202Z'])]
    accessed_at: Annotated[AwareDatetime, Field(alias='accessedAt', examples=['2019-12-14T08:36:13.202Z'])]
    item_count: Annotated[int, Field(alias='itemCount', examples=[7], ge=0)]
    clean_item_count: Annotated[int, Field(alias='cleanItemCount', examples=[5], ge=0)]
    act_id: Annotated[str | None, Field(alias='actId')] = None
    act_run_id: Annotated[str | None, Field(alias='actRunId')] = None
    fields: list[str] | None = None
    schema_: Annotated[
        dict[str, Any] | None,
        Field(
            alias='schema',
            examples=[
                {
                    'actorSpecification': 1,
                    'title': 'My dataset',
                    'views': {
                        'overview': {
                            'title': 'Overview',
                            'transformation': {'fields': ['linkUrl']},
                            'display': {
                                'component': 'table',
                                'properties': {'linkUrl': {'label': 'Link URL', 'format': 'link'}},
                            },
                        }
                    },
                }
            ],
        ),
    ] = None
    """
    Defines the schema of items in your dataset, the full specification can be found in [Apify docs](/platform/actors/development/actor-definition/dataset-schema)
    """
    console_url: Annotated[
        AnyUrl, Field(alias='consoleUrl', examples=['https://console.apify.com/storage/datasets/27TmTznX9YPeAYhkC'])
    ]
    items_public_url: Annotated[
        AnyUrl | None,
        Field(
            alias='itemsPublicUrl',
            examples=['https://api.apify.com/v2/datasets/WkzbQMuFYuamGv3YF/items?signature=abc123'],
        ),
    ] = None
    """
    A public link to access the dataset items directly.
    """
    url_signing_secret_key: Annotated[str | None, Field(alias='urlSigningSecretKey')] = None
    """
    A secret key for generating signed public URLs. It is only provided to clients with WRITE permission for the dataset.
    """
    general_access: Annotated[GeneralAccess | None, Field(alias='generalAccess')] = None
    stats: DatasetStats | None = None


class DatasetResponse(BaseModel):
    """Response containing dataset metadata."""

    model_config = ConfigDict(
        extra='allow',
    )
    data: Dataset


class UpdateDatasetRequest(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    name: str | None = None
    general_access: Annotated[GeneralAccess | None, Field(alias='generalAccess')] = None


class PutItemsRequest(BaseModel):
    """The request body containing the item(s) to add to the dataset. Can be a single
    object or an array of objects. Each object represents one dataset item.

    """

    model_config = ConfigDict(
        extra='allow',
    )


class ValidationError(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    instance_path: Annotated[str | None, Field(alias='instancePath')] = None
    """
    The path to the instance being validated.
    """
    schema_path: Annotated[str | None, Field(alias='schemaPath')] = None
    """
    The path to the schema that failed the validation.
    """
    keyword: str | None = None
    """
    The validation keyword that caused the error.
    """
    message: str | None = None
    """
    A message describing the validation error.
    """
    params: dict[str, Any] | None = None
    """
    Additional parameters specific to the validation error.
    """


class InvalidItem(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    item_position: Annotated[int | None, Field(alias='itemPosition', examples=[2])] = None
    """
    The position of the invalid item in the array.
    """
    validation_errors: Annotated[list[ValidationError] | None, Field(alias='validationErrors')] = None
    """
    A complete list of AJV validation error objects for the invalid item.
    """


class SchemaValidationErrorData(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    invalid_items: Annotated[list[InvalidItem], Field(alias='invalidItems')]
    """
    A list of invalid items in the received array of items.
    """


class DatasetSchemaValidationError(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    type: Annotated[str | None, Field(examples=['schema-validation-error'])] = None
    """
    The type of the error.
    """
    message: Annotated[str | None, Field(examples=['Schema validation failed'])] = None
    """
    A human-readable message describing the error.
    """
    data: SchemaValidationErrorData | None = None


class PutItemResponseError(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    error: DatasetSchemaValidationError


class DatasetFieldStatistics(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    min: float | None = None
    """
    Minimum value of the field. For numbers, this is calculated directly. For strings, this is the length of the shortest string. For arrays, this is the length of the shortest array. For objects, this is the number of keys in the smallest object.
    """
    max: float | None = None
    """
    Maximum value of the field. For numbers, this is calculated directly. For strings, this is the length of the longest string. For arrays, this is the length of the longest array. For objects, this is the number of keys in the largest object.
    """
    null_count: Annotated[int | None, Field(alias='nullCount')] = None
    """
    How many items in the dataset have a null value for this field.
    """
    empty_count: Annotated[int | None, Field(alias='emptyCount')] = None
    """
    How many items in the dataset are `undefined`, meaning that for example empty string is not considered empty.
    """


class DatasetStatistics(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    field_statistics: Annotated[dict[str, Any] | None, Field(alias='fieldStatistics')] = None
    """
    When you configure the dataset [fields schema](https://docs.apify.com/platform/actors/development/actor-definition/dataset-schema/validation), we measure the statistics such as `min`, `max`, `nullCount` and `emptyCount` for each field. This property provides statistics for each field from dataset fields schema. <br/></br>See dataset field statistics [documentation](https://docs.apify.com/platform/actors/development/actor-definition/dataset-schema/validation#dataset-field-statistics) for more information.
    """


class DatasetStatisticsResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: DatasetStatistics


class RequestQueueShort(BaseModel):
    """A shortened request queue object for list responses."""

    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['WkzbQMuFYuamGv3YF'])]
    """
    A unique identifier assigned to the request queue.
    """
    name: Annotated[str, Field(examples=['some-name'])]
    """
    The name of the request queue.
    """
    user_id: Annotated[str, Field(alias='userId', examples=['wRsJZtadYvn4mBZmm'])]
    """
    The ID of the user who owns the request queue.
    """
    username: Annotated[str, Field(examples=['janedoe'])]
    """
    The username of the user who owns the request queue.
    """
    created_at: Annotated[AwareDatetime, Field(alias='createdAt', examples=['2019-12-12T07:34:14.202Z'])]
    """
    The timestamp when the request queue was created.
    """
    modified_at: Annotated[AwareDatetime, Field(alias='modifiedAt', examples=['2019-12-13T08:36:13.202Z'])]
    """
    The timestamp when the request queue was last modified.
    """
    accessed_at: Annotated[AwareDatetime, Field(alias='accessedAt', examples=['2019-12-14T08:36:13.202Z'])]
    """
    The timestamp when the request queue was last accessed.
    """
    expire_at: Annotated[AwareDatetime | None, Field(alias='expireAt', examples=['2019-06-02T17:15:06.751Z'])] = None
    """
    The timestamp when the request queue will expire and be deleted.
    """
    total_request_count: Annotated[int, Field(alias='totalRequestCount', examples=[100])]
    """
    The total number of requests in the request queue.
    """
    handled_request_count: Annotated[int, Field(alias='handledRequestCount', examples=[50])]
    """
    The number of requests that have been handled.
    """
    pending_request_count: Annotated[int, Field(alias='pendingRequestCount', examples=[50])]
    """
    The number of requests that are pending and have not been handled yet.
    """
    act_id: Annotated[str | None, Field(alias='actId')] = None
    """
    The ID of the Actor that created this request queue.
    """
    act_run_id: Annotated[str | None, Field(alias='actRunId')] = None
    """
    The ID of the Actor run that created this request queue.
    """
    had_multiple_clients: Annotated[bool, Field(alias='hadMultipleClients', examples=[True])]
    """
    Whether the request queue has been accessed by multiple different clients.
    """


class ListOfRequestQueues(PaginationResponse):
    """A paginated list of request queues."""

    model_config = ConfigDict(
        extra='allow',
    )
    items: list[RequestQueueShort]
    """
    The array of request queues.
    """


class ListOfRequestQueuesResponse(BaseModel):
    """Response containing a list of request queues."""

    model_config = ConfigDict(
        extra='allow',
    )
    data: ListOfRequestQueues


class RequestQueueStats(BaseModel):
    """Statistics about request queue operations and storage."""

    model_config = ConfigDict(
        extra='allow',
    )
    delete_count: Annotated[int | None, Field(alias='deleteCount', examples=[0])] = None
    """
    The number of delete operations performed on the request queue.
    """
    head_item_read_count: Annotated[int | None, Field(alias='headItemReadCount', examples=[5])] = None
    """
    The number of times requests from the head were read.
    """
    read_count: Annotated[int | None, Field(alias='readCount', examples=[100])] = None
    """
    The total number of read operations performed on the request queue.
    """
    storage_bytes: Annotated[int | None, Field(alias='storageBytes', examples=[1024])] = None
    """
    The total storage size in bytes used by the request queue.
    """
    write_count: Annotated[int | None, Field(alias='writeCount', examples=[10])] = None
    """
    The total number of write operations performed on the request queue.
    """


class RequestQueue(BaseModel):
    """A request queue object containing metadata and statistics."""

    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['WkzbQMuFYuamGv3YF'])]
    """
    A unique identifier assigned to the request queue.
    """
    name: Annotated[str | None, Field(examples=['some-name'])] = None
    """
    The name of the request queue.
    """
    user_id: Annotated[str, Field(alias='userId', examples=['wRsJZtadYvn4mBZmm'])]
    """
    The ID of the user who owns the request queue.
    """
    created_at: Annotated[AwareDatetime, Field(alias='createdAt', examples=['2019-12-12T07:34:14.202Z'])]
    """
    The timestamp when the request queue was created.
    """
    modified_at: Annotated[AwareDatetime, Field(alias='modifiedAt', examples=['2030-12-13T08:36:13.202Z'])]
    """
    The timestamp when the request queue was last modified. Modifications include adding, updating, or removing requests, as well as locking or unlocking requests in the request queue.
    """
    accessed_at: Annotated[AwareDatetime, Field(alias='accessedAt', examples=['2019-12-14T08:36:13.202Z'])]
    """
    The timestamp when the request queue was last accessed.
    """
    total_request_count: Annotated[int, Field(alias='totalRequestCount', examples=[870], ge=0)]
    """
    The total number of requests in the request queue.
    """
    handled_request_count: Annotated[int, Field(alias='handledRequestCount', examples=[100], ge=0)]
    """
    The number of requests that have been handled.
    """
    pending_request_count: Annotated[int, Field(alias='pendingRequestCount', examples=[670], ge=0)]
    """
    The number of requests that are pending and have not been handled yet.
    """
    had_multiple_clients: Annotated[bool, Field(alias='hadMultipleClients', examples=[True])]
    """
    Whether the request queue has been accessed by multiple different clients.
    """
    console_url: Annotated[
        AnyUrl, Field(alias='consoleUrl', examples=['https://api.apify.com/v2/request-queues/27TmTznX9YPeAYhkC'])
    ]
    """
    The URL to view the request queue in the Apify console.
    """
    stats: RequestQueueStats | None = None
    general_access: Annotated[GeneralAccess | None, Field(alias='generalAccess')] = None


class RequestQueueResponse(BaseModel):
    """Response containing request queue data."""

    model_config = ConfigDict(
        extra='allow',
    )
    data: RequestQueue


class UpdateRequestQueueRequest(BaseModel):
    """Request object for updating a request queue."""

    model_config = ConfigDict(
        extra='allow',
    )
    name: str | None = None
    """
    The new name for the request queue.
    """
    general_access: Annotated[GeneralAccess | None, Field(alias='generalAccess')] = None


class RequestDraft(BaseModel):
    """A request that failed to be processed during a request queue operation and can be retried."""

    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str | None, Field(examples=['sbJ7klsdf7ujN9l'])] = None
    """
    A unique identifier assigned to the request.
    """
    unique_key: Annotated[str, Field(alias='uniqueKey', examples=['GET|60d83e70|e3b0c442|https://apify.com'])]
    """
    A unique key used for request de-duplication. Requests with the same unique key are considered identical.
    """
    url: Annotated[AnyUrl, Field(examples=['https://apify.com'])]
    """
    The URL of the request.
    """
    method: Annotated[str, Field(examples=['GET'])]
    """
    The HTTP method of the request.
    """


class AddedRequest(BaseModel):
    """Information about a request that was successfully added to a request queue."""

    model_config = ConfigDict(
        extra='allow',
    )
    request_id: Annotated[str, Field(alias='requestId', examples=['sbJ7klsdf7ujN9l'])]
    """
    A unique identifier assigned to the request.
    """
    unique_key: Annotated[str, Field(alias='uniqueKey', examples=['GET|60d83e70|e3b0c442|https://apify.com'])]
    """
    A unique key used for request de-duplication. Requests with the same unique key are considered identical.
    """
    was_already_present: Annotated[bool, Field(alias='wasAlreadyPresent', examples=[False])]
    """
    Indicates whether a request with the same unique key already existed in the request queue. If true, no new request was created.
    """
    was_already_handled: Annotated[bool, Field(alias='wasAlreadyHandled', examples=[False])]
    """
    Indicates whether a request with the same unique key has already been processed by the request queue.
    """


class BatchAddResult(BaseModel):
    """Result of a batch add operation containing successfully processed and failed requests."""

    model_config = ConfigDict(
        extra='allow',
    )
    processed_requests: Annotated[list[AddedRequest], Field(alias='processedRequests')]
    """
    Requests that were successfully added to the request queue.
    """
    unprocessed_requests: Annotated[list[RequestDraft], Field(alias='unprocessedRequests')]
    """
    Requests that failed to be added and can be retried.
    """


class BatchAddResponse(BaseModel):
    """Response containing the result of a batch add operation."""

    model_config = ConfigDict(
        extra='allow',
    )
    data: BatchAddResult


class DeletedRequest(BaseModel):
    """Confirmation of a request that was successfully deleted from a request queue."""

    model_config = ConfigDict(
        extra='allow',
    )
    unique_key: Annotated[str, Field(alias='uniqueKey', examples=['GET|60d83e70|e3b0c442|https://apify.com'])]
    """
    A unique key used for request de-duplication. Requests with the same unique key are considered identical.
    """
    id: Annotated[str | None, Field(examples=['sbJ7klsdf7ujN9l'])] = None
    """
    A unique identifier assigned to the request.
    """


class BatchDeleteResult(BaseModel):
    """Result of a batch delete operation containing successfully deleted and failed requests."""

    model_config = ConfigDict(
        extra='allow',
    )
    processed_requests: Annotated[list[DeletedRequest], Field(alias='processedRequests')]
    """
    Requests that were successfully deleted from the request queue.
    """
    unprocessed_requests: Annotated[list[RequestDraft], Field(alias='unprocessedRequests')]
    """
    Requests that failed to be deleted and can be retried.
    """


class BatchDeleteResponse(BaseModel):
    """Response containing the result of a batch delete operation."""

    model_config = ConfigDict(
        extra='allow',
    )
    data: BatchDeleteResult


class UnlockRequestsResult(BaseModel):
    """Result of unlocking requests in the request queue."""

    model_config = ConfigDict(
        extra='allow',
    )
    unlocked_count: Annotated[int, Field(alias='unlockedCount', examples=[10])]
    """
    Number of requests that were successfully unlocked.
    """


class UnlockRequestsResponse(BaseModel):
    """Response containing the result of unlocking requests."""

    model_config = ConfigDict(
        extra='allow',
    )
    data: UnlockRequestsResult


class RequestUserData(BaseModel):
    """Custom user data attached to the request. Can contain arbitrary fields."""

    model_config = ConfigDict(
        extra='allow',
    )
    label: Annotated[str | None, Field(examples=['DETAIL'])] = None
    """
    Optional label for categorizing the request.
    """
    image: Annotated[AnyUrl | None, Field(examples=['https://picserver1.eu'])] = None
    """
    Optional image URL associated with the request.
    """


class Request(BaseModel):
    """A request stored in the request queue, including its metadata and processing state."""

    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['dnjkDMKLmdlkmlkmld'])]
    """
    A unique identifier assigned to the request.
    """
    unique_key: Annotated[str, Field(alias='uniqueKey', examples=['GET|60d83e70|e3b0c442|https://apify.com/career'])]
    """
    A unique key used for request de-duplication. Requests with the same unique key are considered identical.
    """
    url: Annotated[AnyUrl, Field(examples=['https://apify.com/career'])]
    """
    The URL of the request.
    """
    method: Annotated[str | None, Field(examples=['GET'])] = None
    """
    The HTTP method of the request.
    """
    retry_count: Annotated[int | None, Field(alias='retryCount', examples=[0])] = None
    """
    The number of times this request has been retried.
    """
    loaded_url: Annotated[AnyUrl | None, Field(alias='loadedUrl', examples=['https://apify.com/jobs'])] = None
    """
    The final URL that was loaded, after redirects (if any).
    """
    payload: dict[str, Any] | None = None
    """
    The request payload, typically used with POST or PUT requests.
    """
    headers: dict[str, Any] | None = None
    """
    HTTP headers sent with the request.
    """
    user_data: Annotated[RequestUserData | None, Field(alias='userData')] = None
    no_retry: Annotated[bool | None, Field(alias='noRetry', examples=[False])] = None
    """
    Indicates whether the request should not be retried if processing fails.
    """
    error_messages: Annotated[list[str] | None, Field(alias='errorMessages')] = None
    """
    Error messages recorded from failed processing attempts.
    """
    handled_at: Annotated[AwareDatetime | None, Field(alias='handledAt', examples=['2019-06-16T10:23:31.607Z'])] = None
    """
    The timestamp when the request was marked as handled, if applicable.
    """


class ListOfRequests(BaseModel):
    """A paginated list of requests from the request queue."""

    model_config = ConfigDict(
        extra='allow',
    )
    items: list[Request]
    """
    The array of requests.
    """
    count: Annotated[int | None, Field(examples=[2])] = None
    """
    The total number of requests matching the query.
    """
    limit: Annotated[int, Field(examples=[2])]
    """
    The maximum number of requests returned in this response.
    """
    exclusive_start_id: Annotated[str | None, Field(alias='exclusiveStartId', examples=['Ihnsp8YrvJ8102Kj'])] = None
    """
    The ID of the last request from the previous page, used for pagination.
    """


class ListOfRequestsResponse(BaseModel):
    """Response containing a list of requests from the request queue."""

    model_config = ConfigDict(
        extra='allow',
    )
    data: ListOfRequests


class RequestRegistration(BaseModel):
    """Result of registering a request in the request queue, either by adding a new request or updating an existing one."""

    model_config = ConfigDict(
        extra='allow',
    )
    request_id: Annotated[str, Field(alias='requestId', examples=['YiKoxjkaS9gjGTqhF'])]
    """
    A unique identifier assigned to the request.
    """
    was_already_present: Annotated[bool, Field(alias='wasAlreadyPresent', examples=[False])]
    """
    Indicates whether a request with the same unique key already existed in the request queue. If true, no new request was created.
    """
    was_already_handled: Annotated[bool, Field(alias='wasAlreadyHandled', examples=[False])]
    """
    Indicates whether a request with the same unique key has already been processed by the request queue.
    """


class AddRequestResponse(BaseModel):
    """Response containing the result of adding a request to the request queue."""

    model_config = ConfigDict(
        extra='allow',
    )
    data: RequestRegistration


class RequestResponse(BaseModel):
    """Response containing a single request from the request queue."""

    model_config = ConfigDict(
        extra='allow',
    )
    data: Request


class UpdateRequestResponse(BaseModel):
    """Response containing the result of updating a request in the request queue."""

    model_config = ConfigDict(
        extra='allow',
    )
    data: RequestRegistration


class HeadRequest(BaseModel):
    """A request from the request queue head without lock information."""

    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['8OamqXBCpPHxyH9'])]
    """
    A unique identifier assigned to the request.
    """
    unique_key: Annotated[str, Field(alias='uniqueKey', examples=['GET|60d83e70|e3b0c442|https://apify.com'])]
    """
    A unique key used for request de-duplication. Requests with the same unique key are considered identical.
    """
    url: Annotated[AnyUrl, Field(examples=['https://apify.com'])]
    """
    The URL of the request.
    """
    method: Annotated[str | None, Field(examples=['GET'])] = None
    """
    The HTTP method of the request.
    """
    retry_count: Annotated[int | None, Field(alias='retryCount', examples=[0])] = None
    """
    The number of times this request has been retried.
    """


class RequestQueueHead(BaseModel):
    """A batch of requests from the request queue head without locking."""

    model_config = ConfigDict(
        extra='allow',
    )
    limit: Annotated[int, Field(examples=[1000])]
    """
    The maximum number of requests returned.
    """
    queue_modified_at: Annotated[AwareDatetime, Field(alias='queueModifiedAt', examples=['2018-03-14T23:00:00.000Z'])]
    """
    The timestamp when the request queue was last modified.
    """
    had_multiple_clients: Annotated[bool, Field(alias='hadMultipleClients', examples=[False])]
    """
    Whether the request queue has been accessed by multiple different clients.
    """
    items: list[HeadRequest]
    """
    The array of requests from the request queue head.
    """


class HeadResponse(BaseModel):
    """Response containing requests from the request queue head without locking."""

    model_config = ConfigDict(
        extra='allow',
    )
    data: RequestQueueHead


class LockedHeadRequest(BaseModel):
    """A request from the request queue head that has been locked for processing."""

    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['8OamqXBCpPHxyH9'])]
    """
    A unique identifier assigned to the request.
    """
    unique_key: Annotated[str, Field(alias='uniqueKey', examples=['GET|60d83e70|e3b0c442|https://apify.com'])]
    """
    A unique key used for request de-duplication. Requests with the same unique key are considered identical.
    """
    url: Annotated[AnyUrl, Field(examples=['https://apify.com'])]
    """
    The URL of the request.
    """
    method: Annotated[str | None, Field(examples=['GET'])] = None
    """
    The HTTP method of the request.
    """
    retry_count: Annotated[int | None, Field(alias='retryCount', examples=[0])] = None
    """
    The number of times this request has been retried.
    """
    lock_expires_at: Annotated[AwareDatetime, Field(alias='lockExpiresAt', examples=['2022-06-14T23:00:00.000Z'])]
    """
    The timestamp when the lock on this request expires.
    """


class LockedRequestQueueHead(BaseModel):
    """A batch of locked requests from the request queue head."""

    model_config = ConfigDict(
        extra='allow',
    )
    limit: Annotated[int, Field(examples=[1000])]
    """
    The maximum number of requests returned.
    """
    queue_modified_at: Annotated[AwareDatetime, Field(alias='queueModifiedAt', examples=['2018-03-14T23:00:00.000Z'])]
    """
    The timestamp when the request queue was last modified. Modifications include adding, updating, or removing requests, as well as locking or unlocking requests.
    """
    queue_has_locked_requests: Annotated[bool | None, Field(alias='queueHasLockedRequests', examples=[True])] = None
    """
    Whether the request queue contains requests locked by any client (either the one calling the endpoint or a different one).
    """
    client_key: Annotated[str | None, Field(alias='clientKey', examples=['client-one'])] = None
    """
    The client key used for locking the requests.
    """
    had_multiple_clients: Annotated[bool, Field(alias='hadMultipleClients', examples=[True])]
    """
    Whether the request queue has been accessed by multiple different clients.
    """
    lock_secs: Annotated[int, Field(alias='lockSecs', examples=[60])]
    """
    The number of seconds the locks will be held.
    """
    items: list[LockedHeadRequest]
    """
    The array of locked requests from the request queue head.
    """


class HeadAndLockResponse(BaseModel):
    """Response containing locked requests from the request queue head."""

    model_config = ConfigDict(
        extra='allow',
    )
    data: LockedRequestQueueHead


class RequestLockInfo(BaseModel):
    """Information about a request lock."""

    model_config = ConfigDict(
        extra='allow',
    )
    lock_expires_at: Annotated[AwareDatetime, Field(alias='lockExpiresAt', examples=['2022-01-01T00:00:00.000Z'])]
    """
    The timestamp when the lock expires.
    """


class ProlongRequestLockResponse(BaseModel):
    """Response containing updated lock information after prolonging a request lock."""

    model_config = ConfigDict(
        extra='allow',
    )
    data: RequestLockInfo


class WebhookCreate(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    is_ad_hoc: Annotated[bool | None, Field(alias='isAdHoc', examples=[False])] = None
    event_types: Annotated[list[WebhookEventType], Field(alias='eventTypes', examples=[['ACTOR.RUN.SUCCEEDED']])]
    condition: WebhookCondition
    idempotency_key: Annotated[str | None, Field(alias='idempotencyKey', examples=['fdSJmdP3nfs7sfk3y'])] = None
    ignore_ssl_errors: Annotated[bool | None, Field(alias='ignoreSslErrors', examples=[False])] = None
    do_not_retry: Annotated[bool | None, Field(alias='doNotRetry', examples=[False])] = None
    request_url: Annotated[AnyUrl, Field(alias='requestUrl', examples=['http://example.com/'])]
    payload_template: Annotated[
        str | None, Field(alias='payloadTemplate', examples=['{\\n "userId": {{userId}}...'])
    ] = None
    headers_template: Annotated[
        str | None, Field(alias='headersTemplate', examples=['{\\n "Authorization": "Bearer ..."}'])
    ] = None
    description: Annotated[str | None, Field(examples=['this is webhook description'])] = None
    should_interpolate_strings: Annotated[bool | None, Field(alias='shouldInterpolateStrings', examples=[False])] = None


class WebhookResponse(BaseModel):
    """Response containing webhook data."""

    model_config = ConfigDict(
        extra='allow',
    )
    data: Webhook


class WebhookUpdate(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    is_ad_hoc: Annotated[bool | None, Field(alias='isAdHoc', examples=[False])] = None
    event_types: Annotated[
        list[WebhookEventType] | None, Field(alias='eventTypes', examples=[['ACTOR.RUN.SUCCEEDED']])
    ] = None
    condition: WebhookCondition | None = None
    ignore_ssl_errors: Annotated[bool | None, Field(alias='ignoreSslErrors', examples=[False])] = None
    do_not_retry: Annotated[bool | None, Field(alias='doNotRetry', examples=[False])] = None
    request_url: Annotated[AnyUrl | None, Field(alias='requestUrl', examples=['http://example.com/'])] = None
    payload_template: Annotated[
        str | None, Field(alias='payloadTemplate', examples=['{\\n "userId": {{userId}}...'])
    ] = None
    headers_template: Annotated[
        str | None, Field(alias='headersTemplate', examples=['{\\n "Authorization": "Bearer ..."}'])
    ] = None
    description: Annotated[str | None, Field(examples=['this is webhook description'])] = None
    should_interpolate_strings: Annotated[bool | None, Field(alias='shouldInterpolateStrings', examples=[False])] = None


class EventData(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    actor_id: Annotated[str, Field(alias='actorId', examples=['vvE7iMKuMc5qTHHsR'])]
    actor_run_id: Annotated[str, Field(alias='actorRunId', examples=['JgwXN9BdwxGcu9MMF'])]


class Call(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    started_at: Annotated[AwareDatetime | None, Field(alias='startedAt', examples=['2019-12-12T07:34:14.202Z'])] = None
    finished_at: Annotated[AwareDatetime | None, Field(alias='finishedAt', examples=['2019-12-12T07:34:14.202Z'])] = (
        None
    )
    error_message: Annotated[str | None, Field(alias='errorMessage', examples=['Cannot send request'])] = None
    response_status: Annotated[int | None, Field(alias='responseStatus', examples=[200])] = None
    response_body: Annotated[str | None, Field(alias='responseBody', examples=['{"foo": "bar"}'])] = None


class WebhookDispatch(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['asdLZtadYvn4mBZmm'])]
    user_id: Annotated[str, Field(alias='userId', examples=['wRsJZtadYvn4mBZmm'])]
    webhook_id: Annotated[str, Field(alias='webhookId', examples=['asdLZtadYvn4mBZmm'])]
    created_at: Annotated[AwareDatetime, Field(alias='createdAt', examples=['2019-12-12T07:34:14.202Z'])]
    status: WebhookDispatchStatus
    event_type: Annotated[WebhookEventType, Field(alias='eventType')]
    event_data: Annotated[EventData | None, Field(alias='eventData', title='eventData')] = None
    calls: Annotated[list[Call] | None, Field(title='calls')] = None


class TestWebhookResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: WebhookDispatch


class ListOfWebhookDispatches(PaginationResponse):
    model_config = ConfigDict(
        extra='allow',
    )
    items: list[WebhookDispatch]


class WebhookDispatchList(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: ListOfWebhookDispatches | None = None


class WebhookDispatchResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: WebhookDispatch


class ScheduleActionType(StrEnum):
    """Type of action to perform when the schedule triggers."""

    RUN_ACTOR = 'RUN_ACTOR'
    RUN_ACTOR_TASK = 'RUN_ACTOR_TASK'


class ScheduleAction(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['ZReCs7hkdieq8ZUki'])]
    type: ScheduleActionType
    actor_id: Annotated[str, Field(alias='actorId', examples=['HKhKmiCMrDgu9eXeE'])]


class ScheduleShort(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['asdLZtadYvn4mBZmm'])]
    user_id: Annotated[str, Field(alias='userId', examples=['wRsJZtadYvn4mBZmm'])]
    name: Annotated[str, Field(examples=['my-schedule'])]
    created_at: Annotated[AwareDatetime, Field(alias='createdAt', examples=['2019-12-12T07:34:14.202Z'])]
    modified_at: Annotated[AwareDatetime, Field(alias='modifiedAt', examples=['2019-12-20T06:33:11.202Z'])]
    last_run_at: Annotated[AwareDatetime | None, Field(alias='lastRunAt', examples=['2019-04-12T07:33:10.202Z'])] = None
    next_run_at: Annotated[AwareDatetime | None, Field(alias='nextRunAt', examples=['2019-04-12T07:34:10.202Z'])] = None
    is_enabled: Annotated[bool, Field(alias='isEnabled', examples=[True])]
    is_exclusive: Annotated[bool, Field(alias='isExclusive', examples=[True])]
    cron_expression: Annotated[str, Field(alias='cronExpression', examples=['* * * * *'])]
    timezone: Annotated[str, Field(examples=['UTC'])]
    actions: list[ScheduleAction]


class ListOfSchedules(PaginationResponse):
    model_config = ConfigDict(
        extra='allow',
    )
    items: list[ScheduleShort]


class ListOfSchedulesResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: ListOfSchedules


class ScheduleActionsRunInput(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    body: Annotated[str | None, Field(examples=['{\\n   "foo": "actor"\\n}'])] = None
    content_type: Annotated[str | None, Field(alias='contentType', examples=['application/json; charset=utf-8'])] = None


class ScheduleActionsRunOptions(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    build: Annotated[str | None, Field(examples=['latest'])] = None
    timeout_secs: Annotated[int | None, Field(alias='timeoutSecs', examples=[60])] = None
    memory_mbytes: Annotated[int | None, Field(alias='memoryMbytes', examples=[1024])] = None
    restart_on_error: Annotated[bool | None, Field(alias='restartOnError', examples=[False])] = None


class ScheduleCreateActions(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    type: ScheduleActionType
    actor_id: Annotated[str, Field(alias='actorId', examples=['jF8GGEvbEg4Au3NLA'])]
    run_input: Annotated[ScheduleActionsRunInput | None, Field(alias='runInput')] = None
    run_options: Annotated[ScheduleActionsRunOptions | None, Field(alias='runOptions')] = None


class ScheduleCreate(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    name: Annotated[str | None, Field(examples=['my-schedule'])] = None
    is_enabled: Annotated[bool | None, Field(alias='isEnabled', examples=[True])] = None
    is_exclusive: Annotated[bool | None, Field(alias='isExclusive', examples=[True])] = None
    cron_expression: Annotated[str | None, Field(alias='cronExpression', examples=['* * * * *'])] = None
    timezone: Annotated[str | None, Field(examples=['UTC'])] = None
    description: Annotated[str | None, Field(examples=['Schedule of actor ...'])] = None
    actions: list[ScheduleCreateActions] | None = None


class ScheduleActions(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['c6KfSgoQzFhMk3etc'])]
    type: ScheduleActionType
    actor_id: Annotated[str, Field(alias='actorId', examples=['jF8GGEvbEg4Au3NLA'])]
    run_input: Annotated[ScheduleActionsRunInput | None, Field(alias='runInput')] = None
    run_options: Annotated[ScheduleActionsRunOptions | None, Field(alias='runOptions')] = None


class Schedule(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['asdLZtadYvn4mBZmm'])]
    user_id: Annotated[str, Field(alias='userId', examples=['wRsJZtadYvn4mBZmm'])]
    name: Annotated[str, Field(examples=['my-schedule'])]
    cron_expression: Annotated[str, Field(alias='cronExpression', examples=['* * * * *'])]
    timezone: Annotated[str, Field(examples=['UTC'])]
    is_enabled: Annotated[bool, Field(alias='isEnabled', examples=[True])]
    is_exclusive: Annotated[bool, Field(alias='isExclusive', examples=[True])]
    description: Annotated[str | None, Field(examples=['Schedule of actor ...'])] = None
    created_at: Annotated[AwareDatetime, Field(alias='createdAt', examples=['2019-12-12T07:34:14.202Z'])]
    modified_at: Annotated[AwareDatetime, Field(alias='modifiedAt', examples=['2019-12-20T06:33:11.202Z'])]
    next_run_at: Annotated[AwareDatetime | None, Field(alias='nextRunAt', examples=['2019-04-12T07:34:10.202Z'])] = None
    last_run_at: Annotated[AwareDatetime | None, Field(alias='lastRunAt', examples=['2019-04-12T07:33:10.202Z'])] = None
    actions: list[ScheduleActions]


class ScheduleResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: Schedule


class ScheduleInvoked(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    message: Annotated[str, Field(examples=['Schedule invoked'])]
    level: Annotated[str, Field(examples=['INFO'])]
    created_at: Annotated[AwareDatetime, Field(alias='createdAt', examples=['2019-03-26T12:28:00.370Z'])]


class ScheduleLogResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: list[ScheduleInvoked]


class CurrentPricingInfo(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    pricing_model: Annotated[str, Field(alias='pricingModel', examples=['FREE'])]


class StoreListActor(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['zdc3Pyhyz3m8vjDeM'])]
    title: Annotated[str, Field(examples=['My Public Actor'])]
    name: Annotated[str, Field(examples=['my-public-actor'])]
    username: Annotated[str, Field(examples=['jane35'])]
    user_full_name: Annotated[str, Field(alias='userFullName', examples=['Jane H. Doe'])]
    description: Annotated[str, Field(examples=['My public actor!'])]
    categories: Annotated[list[str] | None, Field(examples=[['MARKETING', 'LEAD_GENERATION']])] = None
    notice: str | None = None
    picture_url: Annotated[AnyUrl | None, Field(alias='pictureUrl', examples=['https://...'])] = None
    user_picture_url: Annotated[AnyUrl | None, Field(alias='userPictureUrl', examples=['https://...'])] = None
    url: Annotated[AnyUrl | None, Field(examples=['https://...'])] = None
    stats: ActorStats
    current_pricing_info: Annotated[CurrentPricingInfo, Field(alias='currentPricingInfo')]
    is_white_listed_for_agentic_payment: Annotated[bool | None, Field(alias='isWhiteListedForAgenticPayment')] = None
    """
    Whether the Actor is whitelisted for agentic payment processing.
    """
    readme_summary: Annotated[str | None, Field(alias='readmeSummary')] = None
    """
    A brief, LLM-generated readme summary
    """


class ListOfStoreActors(PaginationResponse):
    model_config = ConfigDict(
        extra='allow',
    )
    items: list[StoreListActor]


class ListOfActorsInStoreResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: ListOfStoreActors


class Profile(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    bio: Annotated[str | None, Field(examples=['I started web scraping in 1985 using Altair BASIC.'])] = None
    name: Annotated[str | None, Field(examples=['Jane Doe'])] = None
    picture_url: Annotated[
        AnyUrl | None, Field(alias='pictureUrl', examples=['https://apify.com/img/anonymous_user_picture.png'])
    ] = None
    github_username: Annotated[str | None, Field(alias='githubUsername', examples=['torvalds.'])] = None
    website_url: Annotated[AnyUrl | None, Field(alias='websiteUrl', examples=['http://www.example.com'])] = None
    twitter_username: Annotated[str | None, Field(alias='twitterUsername', examples=['@BillGates'])] = None


class UserPublicInfo(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    username: Annotated[str, Field(examples=['d7b9MDYsbtX5L7XAj'])]
    profile: Profile


class PublicUserDataResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: UserPublicInfo


class ProxyGroup(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    name: Annotated[str, Field(examples=['Group1'])]
    description: Annotated[str, Field(examples=['Group1 description'])]
    available_count: Annotated[int, Field(alias='availableCount', examples=[10])]


class Proxy(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    password: Annotated[str, Field(examples=['ad78knd9Jkjd86'])]
    groups: list[ProxyGroup]


class Plan(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['Personal'])]
    description: Annotated[str, Field(examples=['Cost-effective plan for freelancers, developers and students.'])]
    is_enabled: Annotated[bool, Field(alias='isEnabled', examples=[True])]
    monthly_base_price_usd: Annotated[float, Field(alias='monthlyBasePriceUsd', examples=[49])]
    monthly_usage_credits_usd: Annotated[float, Field(alias='monthlyUsageCreditsUsd', examples=[49])]
    usage_discount_percent: Annotated[float, Field(alias='usageDiscountPercent', examples=[0])]
    enabled_platform_features: Annotated[
        list[list[Any]],
        Field(
            alias='enabledPlatformFeatures',
            examples=[[['ACTORS'], ['STORAGE'], ['PROXY_SERPS'], ['SCHEDULER'], ['WEBHOOKS']]],
        ),
    ]
    max_monthly_usage_usd: Annotated[float, Field(alias='maxMonthlyUsageUsd', examples=[9999])]
    max_actor_memory_gbytes: Annotated[float, Field(alias='maxActorMemoryGbytes', examples=[32])]
    max_monthly_actor_compute_units: Annotated[float, Field(alias='maxMonthlyActorComputeUnits', examples=[1000])]
    max_monthly_residential_proxy_gbytes: Annotated[
        float, Field(alias='maxMonthlyResidentialProxyGbytes', examples=[10])
    ]
    max_monthly_proxy_serps: Annotated[int, Field(alias='maxMonthlyProxySerps', examples=[30000])]
    max_monthly_external_data_transfer_gbytes: Annotated[
        float, Field(alias='maxMonthlyExternalDataTransferGbytes', examples=[1000])
    ]
    max_actor_count: Annotated[int, Field(alias='maxActorCount', examples=[100])]
    max_actor_task_count: Annotated[int, Field(alias='maxActorTaskCount', examples=[1000])]
    data_retention_days: Annotated[int, Field(alias='dataRetentionDays', examples=[14])]
    available_proxy_groups: Annotated[dict[str, int], Field(alias='availableProxyGroups')]
    """
    The number of available proxies in this group.
    """
    team_account_seat_count: Annotated[int, Field(alias='teamAccountSeatCount', examples=[1])]
    support_level: Annotated[str, Field(alias='supportLevel', examples=['COMMUNITY'])]
    available_add_ons: Annotated[list[str], Field(alias='availableAddOns', examples=[[]])]


class EffectivePlatformFeature(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    is_enabled: Annotated[bool, Field(alias='isEnabled', examples=[True])]
    disabled_reason: Annotated[
        str | None,
        Field(
            alias='disabledReason',
            examples=[
                'The "Selected public Actors for developers" feature is not enabled for your account. Please upgrade your plan or contact support@apify.com'
            ],
        ),
    ] = None
    disabled_reason_type: Annotated[str | None, Field(alias='disabledReasonType', examples=['DISABLED'])] = None
    is_trial: Annotated[bool, Field(alias='isTrial', examples=[False])]
    trial_expiration_at: Annotated[
        AwareDatetime | None, Field(alias='trialExpirationAt', examples=['2025-01-01T14:00:00.000Z'])
    ] = None


class EffectivePlatformFeatures(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    actors: Annotated[EffectivePlatformFeature, Field(alias='ACTORS')]
    storage: Annotated[EffectivePlatformFeature, Field(alias='STORAGE')]
    scheduler: Annotated[EffectivePlatformFeature, Field(alias='SCHEDULER')]
    proxy: Annotated[EffectivePlatformFeature, Field(alias='PROXY')]
    proxy_external_access: Annotated[EffectivePlatformFeature, Field(alias='PROXY_EXTERNAL_ACCESS')]
    proxy_residential: Annotated[EffectivePlatformFeature, Field(alias='PROXY_RESIDENTIAL')]
    proxy_serps: Annotated[EffectivePlatformFeature, Field(alias='PROXY_SERPS')]
    webhooks: Annotated[EffectivePlatformFeature, Field(alias='WEBHOOKS')]
    actors_public_all: Annotated[EffectivePlatformFeature, Field(alias='ACTORS_PUBLIC_ALL')]
    actors_public_developer: Annotated[EffectivePlatformFeature, Field(alias='ACTORS_PUBLIC_DEVELOPER')]


class UserPrivateInfo(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    id: Annotated[str, Field(examples=['YiKoxjkaS9gjGTqhF'])]
    username: Annotated[str, Field(examples=['myusername'])]
    profile: Profile
    email: Annotated[EmailStr, Field(examples=['bob@example.com'])]
    proxy: Proxy
    plan: Plan
    effective_platform_features: Annotated[EffectivePlatformFeatures, Field(alias='effectivePlatformFeatures')]
    created_at: Annotated[AwareDatetime, Field(alias='createdAt', examples=['2022-11-29T14:48:29.381Z'])]
    is_paying: Annotated[bool, Field(alias='isPaying', examples=[True])]


class PrivateUserDataResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: UserPrivateInfo


class UsageCycle(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    start_at: Annotated[AwareDatetime, Field(alias='startAt', examples=['2022-10-02T00:00:00.000Z'])]
    end_at: Annotated[AwareDatetime, Field(alias='endAt', examples=['2022-11-01T23:59:59.999Z'])]


class PriceTiers(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    quantity_above: Annotated[float, Field(alias='quantityAbove', examples=[0])]
    discount_percent: Annotated[float, Field(alias='discountPercent', examples=[100])]
    tier_quantity: Annotated[float, Field(alias='tierQuantity', examples=[0.39])]
    unit_price_usd: Annotated[float, Field(alias='unitPriceUsd', examples=[0])]
    price_usd: Annotated[float, Field(alias='priceUsd', examples=[0])]


class UsageItem(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    quantity: Annotated[float, Field(examples=[2.784475])]
    base_amount_usd: Annotated[float, Field(alias='baseAmountUsd', examples=[0.69611875])]
    base_unit_price_usd: Annotated[float | None, Field(alias='baseUnitPriceUsd', examples=[0.25])] = None
    amount_after_volume_discount_usd: Annotated[
        float | None, Field(alias='amountAfterVolumeDiscountUsd', examples=[0.69611875])
    ] = None
    price_tiers: Annotated[list[PriceTiers] | None, Field(alias='priceTiers')] = None


class DailyServiceUsages(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    date: Annotated[str, Field(examples=['2022-10-02T00:00:00.000Z'])]
    service_usage: Annotated[dict[str, UsageItem], Field(alias='serviceUsage')]
    total_usage_credits_usd: Annotated[float, Field(alias='totalUsageCreditsUsd', examples=[0.0474385791970591])]


class MonthlyUsage(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    usage_cycle: Annotated[UsageCycle, Field(alias='usageCycle')]
    monthly_service_usage: Annotated[dict[str, UsageItem], Field(alias='monthlyServiceUsage')]
    daily_service_usages: Annotated[list[DailyServiceUsages], Field(alias='dailyServiceUsages')]
    total_usage_credits_usd_before_volume_discount: Annotated[
        float, Field(alias='totalUsageCreditsUsdBeforeVolumeDiscount', examples=[0.786143673840067])
    ]
    total_usage_credits_usd_after_volume_discount: Annotated[
        float, Field(alias='totalUsageCreditsUsdAfterVolumeDiscount', examples=[0.786143673840067])
    ]


class MonthlyUsageResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: MonthlyUsage


class Limits(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    max_monthly_usage_usd: Annotated[float, Field(alias='maxMonthlyUsageUsd', examples=[300])]
    max_monthly_actor_compute_units: Annotated[float, Field(alias='maxMonthlyActorComputeUnits', examples=[1000])]
    max_monthly_external_data_transfer_gbytes: Annotated[
        float, Field(alias='maxMonthlyExternalDataTransferGbytes', examples=[7])
    ]
    max_monthly_proxy_serps: Annotated[int, Field(alias='maxMonthlyProxySerps', examples=[50])]
    max_monthly_residential_proxy_gbytes: Annotated[
        float, Field(alias='maxMonthlyResidentialProxyGbytes', examples=[0.5])
    ]
    max_actor_memory_gbytes: Annotated[float, Field(alias='maxActorMemoryGbytes', examples=[16])]
    max_actor_count: Annotated[int, Field(alias='maxActorCount', examples=[100])]
    max_actor_task_count: Annotated[int, Field(alias='maxActorTaskCount', examples=[1000])]
    max_concurrent_actor_jobs: Annotated[int, Field(alias='maxConcurrentActorJobs', examples=[256])]
    max_team_account_seat_count: Annotated[int, Field(alias='maxTeamAccountSeatCount', examples=[9])]
    data_retention_days: Annotated[int, Field(alias='dataRetentionDays', examples=[90])]


class Current(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    monthly_usage_usd: Annotated[float, Field(alias='monthlyUsageUsd', examples=[43])]
    monthly_actor_compute_units: Annotated[float, Field(alias='monthlyActorComputeUnits', examples=[500.784475])]
    monthly_external_data_transfer_gbytes: Annotated[
        float, Field(alias='monthlyExternalDataTransferGbytes', examples=[3.00861903931946])
    ]
    monthly_proxy_serps: Annotated[int, Field(alias='monthlyProxySerps', examples=[34])]
    monthly_residential_proxy_gbytes: Annotated[float, Field(alias='monthlyResidentialProxyGbytes', examples=[0.4])]
    actor_memory_gbytes: Annotated[float, Field(alias='actorMemoryGbytes', examples=[8])]
    actor_count: Annotated[int, Field(alias='actorCount', examples=[31])]
    actor_task_count: Annotated[int, Field(alias='actorTaskCount', examples=[130])]
    active_actor_job_count: Annotated[int, Field(alias='activeActorJobCount', examples=[0])]
    team_account_seat_count: Annotated[int, Field(alias='teamAccountSeatCount', examples=[5])]


class AccountLimits(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    monthly_usage_cycle: Annotated[UsageCycle, Field(alias='monthlyUsageCycle')]
    limits: Limits
    current: Current


class LimitsResponse(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    data: AccountLimits


class UpdateLimitsRequest(BaseModel):
    model_config = ConfigDict(
        extra='allow',
    )
    max_monthly_usage_usd: Annotated[float | None, Field(alias='maxMonthlyUsageUsd', examples=[300])] = None
    """
    If your platform usage in the billing period exceeds the prepaid usage, you will be charged extra. Setting this property you can update your hard limit on monthly platform usage to prevent accidental overage or to limit the extra charges.

    """
    data_retention_days: Annotated[int | None, Field(alias='dataRetentionDays', examples=[90])] = None
    """
    Apify securely stores your ten most recent Actor runs indefinitely, ensuring they are always accessible. Unnamed storages and other Actor runs are automatically deleted after the retention period. If you're subscribed, you can change it to keep data for longer or to limit your usage. [Lear more](https://docs.apify.com/platform/storage/usage#data-retention).

    """


class ActorJob(BaseModel):
    """Minimal model for an Actor job (run or build) with status. Used for validation during polling operations."""

    model_config = ConfigDict(
        extra='allow',
    )
    status: ActorJobStatus
    """
    Current status of the Actor job.
    """


class ActorJobResponse(BaseModel):
    """Response wrapper for an Actor job (run or build). Used for minimal validation during polling operations."""

    model_config = ConfigDict(
        extra='allow',
    )
    data: ActorJob