diff --git a/models/ref/python/automations/automation.mdx b/models/ref/python/automations/automation.mdx
index 1bbc46cf71..6dced1738c 100644
--- a/models/ref/python/automations/automation.mdx
+++ b/models/ref/python/automations/automation.mdx
@@ -1,47 +1,558 @@
---
title: Automation
-namespace: automations_namespace
-python_object_type: class
+kind: class
+namespace: wandb.automations.automations
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+```python
+*,
+__typename: Literal['Trigger'] = 'Trigger',
+id: typing.Annotated[str, Strict(strict=True)],
+createdAt: datetime.datetime,
+updatedAt: datetime.datetime | None = None,
+name: str,
+description: str | None,
+enabled: bool,
+scope: typing.Annotated[wandb.automations.scopes._ArtifactSequenceScope | wandb.automations.scopes._ArtifactPortfolioScope | wandb.automations.scopes.ProjectScope, BeforeValidator(func=, json_schema_input_type=PydanticUndefined)],
+event: wandb.automations.events.SavedEvent,
+action: typing.Annotated[wandb.automations.actions.SavedLaunchJobAction | wandb.automations.actions.SavedNotificationAction | wandb.automations.actions.SavedWebhookAction | wandb.automations.actions.SavedNoOpAction, BeforeValidator(func=, json_schema_input_type=PydanticUndefined)]
+```
+
+## Description
-## class `Automation`
A local instance of a saved W&B automation that supports editing.
-### method `Automation.__init__`
-
-```python
-__init__(
- typename__: 'Literal['Trigger']' = 'Trigger',
- id: 'str',
- created_at: 'datetime',
- updated_at: 'datetime | None' = None,
- name: 'str',
- description: 'str | None',
- enabled: 'bool',
- scope: '_ArtifactSequenceScope | _ArtifactPortfolioScope | ProjectScope',
- event: 'SavedEvent',
- action: 'SavedLaunchJobAction | SavedNotificationAction | SavedWebhookAction | SavedNoOpAction'
-) → None
-```
-
-**Args:**
-
- - `typename__` (Literal['Trigger']):
- - `id` (str):
- - `created_at` (datetime): The date and time when this automation was created.
- - `updated_at` (Optional[datetime]): The date and time when this automation was last updated, if applicable.
- - `name` (str): The name of this automation.
- - `description` (Optional[str]): An optional description of this automation.
- - `enabled` (bool): Whether this automation is enabled. Only enabled automations will trigger.
- - `scope` (Union[_ArtifactSequenceScope, _ArtifactPortfolioScope, ProjectScope]): The scope in which the triggering event must occur.
- - `event` (SavedEvent): The event that will trigger this automation.
- - `action` (Union[SavedLaunchJobAction, SavedNotificationAction, SavedWebhookAction, SavedNoOpAction]): The action that will execute when this automation is triggered.
-
-**Returns:**
- An `Automation` object.
+
+## Args
+
+- **__typename**:
+- **id**:
+- **createdAt**:
+- **updatedAt**:
+- **name**:
+- **description**:
+- **enabled**:
+- **scope**:
+- **event**:
+- **action**:
+
+
+
+
+
+
+## Methods
+
+### method construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+
+
+##### Arguments
+
+- **_fields_set**:
+- **values**:
+
+
+
+
+### method copy
+
+```python
+self, *,
+include: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+exclude: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+update: 'Dict[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+Returns a copy of the model.
+
+!!! warning "Deprecated"
+ This method is now deprecated; use `model_copy` instead.
+
+If you need `include` or `exclude`, use:
+
+```python {test="skip" lint="skip"}
+data = self.model_dump(include=include, exclude=exclude, round_trip=True)
+data = {**data, **(update or {})}
+copied = self.model_validate(data)
+```
+
+##### Arguments
+
+- **include**: Optional set or mapping specifying which fields to include in the copied model.
+- **exclude**: Optional set or mapping specifying which fields to exclude in the copied model.
+- **update**: Optional dictionary of field-value pairs to override field values in the copied model.
+- **deep**: If True, the values of fields that are Pydantic models will be deep-copied.
+
+
+
+
+### method dict
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+
+
+
+
+### method from_orm
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method json
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False,
+encoder: 'Callable[[Any], Any] | None' = PydanticUndefined,
+models_as_dict: 'bool' = PydanticUndefined, **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+- **encoder**:
+- **models_as_dict**:
+- **dumps_kwargs**:
+
+
+
+
+### method model_construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+Creates a new instance of the `Model` class with validated data.
+
+Creates a new model setting `__dict__` and `__pydantic_fields_set__` from trusted or pre-validated data.
+Default values are respected, but no other validation is performed.
+
+!!! note
+ `model_construct()` generally respects the `model_config.extra` setting on the provided model.
+ That is, if `model_config.extra == 'allow'`, then all extra passed values are added to the model instance's `__dict__`
+ and `__pydantic_extra__` fields. If `model_config.extra == 'ignore'` (the default), then all extra passed values are ignored.
+ Because no validation is performed with a call to `model_construct()`, having `model_config.extra == 'forbid'` does not result in
+ an error if extra values are passed, but they will be ignored.
+
+##### Arguments
+
+- **_fields_set**: A set of field names that were originally explicitly set during instantiation. If provided, this is directly used for the [`model_fields_set`][pydantic.BaseModel.model_fields_set] attribute. Otherwise, the field names from the `values` argument will be used.
+- **values**: Trusted or pre-validated data dictionary.
+
+
+
+
+### method model_copy
+
+```python
+self, *,
+update: 'Mapping[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+!!! abstract "Usage Documentation"
+ [`model_copy`](../concepts/serialization.md#model_copy)
+
+Returns a copy of the model.
+
+!!! note
+ The underlying instance's [`__dict__`][object.__dict__] attribute is copied. This
+ might have unexpected side effects if you store anything in it, on top of the model
+ fields (e.g. the value of [cached properties][functools.cached_property]).
+
+##### Arguments
+
+- **update**: Values to change/add in the new model. Note: the data is not validated before creating the new model. You should trust this data.
+- **deep**: Set to `True` to make a deep copy of the model.
+
+
+
+
+### method model_dump
+
+```python
+self, *,
+mode: 'str' = 'json', **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump`](../concepts/serialization.md#modelmodel_dump)
+
+Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
+
+##### Arguments
+
+- **mode**: The mode in which `to_python` should run. If mode is 'json', the output will only contain JSON serializable types. If mode is 'python', the output may contain non-JSON-serializable Python objects.
+- **kwargs**:
+
+
+
+
+### method model_dump_json
+
+```python
+self, *,
+indent: 'int | None' = None, **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump_json`](../concepts/serialization.md#modelmodel_dump_json)
+
+Generates a JSON representation of the model using Pydantic's `to_json` method.
+
+##### Arguments
+
+- **indent**: Indentation to use in the JSON output. If None is passed, the output will be compact.
+- **kwargs**:
+
+
+
+
+### method model_json_schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}',
+schema_generator: 'type[GenerateJsonSchema]' = ,
+mode: 'JsonSchemaMode' = 'validation'
+```
+
+Generates a JSON schema for a model class.
+
+##### Arguments
+
+- **by_alias**: Whether to use attribute aliases or not.
+- **ref_template**: The reference template.
+- **schema_generator**: To override the logic used to generate the JSON schema, as a subclass of `GenerateJsonSchema` with your desired modifications
+- **mode**: The mode in which to generate the schema.
+
+
+
+
+### method model_parametrized_name
+
+```python
+params: 'tuple[type[Any], ...]'
+```
+
+Compute the class name for parametrizations of generic classes.
+
+This method can be overridden to achieve a custom naming scheme for generic BaseModels.
+
+##### Arguments
+
+- **params**: Tuple of types of the class. Given a generic class `Model` with 2 type variables and a concrete model `Model[str, int]`, the value `(str, int)` would be passed to `params`.
+
+
+##### Raises
+
+- **TypeError**: Raised when trying to generate concrete names for non-generic models.
+
+
+### method model_post_init
+
+```python
+self,
+context: 'Any', /
+```
+
+Override this method to perform additional initialization after `__init__` and `model_construct`.
+This is useful if you want to do some validation that requires the entire model to be initialized.
+
+##### Arguments
+
+- **context**:
+
+
+
+
+### method model_rebuild
+
+```python
+*,
+force: 'bool' = False,
+raise_errors: 'bool' = True,
+_parent_namespace_depth: 'int' = 2,
+_types_namespace: 'MappingNamespace | None' = None
+```
+
+Try to rebuild the pydantic-core schema for the model.
+
+This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
+the initial attempt to build the schema, and automatic rebuilding fails.
+
+##### Arguments
+
+- **force**: Whether to force the rebuilding of the model schema, defaults to `False`.
+- **raise_errors**: Whether to raise errors, defaults to `True`.
+- **_parent_namespace_depth**: The depth level of the parent namespace, defaults to 2.
+- **_types_namespace**: The types namespace, defaults to `None`.
+
+
+
+
+### method model_validate
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+from_attributes: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate a pydantic model instance.
+
+##### Arguments
+
+- **obj**: The object to validate.
+- **strict**: Whether to enforce types strictly.
+- **from_attributes**: Whether to extract data from object attributes.
+- **context**: Additional context to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If the object could not be validated.
+
+
+### method model_validate_json
+
+```python
+json_data: 'str | bytes | bytearray', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+!!! abstract "Usage Documentation"
+ [JSON Parsing](../concepts/json.md#json-parsing)
+
+Validate the given JSON data against the Pydantic model.
+
+##### Arguments
+
+- **json_data**: The JSON data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If `json_data` is not a JSON string or the object could not be validated.
+
+
+### method model_validate_strings
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate the given object with string data against the Pydantic model.
+
+##### Arguments
+
+- **obj**: The object containing string data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+
+
+### method parse_file
+
+```python
+path: 'str | Path', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **path**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method parse_obj
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method parse_raw
+
+```python
+b: 'str | bytes', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **b**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+
+
+
+
+### method schema_json
+
+```python
+*,
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}', **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+- **dumps_kwargs**:
+
+
+
+
+### method update_forward_refs
+
+```python
+**localns: 'Any'
+```
+
+
+
+##### Arguments
+
+- **localns**:
+
+
+
+
+### method validate
+
+```python
+value: 'Any'
+```
+
+
+
+##### Arguments
+
+- **value**:
+
+
+
+
+
+
diff --git a/models/ref/python/automations/donothing.mdx b/models/ref/python/automations/donothing.mdx
index 79caedf77a..23dffc475f 100644
--- a/models/ref/python/automations/donothing.mdx
+++ b/models/ref/python/automations/donothing.mdx
@@ -1,32 +1,542 @@
---
title: DoNothing
-namespace: automations_namespace
-python_object_type: class
+kind: class
+namespace: wandb.automations.actions
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+```python
+*,
+no_op: typing.Annotated[bool, BeforeValidator(func=, json_schema_input_type=PydanticUndefined)] = True,
+action_type: Literal[NO_OP] = NO_OP
+```
+
+## Description
-## class `DoNothing`
Defines an automation action that intentionally does nothing.
-### method `DoNothing.__init__`
+
+## Args
+
+- **no_op**:
+- **action_type**:
+
+
+
+
+
+
+## Methods
+
+### method construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+
+
+##### Arguments
+
+- **_fields_set**:
+- **values**:
+
+
+
+
+### method copy
+
+```python
+self, *,
+include: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+exclude: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+update: 'Dict[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+Returns a copy of the model.
+
+!!! warning "Deprecated"
+ This method is now deprecated; use `model_copy` instead.
+
+If you need `include` or `exclude`, use:
+
+```python {test="skip" lint="skip"}
+data = self.model_dump(include=include, exclude=exclude, round_trip=True)
+data = {**data, **(update or {})}
+copied = self.model_validate(data)
+```
+
+##### Arguments
+
+- **include**: Optional set or mapping specifying which fields to include in the copied model.
+- **exclude**: Optional set or mapping specifying which fields to exclude in the copied model.
+- **update**: Optional dictionary of field-value pairs to override field values in the copied model.
+- **deep**: If True, the values of fields that are Pydantic models will be deep-copied.
+
+
+
+
+### method dict
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+
+
+
+
+### method from_orm
```python
-__init__(
- no_op: 'bool' = True,
- action_type: 'Literal[NO_OP]' = NO_OP
-) → None
+obj: 'Any'
```
-**Args:**
-
- - `no_op` (bool): Placeholder field which exists only to satisfy backend schema requirements.
- There should never be a need to set this field explicitly, as its value is ignored.
- - `action_type` (Literal[NO_OP]):
-**Returns:**
- An `DoNothing` object.
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method json
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False,
+encoder: 'Callable[[Any], Any] | None' = PydanticUndefined,
+models_as_dict: 'bool' = PydanticUndefined, **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+- **encoder**:
+- **models_as_dict**:
+- **dumps_kwargs**:
+
+
+
+
+### method model_construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+Creates a new instance of the `Model` class with validated data.
+
+Creates a new model setting `__dict__` and `__pydantic_fields_set__` from trusted or pre-validated data.
+Default values are respected, but no other validation is performed.
+
+!!! note
+ `model_construct()` generally respects the `model_config.extra` setting on the provided model.
+ That is, if `model_config.extra == 'allow'`, then all extra passed values are added to the model instance's `__dict__`
+ and `__pydantic_extra__` fields. If `model_config.extra == 'ignore'` (the default), then all extra passed values are ignored.
+ Because no validation is performed with a call to `model_construct()`, having `model_config.extra == 'forbid'` does not result in
+ an error if extra values are passed, but they will be ignored.
+
+##### Arguments
+
+- **_fields_set**: A set of field names that were originally explicitly set during instantiation. If provided, this is directly used for the [`model_fields_set`][pydantic.BaseModel.model_fields_set] attribute. Otherwise, the field names from the `values` argument will be used.
+- **values**: Trusted or pre-validated data dictionary.
+
+
+
+
+### method model_copy
+
+```python
+self, *,
+update: 'Mapping[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+!!! abstract "Usage Documentation"
+ [`model_copy`](../concepts/serialization.md#model_copy)
+
+Returns a copy of the model.
+
+!!! note
+ The underlying instance's [`__dict__`][object.__dict__] attribute is copied. This
+ might have unexpected side effects if you store anything in it, on top of the model
+ fields (e.g. the value of [cached properties][functools.cached_property]).
+
+##### Arguments
+
+- **update**: Values to change/add in the new model. Note: the data is not validated before creating the new model. You should trust this data.
+- **deep**: Set to `True` to make a deep copy of the model.
+
+
+
+
+### method model_dump
+
+```python
+self, *,
+mode: 'str' = 'json', **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump`](../concepts/serialization.md#modelmodel_dump)
+
+Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
+
+##### Arguments
+
+- **mode**: The mode in which `to_python` should run. If mode is 'json', the output will only contain JSON serializable types. If mode is 'python', the output may contain non-JSON-serializable Python objects.
+- **kwargs**:
+
+
+
+
+### method model_dump_json
+
+```python
+self, *,
+indent: 'int | None' = None, **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump_json`](../concepts/serialization.md#modelmodel_dump_json)
+
+Generates a JSON representation of the model using Pydantic's `to_json` method.
+
+##### Arguments
+
+- **indent**: Indentation to use in the JSON output. If None is passed, the output will be compact.
+- **kwargs**:
+
+
+
+
+### method model_json_schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}',
+schema_generator: 'type[GenerateJsonSchema]' = ,
+mode: 'JsonSchemaMode' = 'validation'
+```
+
+Generates a JSON schema for a model class.
+
+##### Arguments
+
+- **by_alias**: Whether to use attribute aliases or not.
+- **ref_template**: The reference template.
+- **schema_generator**: To override the logic used to generate the JSON schema, as a subclass of `GenerateJsonSchema` with your desired modifications
+- **mode**: The mode in which to generate the schema.
+
+
+
+
+### method model_parametrized_name
+
+```python
+params: 'tuple[type[Any], ...]'
+```
+
+Compute the class name for parametrizations of generic classes.
+
+This method can be overridden to achieve a custom naming scheme for generic BaseModels.
+
+##### Arguments
+
+- **params**: Tuple of types of the class. Given a generic class `Model` with 2 type variables and a concrete model `Model[str, int]`, the value `(str, int)` would be passed to `params`.
+
+
+##### Raises
+
+- **TypeError**: Raised when trying to generate concrete names for non-generic models.
+
+
+### method model_post_init
+
+```python
+self,
+context: 'Any', /
+```
+
+Override this method to perform additional initialization after `__init__` and `model_construct`.
+This is useful if you want to do some validation that requires the entire model to be initialized.
+
+##### Arguments
+
+- **context**:
+
+
+
+
+### method model_rebuild
+
+```python
+*,
+force: 'bool' = False,
+raise_errors: 'bool' = True,
+_parent_namespace_depth: 'int' = 2,
+_types_namespace: 'MappingNamespace | None' = None
+```
+
+Try to rebuild the pydantic-core schema for the model.
+
+This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
+the initial attempt to build the schema, and automatic rebuilding fails.
+
+##### Arguments
+
+- **force**: Whether to force the rebuilding of the model schema, defaults to `False`.
+- **raise_errors**: Whether to raise errors, defaults to `True`.
+- **_parent_namespace_depth**: The depth level of the parent namespace, defaults to 2.
+- **_types_namespace**: The types namespace, defaults to `None`.
+
+
+
+
+### method model_validate
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+from_attributes: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate a pydantic model instance.
+
+##### Arguments
+
+- **obj**: The object to validate.
+- **strict**: Whether to enforce types strictly.
+- **from_attributes**: Whether to extract data from object attributes.
+- **context**: Additional context to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If the object could not be validated.
+
+
+### method model_validate_json
+
+```python
+json_data: 'str | bytes | bytearray', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+!!! abstract "Usage Documentation"
+ [JSON Parsing](../concepts/json.md#json-parsing)
+
+Validate the given JSON data against the Pydantic model.
+
+##### Arguments
+
+- **json_data**: The JSON data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If `json_data` is not a JSON string or the object could not be validated.
+
+
+### method model_validate_strings
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate the given object with string data against the Pydantic model.
+
+##### Arguments
+
+- **obj**: The object containing string data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+
+
+### method parse_file
+
+```python
+path: 'str | Path', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **path**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method parse_obj
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method parse_raw
+
+```python
+b: 'str | bytes', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **b**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+
+
+
+
+### method schema_json
+
+```python
+*,
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}', **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+- **dumps_kwargs**:
+
+
+
+
+### method update_forward_refs
+
+```python
+**localns: 'Any'
+```
+
+
+
+##### Arguments
+
+- **localns**:
+
+
+
+
+### method validate
+
+```python
+value: 'Any'
+```
+
+
+
+##### Arguments
+
+- **value**:
+
+
+
+
+
+
diff --git a/models/ref/python/automations/metricchangefilter.mdx b/models/ref/python/automations/metricchangefilter.mdx
index 95dafd73a4..2fe3a8b246 100644
--- a/models/ref/python/automations/metricchangefilter.mdx
+++ b/models/ref/python/automations/metricchangefilter.mdx
@@ -1,47 +1,557 @@
---
title: MetricChangeFilter
-namespace: automations_namespace
-python_object_type: class
+kind: class
+namespace: wandb.automations._filters.run_metrics
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+```python
+*,
+name: str,
+agg_op: wandb.automations._filters.run_metrics.Agg | None = None,
+current_window_size: typing.Annotated[int, Gt(gt=0)] = 1,
+cmp: NoneType = None,
+change_amount: Union[Annotated[int, Gt(gt=0)], Annotated[float, Gt(gt=0)]],
+prior_window_size: typing.Annotated[int, Gt(gt=0)] = ,
+change_type: wandb.automations._filters.run_metrics.ChangeType,
+change_dir: wandb.automations._filters.run_metrics.ChangeDir
+```
+
+## Description
-## class `MetricChangeFilter`
Filter that compares a **change** in a metric value to a user-defined threshold.
The change is calculated over "tumbling" windows, i.e. the difference
between the current window and the non-overlapping prior window.
-### method `MetricChangeFilter.__init__`
+
+## Args
+
+- **name**:
+- **agg_op**:
+- **current_window_size**:
+- **cmp**:
+- **change_amount**:
+- **prior_window_size**:
+- **change_type**:
+- **change_dir**:
+
+
+
+
+
+
+## Methods
+
+### method construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+
+
+##### Arguments
+
+- **_fields_set**:
+- **values**:
+
+
+
+
+### method copy
+
+```python
+self, *,
+include: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+exclude: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+update: 'Dict[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+Returns a copy of the model.
+
+!!! warning "Deprecated"
+ This method is now deprecated; use `model_copy` instead.
+
+If you need `include` or `exclude`, use:
+
+```python {test="skip" lint="skip"}
+data = self.model_dump(include=include, exclude=exclude, round_trip=True)
+data = {**data, **(update or {})}
+copied = self.model_validate(data)
+```
+
+##### Arguments
+
+- **include**: Optional set or mapping specifying which fields to include in the copied model.
+- **exclude**: Optional set or mapping specifying which fields to exclude in the copied model.
+- **update**: Optional dictionary of field-value pairs to override field values in the copied model.
+- **deep**: If True, the values of fields that are Pydantic models will be deep-copied.
+
+
+
+
+### method dict
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+
+
+
+
+### method from_orm
```python
-__init__(
- name: 'str',
- agg: 'Agg | None' = None,
- window: 'int' = 1,
- cmp: 'None' = None,
- threshold: 'Annotated | Annotated',
- prior_window: 'int' = None,
- change_type: 'ChangeType',
- change_dir: 'ChangeDir'
-) → None
+obj: 'Any'
```
-**Args:**
-
- - `name` (str):
- - `agg` (Optional[Agg]):
- - `window` (int):
- - `cmp` (None): Ignored.
- - `threshold` (Union[Annotated, Annotated]):
- - `prior_window` (int): Size of the "prior" metric aggregation window (ignored if `agg` is ``None``).
- If omitted, defaults to the size of the current window.
- - `change_type` (ChangeType):
- - `change_dir` (ChangeDir):
-**Returns:**
- An `MetricChangeFilter` object.
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method json
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False,
+encoder: 'Callable[[Any], Any] | None' = PydanticUndefined,
+models_as_dict: 'bool' = PydanticUndefined, **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+- **encoder**:
+- **models_as_dict**:
+- **dumps_kwargs**:
+
+
+
+
+### method model_construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+Creates a new instance of the `Model` class with validated data.
+
+Creates a new model setting `__dict__` and `__pydantic_fields_set__` from trusted or pre-validated data.
+Default values are respected, but no other validation is performed.
+
+!!! note
+ `model_construct()` generally respects the `model_config.extra` setting on the provided model.
+ That is, if `model_config.extra == 'allow'`, then all extra passed values are added to the model instance's `__dict__`
+ and `__pydantic_extra__` fields. If `model_config.extra == 'ignore'` (the default), then all extra passed values are ignored.
+ Because no validation is performed with a call to `model_construct()`, having `model_config.extra == 'forbid'` does not result in
+ an error if extra values are passed, but they will be ignored.
+
+##### Arguments
+
+- **_fields_set**: A set of field names that were originally explicitly set during instantiation. If provided, this is directly used for the [`model_fields_set`][pydantic.BaseModel.model_fields_set] attribute. Otherwise, the field names from the `values` argument will be used.
+- **values**: Trusted or pre-validated data dictionary.
+
+
+
+
+### method model_copy
+
+```python
+self, *,
+update: 'Mapping[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+!!! abstract "Usage Documentation"
+ [`model_copy`](../concepts/serialization.md#model_copy)
+
+Returns a copy of the model.
+
+!!! note
+ The underlying instance's [`__dict__`][object.__dict__] attribute is copied. This
+ might have unexpected side effects if you store anything in it, on top of the model
+ fields (e.g. the value of [cached properties][functools.cached_property]).
+
+##### Arguments
+
+- **update**: Values to change/add in the new model. Note: the data is not validated before creating the new model. You should trust this data.
+- **deep**: Set to `True` to make a deep copy of the model.
+
+
+
+
+### method model_dump
+
+```python
+self, *,
+mode: 'str' = 'json', **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump`](../concepts/serialization.md#modelmodel_dump)
+
+Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
+
+##### Arguments
+
+- **mode**: The mode in which `to_python` should run. If mode is 'json', the output will only contain JSON serializable types. If mode is 'python', the output may contain non-JSON-serializable Python objects.
+- **kwargs**:
+
+
+
+
+### method model_dump_json
+
+```python
+self, *,
+indent: 'int | None' = None, **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump_json`](../concepts/serialization.md#modelmodel_dump_json)
+
+Generates a JSON representation of the model using Pydantic's `to_json` method.
+
+##### Arguments
+
+- **indent**: Indentation to use in the JSON output. If None is passed, the output will be compact.
+- **kwargs**:
+
+
+
+
+### method model_json_schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}',
+schema_generator: 'type[GenerateJsonSchema]' = ,
+mode: 'JsonSchemaMode' = 'validation'
+```
+
+Generates a JSON schema for a model class.
+
+##### Arguments
+
+- **by_alias**: Whether to use attribute aliases or not.
+- **ref_template**: The reference template.
+- **schema_generator**: To override the logic used to generate the JSON schema, as a subclass of `GenerateJsonSchema` with your desired modifications
+- **mode**: The mode in which to generate the schema.
+
+
+
+
+### method model_parametrized_name
+
+```python
+params: 'tuple[type[Any], ...]'
+```
+
+Compute the class name for parametrizations of generic classes.
+
+This method can be overridden to achieve a custom naming scheme for generic BaseModels.
+
+##### Arguments
+
+- **params**: Tuple of types of the class. Given a generic class `Model` with 2 type variables and a concrete model `Model[str, int]`, the value `(str, int)` would be passed to `params`.
+
+
+##### Raises
+
+- **TypeError**: Raised when trying to generate concrete names for non-generic models.
+
+
+### method model_post_init
+
+```python
+self,
+context: 'Any', /
+```
+
+Override this method to perform additional initialization after `__init__` and `model_construct`.
+This is useful if you want to do some validation that requires the entire model to be initialized.
+
+##### Arguments
+
+- **context**:
+
+
+
+
+### method model_rebuild
+
+```python
+*,
+force: 'bool' = False,
+raise_errors: 'bool' = True,
+_parent_namespace_depth: 'int' = 2,
+_types_namespace: 'MappingNamespace | None' = None
+```
+
+Try to rebuild the pydantic-core schema for the model.
+
+This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
+the initial attempt to build the schema, and automatic rebuilding fails.
+
+##### Arguments
+
+- **force**: Whether to force the rebuilding of the model schema, defaults to `False`.
+- **raise_errors**: Whether to raise errors, defaults to `True`.
+- **_parent_namespace_depth**: The depth level of the parent namespace, defaults to 2.
+- **_types_namespace**: The types namespace, defaults to `None`.
+
+
+
+
+### method model_validate
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+from_attributes: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate a pydantic model instance.
+
+##### Arguments
+
+- **obj**: The object to validate.
+- **strict**: Whether to enforce types strictly.
+- **from_attributes**: Whether to extract data from object attributes.
+- **context**: Additional context to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If the object could not be validated.
+
+
+### method model_validate_json
+
+```python
+json_data: 'str | bytes | bytearray', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+!!! abstract "Usage Documentation"
+ [JSON Parsing](../concepts/json.md#json-parsing)
+
+Validate the given JSON data against the Pydantic model.
+
+##### Arguments
+
+- **json_data**: The JSON data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If `json_data` is not a JSON string or the object could not be validated.
+
+
+### method model_validate_strings
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate the given object with string data against the Pydantic model.
+
+##### Arguments
+
+- **obj**: The object containing string data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+
+
+### method parse_file
+
+```python
+path: 'str | Path', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **path**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method parse_obj
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method parse_raw
+
+```python
+b: 'str | bytes', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **b**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+
+
+
+
+### method schema_json
+
+```python
+*,
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}', **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+- **dumps_kwargs**:
+
+
+
+
+### method update_forward_refs
+
+```python
+**localns: 'Any'
+```
+
+
+
+##### Arguments
+
+- **localns**:
+
+
+
+
+### method validate
+
+```python
+value: 'Any'
+```
+
+
+
+##### Arguments
+
+- **value**:
+
+
+
+
+
+
diff --git a/models/ref/python/automations/metricthresholdfilter.mdx b/models/ref/python/automations/metricthresholdfilter.mdx
index 9ba3bcdb56..969240f8c6 100644
--- a/models/ref/python/automations/metricthresholdfilter.mdx
+++ b/models/ref/python/automations/metricthresholdfilter.mdx
@@ -1,40 +1,551 @@
---
title: MetricThresholdFilter
-namespace: automations_namespace
-python_object_type: class
+kind: class
+namespace: wandb.automations._filters.run_metrics
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+```python
+*,
+name: str,
+agg_op: wandb.automations._filters.run_metrics.Agg | None = None,
+window_size: typing.Annotated[int, Gt(gt=0)] = 1,
+cmp_op: Literal['$gte', '$gt', '$lt', '$lte'],
+threshold: Union[Annotated[int, Strict(strict=True)], Annotated[float, Strict(strict=True)]]
+```
+
+## Description
-## class `MetricThresholdFilter`
Filter that compares an **absolute** metric value against a user-defined threshold.
The value may be a single value or an aggregated result over a window of
multiple values.
-### method `MetricThresholdFilter.__init__`
+
+## Args
+
+- **name**:
+- **agg_op**:
+- **window_size**:
+- **cmp_op**:
+- **threshold**:
+
+
+
+
+
+
+## Methods
+
+### method construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+
+
+##### Arguments
+
+- **_fields_set**:
+- **values**:
+
+
+
+
+### method copy
+
+```python
+self, *,
+include: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+exclude: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+update: 'Dict[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+Returns a copy of the model.
+
+!!! warning "Deprecated"
+ This method is now deprecated; use `model_copy` instead.
+
+If you need `include` or `exclude`, use:
+
+```python {test="skip" lint="skip"}
+data = self.model_dump(include=include, exclude=exclude, round_trip=True)
+data = {**data, **(update or {})}
+copied = self.model_validate(data)
+```
+
+##### Arguments
+
+- **include**: Optional set or mapping specifying which fields to include in the copied model.
+- **exclude**: Optional set or mapping specifying which fields to exclude in the copied model.
+- **update**: Optional dictionary of field-value pairs to override field values in the copied model.
+- **deep**: If True, the values of fields that are Pydantic models will be deep-copied.
+
+
+
+
+### method dict
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+
+
+
+
+### method from_orm
```python
-__init__(
- name: 'str',
- agg: 'Agg | None' = None,
- window: 'int' = 1,
- cmp: 'Literal['$gte', '$gt', '$lt', '$lte']',
- threshold: 'Annotated | Annotated'
-) → None
+obj: 'Any'
```
-**Args:**
-
- - `name` (str):
- - `agg` (Optional[Agg]):
- - `window` (int):
- - `cmp` (Literal['$gte', '$gt', '$lt', '$lte']): Comparison operator between the metric value (left) vs. the threshold (right).
- - `threshold` (Union[Annotated, Annotated]):
-**Returns:**
- An `MetricThresholdFilter` object.
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method json
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False,
+encoder: 'Callable[[Any], Any] | None' = PydanticUndefined,
+models_as_dict: 'bool' = PydanticUndefined, **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+- **encoder**:
+- **models_as_dict**:
+- **dumps_kwargs**:
+
+
+
+
+### method model_construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+Creates a new instance of the `Model` class with validated data.
+
+Creates a new model setting `__dict__` and `__pydantic_fields_set__` from trusted or pre-validated data.
+Default values are respected, but no other validation is performed.
+
+!!! note
+ `model_construct()` generally respects the `model_config.extra` setting on the provided model.
+ That is, if `model_config.extra == 'allow'`, then all extra passed values are added to the model instance's `__dict__`
+ and `__pydantic_extra__` fields. If `model_config.extra == 'ignore'` (the default), then all extra passed values are ignored.
+ Because no validation is performed with a call to `model_construct()`, having `model_config.extra == 'forbid'` does not result in
+ an error if extra values are passed, but they will be ignored.
+
+##### Arguments
+
+- **_fields_set**: A set of field names that were originally explicitly set during instantiation. If provided, this is directly used for the [`model_fields_set`][pydantic.BaseModel.model_fields_set] attribute. Otherwise, the field names from the `values` argument will be used.
+- **values**: Trusted or pre-validated data dictionary.
+
+
+
+
+### method model_copy
+
+```python
+self, *,
+update: 'Mapping[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+!!! abstract "Usage Documentation"
+ [`model_copy`](../concepts/serialization.md#model_copy)
+
+Returns a copy of the model.
+
+!!! note
+ The underlying instance's [`__dict__`][object.__dict__] attribute is copied. This
+ might have unexpected side effects if you store anything in it, on top of the model
+ fields (e.g. the value of [cached properties][functools.cached_property]).
+
+##### Arguments
+
+- **update**: Values to change/add in the new model. Note: the data is not validated before creating the new model. You should trust this data.
+- **deep**: Set to `True` to make a deep copy of the model.
+
+
+
+
+### method model_dump
+
+```python
+self, *,
+mode: 'str' = 'json', **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump`](../concepts/serialization.md#modelmodel_dump)
+
+Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
+
+##### Arguments
+
+- **mode**: The mode in which `to_python` should run. If mode is 'json', the output will only contain JSON serializable types. If mode is 'python', the output may contain non-JSON-serializable Python objects.
+- **kwargs**:
+
+
+
+
+### method model_dump_json
+
+```python
+self, *,
+indent: 'int | None' = None, **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump_json`](../concepts/serialization.md#modelmodel_dump_json)
+
+Generates a JSON representation of the model using Pydantic's `to_json` method.
+
+##### Arguments
+
+- **indent**: Indentation to use in the JSON output. If None is passed, the output will be compact.
+- **kwargs**:
+
+
+
+
+### method model_json_schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}',
+schema_generator: 'type[GenerateJsonSchema]' = ,
+mode: 'JsonSchemaMode' = 'validation'
+```
+
+Generates a JSON schema for a model class.
+
+##### Arguments
+
+- **by_alias**: Whether to use attribute aliases or not.
+- **ref_template**: The reference template.
+- **schema_generator**: To override the logic used to generate the JSON schema, as a subclass of `GenerateJsonSchema` with your desired modifications
+- **mode**: The mode in which to generate the schema.
+
+
+
+
+### method model_parametrized_name
+
+```python
+params: 'tuple[type[Any], ...]'
+```
+
+Compute the class name for parametrizations of generic classes.
+
+This method can be overridden to achieve a custom naming scheme for generic BaseModels.
+
+##### Arguments
+
+- **params**: Tuple of types of the class. Given a generic class `Model` with 2 type variables and a concrete model `Model[str, int]`, the value `(str, int)` would be passed to `params`.
+
+
+##### Raises
+
+- **TypeError**: Raised when trying to generate concrete names for non-generic models.
+
+
+### method model_post_init
+
+```python
+self,
+context: 'Any', /
+```
+
+Override this method to perform additional initialization after `__init__` and `model_construct`.
+This is useful if you want to do some validation that requires the entire model to be initialized.
+
+##### Arguments
+
+- **context**:
+
+
+
+
+### method model_rebuild
+
+```python
+*,
+force: 'bool' = False,
+raise_errors: 'bool' = True,
+_parent_namespace_depth: 'int' = 2,
+_types_namespace: 'MappingNamespace | None' = None
+```
+
+Try to rebuild the pydantic-core schema for the model.
+
+This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
+the initial attempt to build the schema, and automatic rebuilding fails.
+
+##### Arguments
+
+- **force**: Whether to force the rebuilding of the model schema, defaults to `False`.
+- **raise_errors**: Whether to raise errors, defaults to `True`.
+- **_parent_namespace_depth**: The depth level of the parent namespace, defaults to 2.
+- **_types_namespace**: The types namespace, defaults to `None`.
+
+
+
+
+### method model_validate
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+from_attributes: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate a pydantic model instance.
+
+##### Arguments
+
+- **obj**: The object to validate.
+- **strict**: Whether to enforce types strictly.
+- **from_attributes**: Whether to extract data from object attributes.
+- **context**: Additional context to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If the object could not be validated.
+
+
+### method model_validate_json
+
+```python
+json_data: 'str | bytes | bytearray', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+!!! abstract "Usage Documentation"
+ [JSON Parsing](../concepts/json.md#json-parsing)
+
+Validate the given JSON data against the Pydantic model.
+
+##### Arguments
+
+- **json_data**: The JSON data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If `json_data` is not a JSON string or the object could not be validated.
+
+
+### method model_validate_strings
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate the given object with string data against the Pydantic model.
+
+##### Arguments
+
+- **obj**: The object containing string data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+
+
+### method parse_file
+
+```python
+path: 'str | Path', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **path**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method parse_obj
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method parse_raw
+
+```python
+b: 'str | bytes', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **b**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+
+
+
+
+### method schema_json
+
+```python
+*,
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}', **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+- **dumps_kwargs**:
+
+
+
+
+### method update_forward_refs
+
+```python
+**localns: 'Any'
+```
+
+
+
+##### Arguments
+
+- **localns**:
+
+
+
+
+### method validate
+
+```python
+value: 'Any'
+```
+
+
+
+##### Arguments
+
+- **value**:
+
+
+
+
+
+
diff --git a/models/ref/python/automations/metriczscorefilter.mdx b/models/ref/python/automations/metriczscorefilter.mdx
index 7cfa73de00..501385edc5 100644
--- a/models/ref/python/automations/metriczscorefilter.mdx
+++ b/models/ref/python/automations/metriczscorefilter.mdx
@@ -1,35 +1,546 @@
---
title: MetricZScoreFilter
-namespace: automations_namespace
-python_object_type: class
+kind: class
+namespace: wandb.automations._filters.run_metrics
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+```python
+*,
+name: str,
+window_size: typing.Annotated[int, Gt(gt=0)] = 30,
+threshold: Union[Annotated[int, Gt(gt=0)], Annotated[float, Gt(gt=0)]] = 3.0,
+change_dir: wandb.automations._filters.run_metrics.ChangeDir = ANY
+```
+
+## Description
-## class `MetricZScoreFilter`
Filter that compares a metric's z-score against a user-defined threshold.
-### method `MetricZScoreFilter.__init__`
+
+## Args
+
+- **name**:
+- **window_size**:
+- **threshold**:
+- **change_dir**:
+
+
+
+
+
+
+## Methods
+
+### method construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+
+
+##### Arguments
+
+- **_fields_set**:
+- **values**:
+
+
+
+
+### method copy
+
+```python
+self, *,
+include: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+exclude: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+update: 'Dict[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+Returns a copy of the model.
+
+!!! warning "Deprecated"
+ This method is now deprecated; use `model_copy` instead.
+
+If you need `include` or `exclude`, use:
+
+```python {test="skip" lint="skip"}
+data = self.model_dump(include=include, exclude=exclude, round_trip=True)
+data = {**data, **(update or {})}
+copied = self.model_validate(data)
+```
+
+##### Arguments
+
+- **include**: Optional set or mapping specifying which fields to include in the copied model.
+- **exclude**: Optional set or mapping specifying which fields to exclude in the copied model.
+- **update**: Optional dictionary of field-value pairs to override field values in the copied model.
+- **deep**: If True, the values of fields that are Pydantic models will be deep-copied.
+
+
+
+
+### method dict
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+
+
+
+
+### method from_orm
```python
-__init__(
- name: 'str',
- window: 'int' = 30,
- threshold: 'Annotated | Annotated' = 3.0,
- change_dir: 'ChangeDir' = ANY
-) → None
+obj: 'Any'
```
-**Args:**
-
- - `name` (str): Name of the observed metric.
- - `window` (int): Size of the window to calculate the metric mean and standard deviation over.
- - `threshold` (Union[Annotated, Annotated]): Threshold for the z-score.
- - `change_dir` (ChangeDir): Direction of the z-score change to watch for.
-**Returns:**
- An `MetricZScoreFilter` object.
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method json
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False,
+encoder: 'Callable[[Any], Any] | None' = PydanticUndefined,
+models_as_dict: 'bool' = PydanticUndefined, **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+- **encoder**:
+- **models_as_dict**:
+- **dumps_kwargs**:
+
+
+
+
+### method model_construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+Creates a new instance of the `Model` class with validated data.
+
+Creates a new model setting `__dict__` and `__pydantic_fields_set__` from trusted or pre-validated data.
+Default values are respected, but no other validation is performed.
+
+!!! note
+ `model_construct()` generally respects the `model_config.extra` setting on the provided model.
+ That is, if `model_config.extra == 'allow'`, then all extra passed values are added to the model instance's `__dict__`
+ and `__pydantic_extra__` fields. If `model_config.extra == 'ignore'` (the default), then all extra passed values are ignored.
+ Because no validation is performed with a call to `model_construct()`, having `model_config.extra == 'forbid'` does not result in
+ an error if extra values are passed, but they will be ignored.
+
+##### Arguments
+
+- **_fields_set**: A set of field names that were originally explicitly set during instantiation. If provided, this is directly used for the [`model_fields_set`][pydantic.BaseModel.model_fields_set] attribute. Otherwise, the field names from the `values` argument will be used.
+- **values**: Trusted or pre-validated data dictionary.
+
+
+
+
+### method model_copy
+
+```python
+self, *,
+update: 'Mapping[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+!!! abstract "Usage Documentation"
+ [`model_copy`](../concepts/serialization.md#model_copy)
+
+Returns a copy of the model.
+
+!!! note
+ The underlying instance's [`__dict__`][object.__dict__] attribute is copied. This
+ might have unexpected side effects if you store anything in it, on top of the model
+ fields (e.g. the value of [cached properties][functools.cached_property]).
+
+##### Arguments
+
+- **update**: Values to change/add in the new model. Note: the data is not validated before creating the new model. You should trust this data.
+- **deep**: Set to `True` to make a deep copy of the model.
+
+
+
+
+### method model_dump
+
+```python
+self, *,
+mode: 'str' = 'json', **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump`](../concepts/serialization.md#modelmodel_dump)
+
+Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
+
+##### Arguments
+
+- **mode**: The mode in which `to_python` should run. If mode is 'json', the output will only contain JSON serializable types. If mode is 'python', the output may contain non-JSON-serializable Python objects.
+- **kwargs**:
+
+
+
+
+### method model_dump_json
+
+```python
+self, *,
+indent: 'int | None' = None, **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump_json`](../concepts/serialization.md#modelmodel_dump_json)
+
+Generates a JSON representation of the model using Pydantic's `to_json` method.
+
+##### Arguments
+
+- **indent**: Indentation to use in the JSON output. If None is passed, the output will be compact.
+- **kwargs**:
+
+
+
+
+### method model_json_schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}',
+schema_generator: 'type[GenerateJsonSchema]' = ,
+mode: 'JsonSchemaMode' = 'validation'
+```
+
+Generates a JSON schema for a model class.
+
+##### Arguments
+
+- **by_alias**: Whether to use attribute aliases or not.
+- **ref_template**: The reference template.
+- **schema_generator**: To override the logic used to generate the JSON schema, as a subclass of `GenerateJsonSchema` with your desired modifications
+- **mode**: The mode in which to generate the schema.
+
+
+
+
+### method model_parametrized_name
+
+```python
+params: 'tuple[type[Any], ...]'
+```
+
+Compute the class name for parametrizations of generic classes.
+
+This method can be overridden to achieve a custom naming scheme for generic BaseModels.
+
+##### Arguments
+
+- **params**: Tuple of types of the class. Given a generic class `Model` with 2 type variables and a concrete model `Model[str, int]`, the value `(str, int)` would be passed to `params`.
+
+
+##### Raises
+
+- **TypeError**: Raised when trying to generate concrete names for non-generic models.
+
+
+### method model_post_init
+
+```python
+self,
+context: 'Any', /
+```
+
+Override this method to perform additional initialization after `__init__` and `model_construct`.
+This is useful if you want to do some validation that requires the entire model to be initialized.
+
+##### Arguments
+
+- **context**:
+
+
+
+
+### method model_rebuild
+
+```python
+*,
+force: 'bool' = False,
+raise_errors: 'bool' = True,
+_parent_namespace_depth: 'int' = 2,
+_types_namespace: 'MappingNamespace | None' = None
+```
+
+Try to rebuild the pydantic-core schema for the model.
+
+This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
+the initial attempt to build the schema, and automatic rebuilding fails.
+
+##### Arguments
+
+- **force**: Whether to force the rebuilding of the model schema, defaults to `False`.
+- **raise_errors**: Whether to raise errors, defaults to `True`.
+- **_parent_namespace_depth**: The depth level of the parent namespace, defaults to 2.
+- **_types_namespace**: The types namespace, defaults to `None`.
+
+
+
+
+### method model_validate
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+from_attributes: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate a pydantic model instance.
+
+##### Arguments
+
+- **obj**: The object to validate.
+- **strict**: Whether to enforce types strictly.
+- **from_attributes**: Whether to extract data from object attributes.
+- **context**: Additional context to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If the object could not be validated.
+
+
+### method model_validate_json
+
+```python
+json_data: 'str | bytes | bytearray', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+!!! abstract "Usage Documentation"
+ [JSON Parsing](../concepts/json.md#json-parsing)
+
+Validate the given JSON data against the Pydantic model.
+
+##### Arguments
+
+- **json_data**: The JSON data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If `json_data` is not a JSON string or the object could not be validated.
+
+
+### method model_validate_strings
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate the given object with string data against the Pydantic model.
+
+##### Arguments
+
+- **obj**: The object containing string data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+
+
+### method parse_file
+
+```python
+path: 'str | Path', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **path**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method parse_obj
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method parse_raw
+
+```python
+b: 'str | bytes', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **b**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+
+
+
+
+### method schema_json
+
+```python
+*,
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}', **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+- **dumps_kwargs**:
+
+
+
+
+### method update_forward_refs
+
+```python
+**localns: 'Any'
+```
+
+
+
+##### Arguments
+
+- **localns**:
+
+
+
+
+### method validate
+
+```python
+value: 'Any'
+```
+
+
+
+##### Arguments
+
+- **value**:
+
+
+
+
+
+
diff --git a/models/ref/python/automations/newautomation.mdx b/models/ref/python/automations/newautomation.mdx
index 89fdbff204..9a55e99caf 100644
--- a/models/ref/python/automations/newautomation.mdx
+++ b/models/ref/python/automations/newautomation.mdx
@@ -1,44 +1,554 @@
---
title: NewAutomation
-namespace: automations_namespace
-python_object_type: class
+kind: class
+namespace: wandb.automations.automations
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+```python
+*,
+name: str | None = None,
+description: str | None = None,
+enabled: bool | None = None,
+event: Optional[Annotated[wandb.automations.events.OnLinkArtifact | wandb.automations.events.OnAddArtifactAlias | wandb.automations.events.OnCreateArtifact | wandb.automations.events.OnRunMetric | wandb.automations.events.OnRunState, FieldInfo(annotation=NoneType, required=True, discriminator='event_type')]] = None,
+action: Optional[Annotated[wandb.automations.actions.SendNotification | wandb.automations.actions.SendWebhook | wandb.automations.actions.DoNothing, BeforeValidator(func=, json_schema_input_type=PydanticUndefined), FieldInfo(annotation=NoneType, required=True, discriminator='action_type')]] = None
+```
+
+## Description
-## class `NewAutomation`
A new automation to be created.
-### method `NewAutomation.__init__`
+
+## Args
+
+- **name**:
+- **description**:
+- **enabled**:
+- **event**:
+- **action**:
+
+
+
+
+## Properties
+
+### property scope
+
+The scope in which the triggering event must occur.
+
+
+
+## Methods
+
+### method construct
```python
-__init__(
- name: 'str | None' = None,
- description: 'str | None' = None,
- enabled: 'bool | None' = None,
- event: 'Annotated | None' = None,
- action: 'Annotated | None' = None
-) → None
+_fields_set: 'set[str] | None' = None, **values: 'Any'
```
-**Args:**
-
- - `name` (Optional[str]): The name of this automation.
- - `description` (Optional[str]): An optional description of this automation.
- - `enabled` (Optional[bool]): Whether this automation is enabled. Only enabled automations will trigger.
- - `event` (Optional[Annotated]): The event that will trigger this automation.
- - `action` (Optional[Annotated]): The action that will execute when this automation is triggered.
-**Returns:**
- An `NewAutomation` object.
-### property `NewAutomation.scope`
+##### Arguments
+
+- **_fields_set**:
+- **values**:
+
+
+
+
+### method copy
+
+```python
+self, *,
+include: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+exclude: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+update: 'Dict[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+Returns a copy of the model.
+
+!!! warning "Deprecated"
+ This method is now deprecated; use `model_copy` instead.
+
+If you need `include` or `exclude`, use:
+
+```python {test="skip" lint="skip"}
+data = self.model_dump(include=include, exclude=exclude, round_trip=True)
+data = {**data, **(update or {})}
+copied = self.model_validate(data)
+```
+
+##### Arguments
+
+- **include**: Optional set or mapping specifying which fields to include in the copied model.
+- **exclude**: Optional set or mapping specifying which fields to exclude in the copied model.
+- **update**: Optional dictionary of field-value pairs to override field values in the copied model.
+- **deep**: If True, the values of fields that are Pydantic models will be deep-copied.
+
+
+
+
+### method dict
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+
+
+
+
+### method from_orm
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method json
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False,
+encoder: 'Callable[[Any], Any] | None' = PydanticUndefined,
+models_as_dict: 'bool' = PydanticUndefined, **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+- **encoder**:
+- **models_as_dict**:
+- **dumps_kwargs**:
+
+
+
+
+### method model_construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+Creates a new instance of the `Model` class with validated data.
+
+Creates a new model setting `__dict__` and `__pydantic_fields_set__` from trusted or pre-validated data.
+Default values are respected, but no other validation is performed.
+
+!!! note
+ `model_construct()` generally respects the `model_config.extra` setting on the provided model.
+ That is, if `model_config.extra == 'allow'`, then all extra passed values are added to the model instance's `__dict__`
+ and `__pydantic_extra__` fields. If `model_config.extra == 'ignore'` (the default), then all extra passed values are ignored.
+ Because no validation is performed with a call to `model_construct()`, having `model_config.extra == 'forbid'` does not result in
+ an error if extra values are passed, but they will be ignored.
+
+##### Arguments
+
+- **_fields_set**: A set of field names that were originally explicitly set during instantiation. If provided, this is directly used for the [`model_fields_set`][pydantic.BaseModel.model_fields_set] attribute. Otherwise, the field names from the `values` argument will be used.
+- **values**: Trusted or pre-validated data dictionary.
+
+
+
+
+### method model_copy
+
+```python
+self, *,
+update: 'Mapping[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+!!! abstract "Usage Documentation"
+ [`model_copy`](../concepts/serialization.md#model_copy)
+
+Returns a copy of the model.
+
+!!! note
+ The underlying instance's [`__dict__`][object.__dict__] attribute is copied. This
+ might have unexpected side effects if you store anything in it, on top of the model
+ fields (e.g. the value of [cached properties][functools.cached_property]).
+
+##### Arguments
+
+- **update**: Values to change/add in the new model. Note: the data is not validated before creating the new model. You should trust this data.
+- **deep**: Set to `True` to make a deep copy of the model.
+
+
+
+
+### method model_dump
+
+```python
+self, *,
+mode: 'str' = 'json', **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump`](../concepts/serialization.md#modelmodel_dump)
+
+Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
+
+##### Arguments
+
+- **mode**: The mode in which `to_python` should run. If mode is 'json', the output will only contain JSON serializable types. If mode is 'python', the output may contain non-JSON-serializable Python objects.
+- **kwargs**:
+
+
+
+
+### method model_dump_json
+
+```python
+self, *,
+indent: 'int | None' = None, **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump_json`](../concepts/serialization.md#modelmodel_dump_json)
+
+Generates a JSON representation of the model using Pydantic's `to_json` method.
+
+##### Arguments
+
+- **indent**: Indentation to use in the JSON output. If None is passed, the output will be compact.
+- **kwargs**:
+
+
+
+
+### method model_json_schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}',
+schema_generator: 'type[GenerateJsonSchema]' = ,
+mode: 'JsonSchemaMode' = 'validation'
+```
+
+Generates a JSON schema for a model class.
+
+##### Arguments
+
+- **by_alias**: Whether to use attribute aliases or not.
+- **ref_template**: The reference template.
+- **schema_generator**: To override the logic used to generate the JSON schema, as a subclass of `GenerateJsonSchema` with your desired modifications
+- **mode**: The mode in which to generate the schema.
+
+
+
+
+### method model_parametrized_name
+
+```python
+params: 'tuple[type[Any], ...]'
+```
+
+Compute the class name for parametrizations of generic classes.
+
+This method can be overridden to achieve a custom naming scheme for generic BaseModels.
+
+##### Arguments
+
+- **params**: Tuple of types of the class. Given a generic class `Model` with 2 type variables and a concrete model `Model[str, int]`, the value `(str, int)` would be passed to `params`.
+
+
+##### Raises
+
+- **TypeError**: Raised when trying to generate concrete names for non-generic models.
+
+
+### method model_post_init
+
+```python
+self,
+context: 'Any', /
+```
+
+Override this method to perform additional initialization after `__init__` and `model_construct`.
+This is useful if you want to do some validation that requires the entire model to be initialized.
+
+##### Arguments
+
+- **context**:
+
+
+
+
+### method model_rebuild
+
+```python
+*,
+force: 'bool' = False,
+raise_errors: 'bool' = True,
+_parent_namespace_depth: 'int' = 2,
+_types_namespace: 'MappingNamespace | None' = None
+```
+
+Try to rebuild the pydantic-core schema for the model.
+
+This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
+the initial attempt to build the schema, and automatic rebuilding fails.
+
+##### Arguments
+
+- **force**: Whether to force the rebuilding of the model schema, defaults to `False`.
+- **raise_errors**: Whether to raise errors, defaults to `True`.
+- **_parent_namespace_depth**: The depth level of the parent namespace, defaults to 2.
+- **_types_namespace**: The types namespace, defaults to `None`.
+
+
+
+
+### method model_validate
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+from_attributes: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate a pydantic model instance.
+
+##### Arguments
+
+- **obj**: The object to validate.
+- **strict**: Whether to enforce types strictly.
+- **from_attributes**: Whether to extract data from object attributes.
+- **context**: Additional context to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If the object could not be validated.
+
+
+### method model_validate_json
+
+```python
+json_data: 'str | bytes | bytearray', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+!!! abstract "Usage Documentation"
+ [JSON Parsing](../concepts/json.md#json-parsing)
+
+Validate the given JSON data against the Pydantic model.
+
+##### Arguments
+
+- **json_data**: The JSON data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If `json_data` is not a JSON string or the object could not be validated.
+
+
+### method model_validate_strings
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate the given object with string data against the Pydantic model.
+
+##### Arguments
+
+- **obj**: The object containing string data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+
+
+### method parse_file
+
+```python
+path: 'str | Path', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **path**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method parse_obj
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method parse_raw
+
+```python
+b: 'str | bytes', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **b**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+
+
+
+
+### method schema_json
+
+```python
+*,
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}', **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+- **dumps_kwargs**:
+
+
+
+
+### method update_forward_refs
+
+```python
+**localns: 'Any'
+```
+
+
+
+##### Arguments
+
+- **localns**:
+
+
+
+
+### method validate
+
+```python
+value: 'Any'
+```
+
+
+
+##### Arguments
+
+- **value**:
+
+
+
+
-The scope in which the triggering event must occur.
-**Returns:**
- - `Optional[AutomationScope]`: The scope property value.
diff --git a/models/ref/python/automations/onaddartifactalias.mdx b/models/ref/python/automations/onaddartifactalias.mdx
index 9f5eaec7b4..4cbe92e92a 100644
--- a/models/ref/python/automations/onaddartifactalias.mdx
+++ b/models/ref/python/automations/onaddartifactalias.mdx
@@ -1,18 +1,38 @@
---
title: OnAddArtifactAlias
-namespace: automations_namespace
-python_object_type: class
+kind: class
+namespace: wandb.automations.events
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+```python
+*,
+event_type: Literal[ADD_ARTIFACT_ALIAS] = ADD_ARTIFACT_ALIAS,
+scope: typing.Annotated[wandb.automations.scopes._ArtifactSequenceScope | wandb.automations.scopes._ArtifactPortfolioScope | wandb.automations.scopes.ProjectScope, BeforeValidator(func=, json_schema_input_type=PydanticUndefined)],
+filter: typing.Annotated[wandb.automations._filters.operators.And | wandb.automations._filters.operators.Or | wandb.automations._filters.operators.Nor | wandb.automations._filters.operators.Not | wandb.automations._filters.operators.Lt | wandb.automations._filters.operators.Gt | wandb.automations._filters.operators.Lte | wandb.automations._filters.operators.Gte | wandb.automations._filters.operators.Eq | wandb.automations._filters.operators.Ne | wandb.automations._filters.operators.In | wandb.automations._filters.operators.NotIn | wandb.automations._filters.operators.Exists | wandb.automations._filters.operators.Regex | wandb.automations._filters.operators.Contains | wandb.automations._filters.expressions.FilterExpr | dict[str, typing.Any], Json, BeforeValidator(func=, json_schema_input_type=PydanticUndefined), PlainSerializer(func=, return_type=PydanticUndefined, when_used='always'), AfterValidator(func=)] = And(())
+```
+
+## Description
-## class `OnAddArtifactAlias`
A new alias is assigned to an artifact.
-Examples:
+
+
+## Args
+
+- **event_type**:
+- **scope**:
+- **filter**:
+
+
+## Examples
+
Define an event that triggers whenever the alias "prod" is assigned to
any artifact in the collection "my-collection":
@@ -30,21 +50,527 @@ event = OnAddArtifactAlias(
```
-### method `OnAddArtifactAlias.__init__`
+
+## Methods
+
+### method construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+
+
+##### Arguments
+
+- **_fields_set**:
+- **values**:
+
+
+
+
+### method copy
+
+```python
+self, *,
+include: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+exclude: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+update: 'Dict[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+Returns a copy of the model.
+
+!!! warning "Deprecated"
+ This method is now deprecated; use `model_copy` instead.
+
+If you need `include` or `exclude`, use:
+
+```python {test="skip" lint="skip"}
+data = self.model_dump(include=include, exclude=exclude, round_trip=True)
+data = {**data, **(update or {})}
+copied = self.model_validate(data)
+```
+
+##### Arguments
+
+- **include**: Optional set or mapping specifying which fields to include in the copied model.
+- **exclude**: Optional set or mapping specifying which fields to exclude in the copied model.
+- **update**: Optional dictionary of field-value pairs to override field values in the copied model.
+- **deep**: If True, the values of fields that are Pydantic models will be deep-copied.
+
+
+
+
+### method dict
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+
+
+
+
+### method from_orm
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method json
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False,
+encoder: 'Callable[[Any], Any] | None' = PydanticUndefined,
+models_as_dict: 'bool' = PydanticUndefined, **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+- **encoder**:
+- **models_as_dict**:
+- **dumps_kwargs**:
+
+
+
+
+### method model_construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+Creates a new instance of the `Model` class with validated data.
+
+Creates a new model setting `__dict__` and `__pydantic_fields_set__` from trusted or pre-validated data.
+Default values are respected, but no other validation is performed.
+
+!!! note
+ `model_construct()` generally respects the `model_config.extra` setting on the provided model.
+ That is, if `model_config.extra == 'allow'`, then all extra passed values are added to the model instance's `__dict__`
+ and `__pydantic_extra__` fields. If `model_config.extra == 'ignore'` (the default), then all extra passed values are ignored.
+ Because no validation is performed with a call to `model_construct()`, having `model_config.extra == 'forbid'` does not result in
+ an error if extra values are passed, but they will be ignored.
+
+##### Arguments
+
+- **_fields_set**: A set of field names that were originally explicitly set during instantiation. If provided, this is directly used for the [`model_fields_set`][pydantic.BaseModel.model_fields_set] attribute. Otherwise, the field names from the `values` argument will be used.
+- **values**: Trusted or pre-validated data dictionary.
+
+
+
+
+### method model_copy
+
+```python
+self, *,
+update: 'Mapping[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+!!! abstract "Usage Documentation"
+ [`model_copy`](../concepts/serialization.md#model_copy)
+
+Returns a copy of the model.
+
+!!! note
+ The underlying instance's [`__dict__`][object.__dict__] attribute is copied. This
+ might have unexpected side effects if you store anything in it, on top of the model
+ fields (e.g. the value of [cached properties][functools.cached_property]).
+
+##### Arguments
+
+- **update**: Values to change/add in the new model. Note: the data is not validated before creating the new model. You should trust this data.
+- **deep**: Set to `True` to make a deep copy of the model.
+
+
+
+
+### method model_dump
+
+```python
+self, *,
+mode: 'str' = 'json', **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump`](../concepts/serialization.md#modelmodel_dump)
+
+Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
+
+##### Arguments
+
+- **mode**: The mode in which `to_python` should run. If mode is 'json', the output will only contain JSON serializable types. If mode is 'python', the output may contain non-JSON-serializable Python objects.
+- **kwargs**:
+
+
+
+
+### method model_dump_json
+
+```python
+self, *,
+indent: 'int | None' = None, **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump_json`](../concepts/serialization.md#modelmodel_dump_json)
+
+Generates a JSON representation of the model using Pydantic's `to_json` method.
+
+##### Arguments
+
+- **indent**: Indentation to use in the JSON output. If None is passed, the output will be compact.
+- **kwargs**:
+
+
+
+
+### method model_json_schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}',
+schema_generator: 'type[GenerateJsonSchema]' = ,
+mode: 'JsonSchemaMode' = 'validation'
+```
+
+Generates a JSON schema for a model class.
+
+##### Arguments
+
+- **by_alias**: Whether to use attribute aliases or not.
+- **ref_template**: The reference template.
+- **schema_generator**: To override the logic used to generate the JSON schema, as a subclass of `GenerateJsonSchema` with your desired modifications
+- **mode**: The mode in which to generate the schema.
+
+
+
+
+### method model_parametrized_name
+
+```python
+params: 'tuple[type[Any], ...]'
+```
+
+Compute the class name for parametrizations of generic classes.
+
+This method can be overridden to achieve a custom naming scheme for generic BaseModels.
+
+##### Arguments
+
+- **params**: Tuple of types of the class. Given a generic class `Model` with 2 type variables and a concrete model `Model[str, int]`, the value `(str, int)` would be passed to `params`.
+
+
+##### Raises
+
+- **TypeError**: Raised when trying to generate concrete names for non-generic models.
+
+
+### method model_post_init
+
+```python
+self,
+context: 'Any', /
+```
+
+Override this method to perform additional initialization after `__init__` and `model_construct`.
+This is useful if you want to do some validation that requires the entire model to be initialized.
+
+##### Arguments
+
+- **context**:
+
+
+
+
+### method model_rebuild
+
+```python
+*,
+force: 'bool' = False,
+raise_errors: 'bool' = True,
+_parent_namespace_depth: 'int' = 2,
+_types_namespace: 'MappingNamespace | None' = None
+```
+
+Try to rebuild the pydantic-core schema for the model.
+
+This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
+the initial attempt to build the schema, and automatic rebuilding fails.
+
+##### Arguments
+
+- **force**: Whether to force the rebuilding of the model schema, defaults to `False`.
+- **raise_errors**: Whether to raise errors, defaults to `True`.
+- **_parent_namespace_depth**: The depth level of the parent namespace, defaults to 2.
+- **_types_namespace**: The types namespace, defaults to `None`.
+
+
+
+
+### method model_validate
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+from_attributes: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate a pydantic model instance.
+
+##### Arguments
+
+- **obj**: The object to validate.
+- **strict**: Whether to enforce types strictly.
+- **from_attributes**: Whether to extract data from object attributes.
+- **context**: Additional context to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If the object could not be validated.
+
+
+### method model_validate_json
+
+```python
+json_data: 'str | bytes | bytearray', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+!!! abstract "Usage Documentation"
+ [JSON Parsing](../concepts/json.md#json-parsing)
+
+Validate the given JSON data against the Pydantic model.
+
+##### Arguments
+
+- **json_data**: The JSON data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If `json_data` is not a JSON string or the object could not be validated.
+
+
+### method model_validate_strings
```python
-__init__(
- event_type: 'Literal[ADD_ARTIFACT_ALIAS]' = ADD_ARTIFACT_ALIAS,
- scope: '_ArtifactSequenceScope | _ArtifactPortfolioScope | ProjectScope',
- filter: 'And | Or | Nor | Not | Lt | Gt | Lte | Gte | Eq | Ne | In | NotIn | Exists | Regex | Contains | FilterExpr | dict[str, Any]' = And(())
-) → None
+obj: 'Any', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
```
-**Args:**
-
- - `event_type` (Literal[ADD_ARTIFACT_ALIAS]):
- - `scope` (Union[_ArtifactSequenceScope, _ArtifactPortfolioScope, ProjectScope]): The scope of the event.
- - `filter` (Union[And, Or, Nor, Not, Lt, Gt, Lte, Gte, Eq, Ne, In, NotIn, Exists, Regex, Contains, FilterExpr, Dict[str, Any]]): Additional conditions(s), if any, that are required for this event to trigger.
+Validate the given object with string data against the Pydantic model.
+
+##### Arguments
+
+- **obj**: The object containing string data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+
+
+### method parse_file
+
+```python
+path: 'str | Path', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **path**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method parse_obj
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method parse_raw
+
+```python
+b: 'str | bytes', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **b**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+
+
+
+
+### method schema_json
+
+```python
+*,
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}', **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+- **dumps_kwargs**:
+
+
+
+
+### method then
+
+```python
+self,
+action: 'InputAction'
+```
+
+Define a new Automation in which this event triggers the given action.
+
+##### Arguments
+
+- **action**:
+
+
+
+
+### method update_forward_refs
+
+```python
+**localns: 'Any'
+```
+
+
+
+##### Arguments
+
+- **localns**:
+
+
+
+
+### method validate
+
+```python
+value: 'Any'
+```
+
+
+
+##### Arguments
+
+- **value**:
+
+
+
+
+
-**Returns:**
- An `OnAddArtifactAlias` object.
diff --git a/models/ref/python/automations/oncreateartifact.mdx b/models/ref/python/automations/oncreateartifact.mdx
index bf8c53107d..158a12e807 100644
--- a/models/ref/python/automations/oncreateartifact.mdx
+++ b/models/ref/python/automations/oncreateartifact.mdx
@@ -1,18 +1,38 @@
---
title: OnCreateArtifact
-namespace: automations_namespace
-python_object_type: class
+kind: class
+namespace: wandb.automations.events
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+```python
+*,
+event_type: Literal[CREATE_ARTIFACT] = CREATE_ARTIFACT,
+scope: typing.Annotated[wandb.automations.scopes._ArtifactSequenceScope | wandb.automations.scopes._ArtifactPortfolioScope, BeforeValidator(func=, json_schema_input_type=PydanticUndefined)],
+filter: typing.Annotated[wandb.automations._filters.operators.And | wandb.automations._filters.operators.Or | wandb.automations._filters.operators.Nor | wandb.automations._filters.operators.Not | wandb.automations._filters.operators.Lt | wandb.automations._filters.operators.Gt | wandb.automations._filters.operators.Lte | wandb.automations._filters.operators.Gte | wandb.automations._filters.operators.Eq | wandb.automations._filters.operators.Ne | wandb.automations._filters.operators.In | wandb.automations._filters.operators.NotIn | wandb.automations._filters.operators.Exists | wandb.automations._filters.operators.Regex | wandb.automations._filters.operators.Contains | wandb.automations._filters.expressions.FilterExpr | dict[str, typing.Any], Json, BeforeValidator(func=, json_schema_input_type=PydanticUndefined), PlainSerializer(func=, return_type=PydanticUndefined, when_used='always'), AfterValidator(func=)] = And(())
+```
+
+## Description
-## class `OnCreateArtifact`
A new artifact is created.
-Examples:
+
+
+## Args
+
+- **event_type**:
+- **scope**:
+- **filter**:
+
+
+## Examples
+
Define an event that triggers when a new artifact is created in the
collection "my-collection":
@@ -27,21 +47,527 @@ event = OnCreateArtifact(scope=collection)
```
-### method `OnCreateArtifact.__init__`
+
+## Methods
+
+### method construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+
+
+##### Arguments
+
+- **_fields_set**:
+- **values**:
+
+
+
+
+### method copy
+
+```python
+self, *,
+include: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+exclude: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+update: 'Dict[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+Returns a copy of the model.
+
+!!! warning "Deprecated"
+ This method is now deprecated; use `model_copy` instead.
+
+If you need `include` or `exclude`, use:
+
+```python {test="skip" lint="skip"}
+data = self.model_dump(include=include, exclude=exclude, round_trip=True)
+data = {**data, **(update or {})}
+copied = self.model_validate(data)
+```
+
+##### Arguments
+
+- **include**: Optional set or mapping specifying which fields to include in the copied model.
+- **exclude**: Optional set or mapping specifying which fields to exclude in the copied model.
+- **update**: Optional dictionary of field-value pairs to override field values in the copied model.
+- **deep**: If True, the values of fields that are Pydantic models will be deep-copied.
+
+
+
+
+### method dict
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+
+
+
+
+### method from_orm
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method json
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False,
+encoder: 'Callable[[Any], Any] | None' = PydanticUndefined,
+models_as_dict: 'bool' = PydanticUndefined, **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+- **encoder**:
+- **models_as_dict**:
+- **dumps_kwargs**:
+
+
+
+
+### method model_construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+Creates a new instance of the `Model` class with validated data.
+
+Creates a new model setting `__dict__` and `__pydantic_fields_set__` from trusted or pre-validated data.
+Default values are respected, but no other validation is performed.
+
+!!! note
+ `model_construct()` generally respects the `model_config.extra` setting on the provided model.
+ That is, if `model_config.extra == 'allow'`, then all extra passed values are added to the model instance's `__dict__`
+ and `__pydantic_extra__` fields. If `model_config.extra == 'ignore'` (the default), then all extra passed values are ignored.
+ Because no validation is performed with a call to `model_construct()`, having `model_config.extra == 'forbid'` does not result in
+ an error if extra values are passed, but they will be ignored.
+
+##### Arguments
+
+- **_fields_set**: A set of field names that were originally explicitly set during instantiation. If provided, this is directly used for the [`model_fields_set`][pydantic.BaseModel.model_fields_set] attribute. Otherwise, the field names from the `values` argument will be used.
+- **values**: Trusted or pre-validated data dictionary.
+
+
+
+
+### method model_copy
+
+```python
+self, *,
+update: 'Mapping[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+!!! abstract "Usage Documentation"
+ [`model_copy`](../concepts/serialization.md#model_copy)
+
+Returns a copy of the model.
+
+!!! note
+ The underlying instance's [`__dict__`][object.__dict__] attribute is copied. This
+ might have unexpected side effects if you store anything in it, on top of the model
+ fields (e.g. the value of [cached properties][functools.cached_property]).
+
+##### Arguments
+
+- **update**: Values to change/add in the new model. Note: the data is not validated before creating the new model. You should trust this data.
+- **deep**: Set to `True` to make a deep copy of the model.
+
+
+
+
+### method model_dump
+
+```python
+self, *,
+mode: 'str' = 'json', **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump`](../concepts/serialization.md#modelmodel_dump)
+
+Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
+
+##### Arguments
+
+- **mode**: The mode in which `to_python` should run. If mode is 'json', the output will only contain JSON serializable types. If mode is 'python', the output may contain non-JSON-serializable Python objects.
+- **kwargs**:
+
+
+
+
+### method model_dump_json
+
+```python
+self, *,
+indent: 'int | None' = None, **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump_json`](../concepts/serialization.md#modelmodel_dump_json)
+
+Generates a JSON representation of the model using Pydantic's `to_json` method.
+
+##### Arguments
+
+- **indent**: Indentation to use in the JSON output. If None is passed, the output will be compact.
+- **kwargs**:
+
+
+
+
+### method model_json_schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}',
+schema_generator: 'type[GenerateJsonSchema]' = ,
+mode: 'JsonSchemaMode' = 'validation'
+```
+
+Generates a JSON schema for a model class.
+
+##### Arguments
+
+- **by_alias**: Whether to use attribute aliases or not.
+- **ref_template**: The reference template.
+- **schema_generator**: To override the logic used to generate the JSON schema, as a subclass of `GenerateJsonSchema` with your desired modifications
+- **mode**: The mode in which to generate the schema.
+
+
+
+
+### method model_parametrized_name
+
+```python
+params: 'tuple[type[Any], ...]'
+```
+
+Compute the class name for parametrizations of generic classes.
+
+This method can be overridden to achieve a custom naming scheme for generic BaseModels.
+
+##### Arguments
+
+- **params**: Tuple of types of the class. Given a generic class `Model` with 2 type variables and a concrete model `Model[str, int]`, the value `(str, int)` would be passed to `params`.
+
+
+##### Raises
+
+- **TypeError**: Raised when trying to generate concrete names for non-generic models.
+
+
+### method model_post_init
+
+```python
+self,
+context: 'Any', /
+```
+
+Override this method to perform additional initialization after `__init__` and `model_construct`.
+This is useful if you want to do some validation that requires the entire model to be initialized.
+
+##### Arguments
+
+- **context**:
+
+
+
+
+### method model_rebuild
+
+```python
+*,
+force: 'bool' = False,
+raise_errors: 'bool' = True,
+_parent_namespace_depth: 'int' = 2,
+_types_namespace: 'MappingNamespace | None' = None
+```
+
+Try to rebuild the pydantic-core schema for the model.
+
+This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
+the initial attempt to build the schema, and automatic rebuilding fails.
+
+##### Arguments
+
+- **force**: Whether to force the rebuilding of the model schema, defaults to `False`.
+- **raise_errors**: Whether to raise errors, defaults to `True`.
+- **_parent_namespace_depth**: The depth level of the parent namespace, defaults to 2.
+- **_types_namespace**: The types namespace, defaults to `None`.
+
+
+
+
+### method model_validate
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+from_attributes: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate a pydantic model instance.
+
+##### Arguments
+
+- **obj**: The object to validate.
+- **strict**: Whether to enforce types strictly.
+- **from_attributes**: Whether to extract data from object attributes.
+- **context**: Additional context to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If the object could not be validated.
+
+
+### method model_validate_json
+
+```python
+json_data: 'str | bytes | bytearray', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+!!! abstract "Usage Documentation"
+ [JSON Parsing](../concepts/json.md#json-parsing)
+
+Validate the given JSON data against the Pydantic model.
+
+##### Arguments
+
+- **json_data**: The JSON data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If `json_data` is not a JSON string or the object could not be validated.
+
+
+### method model_validate_strings
```python
-__init__(
- event_type: 'Literal[CREATE_ARTIFACT]' = CREATE_ARTIFACT,
- scope: '_ArtifactSequenceScope | _ArtifactPortfolioScope',
- filter: 'And | Or | Nor | Not | Lt | Gt | Lte | Gte | Eq | Ne | In | NotIn | Exists | Regex | Contains | FilterExpr | dict[str, Any]' = And(())
-) → None
+obj: 'Any', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
```
-**Args:**
-
- - `event_type` (Literal[CREATE_ARTIFACT]):
- - `scope` (Union[_ArtifactSequenceScope, _ArtifactPortfolioScope]): The scope of the event: must be an artifact collection.
- - `filter` (Union[And, Or, Nor, Not, Lt, Gt, Lte, Gte, Eq, Ne, In, NotIn, Exists, Regex, Contains, FilterExpr, Dict[str, Any]]): Additional conditions(s), if any, that are required for this event to trigger.
+Validate the given object with string data against the Pydantic model.
+
+##### Arguments
+
+- **obj**: The object containing string data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+
+
+### method parse_file
+
+```python
+path: 'str | Path', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **path**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method parse_obj
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method parse_raw
+
+```python
+b: 'str | bytes', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **b**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+
+
+
+
+### method schema_json
+
+```python
+*,
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}', **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+- **dumps_kwargs**:
+
+
+
+
+### method then
+
+```python
+self,
+action: 'InputAction'
+```
+
+Define a new Automation in which this event triggers the given action.
+
+##### Arguments
+
+- **action**:
+
+
+
+
+### method update_forward_refs
+
+```python
+**localns: 'Any'
+```
+
+
+
+##### Arguments
+
+- **localns**:
+
+
+
+
+### method validate
+
+```python
+value: 'Any'
+```
+
+
+
+##### Arguments
+
+- **value**:
+
+
+
+
+
-**Returns:**
- An `OnCreateArtifact` object.
diff --git a/models/ref/python/automations/onlinkartifact.mdx b/models/ref/python/automations/onlinkartifact.mdx
index 45572aa1ca..e2cfffca47 100644
--- a/models/ref/python/automations/onlinkartifact.mdx
+++ b/models/ref/python/automations/onlinkartifact.mdx
@@ -1,18 +1,38 @@
---
title: OnLinkArtifact
-namespace: automations_namespace
-python_object_type: class
+kind: class
+namespace: wandb.automations.events
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+```python
+*,
+event_type: Literal[LINK_ARTIFACT] = LINK_ARTIFACT,
+scope: typing.Annotated[wandb.automations.scopes._ArtifactSequenceScope | wandb.automations.scopes._ArtifactPortfolioScope | wandb.automations.scopes.ProjectScope, BeforeValidator(func=, json_schema_input_type=PydanticUndefined)],
+filter: typing.Annotated[wandb.automations._filters.operators.And | wandb.automations._filters.operators.Or | wandb.automations._filters.operators.Nor | wandb.automations._filters.operators.Not | wandb.automations._filters.operators.Lt | wandb.automations._filters.operators.Gt | wandb.automations._filters.operators.Lte | wandb.automations._filters.operators.Gte | wandb.automations._filters.operators.Eq | wandb.automations._filters.operators.Ne | wandb.automations._filters.operators.In | wandb.automations._filters.operators.NotIn | wandb.automations._filters.operators.Exists | wandb.automations._filters.operators.Regex | wandb.automations._filters.operators.Contains | wandb.automations._filters.expressions.FilterExpr | dict[str, typing.Any], Json, BeforeValidator(func=, json_schema_input_type=PydanticUndefined), PlainSerializer(func=, return_type=PydanticUndefined, when_used='always'), AfterValidator(func=)] = And(())
+```
+
+## Description
-## class `OnLinkArtifact`
A new artifact is linked to a collection.
-Examples:
+
+
+## Args
+
+- **event_type**:
+- **scope**:
+- **filter**:
+
+
+## Examples
+
Define an event that triggers when an artifact is linked to the
collection "my-collection" with the alias "prod":
@@ -30,21 +50,527 @@ event = OnLinkArtifact(
```
-### method `OnLinkArtifact.__init__`
+
+## Methods
+
+### method construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+
+
+##### Arguments
+
+- **_fields_set**:
+- **values**:
+
+
+
+
+### method copy
+
+```python
+self, *,
+include: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+exclude: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+update: 'Dict[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+Returns a copy of the model.
+
+!!! warning "Deprecated"
+ This method is now deprecated; use `model_copy` instead.
+
+If you need `include` or `exclude`, use:
+
+```python {test="skip" lint="skip"}
+data = self.model_dump(include=include, exclude=exclude, round_trip=True)
+data = {**data, **(update or {})}
+copied = self.model_validate(data)
+```
+
+##### Arguments
+
+- **include**: Optional set or mapping specifying which fields to include in the copied model.
+- **exclude**: Optional set or mapping specifying which fields to exclude in the copied model.
+- **update**: Optional dictionary of field-value pairs to override field values in the copied model.
+- **deep**: If True, the values of fields that are Pydantic models will be deep-copied.
+
+
+
+
+### method dict
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+
+
+
+
+### method from_orm
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method json
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False,
+encoder: 'Callable[[Any], Any] | None' = PydanticUndefined,
+models_as_dict: 'bool' = PydanticUndefined, **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+- **encoder**:
+- **models_as_dict**:
+- **dumps_kwargs**:
+
+
+
+
+### method model_construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+Creates a new instance of the `Model` class with validated data.
+
+Creates a new model setting `__dict__` and `__pydantic_fields_set__` from trusted or pre-validated data.
+Default values are respected, but no other validation is performed.
+
+!!! note
+ `model_construct()` generally respects the `model_config.extra` setting on the provided model.
+ That is, if `model_config.extra == 'allow'`, then all extra passed values are added to the model instance's `__dict__`
+ and `__pydantic_extra__` fields. If `model_config.extra == 'ignore'` (the default), then all extra passed values are ignored.
+ Because no validation is performed with a call to `model_construct()`, having `model_config.extra == 'forbid'` does not result in
+ an error if extra values are passed, but they will be ignored.
+
+##### Arguments
+
+- **_fields_set**: A set of field names that were originally explicitly set during instantiation. If provided, this is directly used for the [`model_fields_set`][pydantic.BaseModel.model_fields_set] attribute. Otherwise, the field names from the `values` argument will be used.
+- **values**: Trusted or pre-validated data dictionary.
+
+
+
+
+### method model_copy
+
+```python
+self, *,
+update: 'Mapping[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+!!! abstract "Usage Documentation"
+ [`model_copy`](../concepts/serialization.md#model_copy)
+
+Returns a copy of the model.
+
+!!! note
+ The underlying instance's [`__dict__`][object.__dict__] attribute is copied. This
+ might have unexpected side effects if you store anything in it, on top of the model
+ fields (e.g. the value of [cached properties][functools.cached_property]).
+
+##### Arguments
+
+- **update**: Values to change/add in the new model. Note: the data is not validated before creating the new model. You should trust this data.
+- **deep**: Set to `True` to make a deep copy of the model.
+
+
+
+
+### method model_dump
+
+```python
+self, *,
+mode: 'str' = 'json', **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump`](../concepts/serialization.md#modelmodel_dump)
+
+Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
+
+##### Arguments
+
+- **mode**: The mode in which `to_python` should run. If mode is 'json', the output will only contain JSON serializable types. If mode is 'python', the output may contain non-JSON-serializable Python objects.
+- **kwargs**:
+
+
+
+
+### method model_dump_json
+
+```python
+self, *,
+indent: 'int | None' = None, **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump_json`](../concepts/serialization.md#modelmodel_dump_json)
+
+Generates a JSON representation of the model using Pydantic's `to_json` method.
+
+##### Arguments
+
+- **indent**: Indentation to use in the JSON output. If None is passed, the output will be compact.
+- **kwargs**:
+
+
+
+
+### method model_json_schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}',
+schema_generator: 'type[GenerateJsonSchema]' = ,
+mode: 'JsonSchemaMode' = 'validation'
+```
+
+Generates a JSON schema for a model class.
+
+##### Arguments
+
+- **by_alias**: Whether to use attribute aliases or not.
+- **ref_template**: The reference template.
+- **schema_generator**: To override the logic used to generate the JSON schema, as a subclass of `GenerateJsonSchema` with your desired modifications
+- **mode**: The mode in which to generate the schema.
+
+
+
+
+### method model_parametrized_name
+
+```python
+params: 'tuple[type[Any], ...]'
+```
+
+Compute the class name for parametrizations of generic classes.
+
+This method can be overridden to achieve a custom naming scheme for generic BaseModels.
+
+##### Arguments
+
+- **params**: Tuple of types of the class. Given a generic class `Model` with 2 type variables and a concrete model `Model[str, int]`, the value `(str, int)` would be passed to `params`.
+
+
+##### Raises
+
+- **TypeError**: Raised when trying to generate concrete names for non-generic models.
+
+
+### method model_post_init
+
+```python
+self,
+context: 'Any', /
+```
+
+Override this method to perform additional initialization after `__init__` and `model_construct`.
+This is useful if you want to do some validation that requires the entire model to be initialized.
+
+##### Arguments
+
+- **context**:
+
+
+
+
+### method model_rebuild
+
+```python
+*,
+force: 'bool' = False,
+raise_errors: 'bool' = True,
+_parent_namespace_depth: 'int' = 2,
+_types_namespace: 'MappingNamespace | None' = None
+```
+
+Try to rebuild the pydantic-core schema for the model.
+
+This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
+the initial attempt to build the schema, and automatic rebuilding fails.
+
+##### Arguments
+
+- **force**: Whether to force the rebuilding of the model schema, defaults to `False`.
+- **raise_errors**: Whether to raise errors, defaults to `True`.
+- **_parent_namespace_depth**: The depth level of the parent namespace, defaults to 2.
+- **_types_namespace**: The types namespace, defaults to `None`.
+
+
+
+
+### method model_validate
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+from_attributes: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate a pydantic model instance.
+
+##### Arguments
+
+- **obj**: The object to validate.
+- **strict**: Whether to enforce types strictly.
+- **from_attributes**: Whether to extract data from object attributes.
+- **context**: Additional context to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If the object could not be validated.
+
+
+### method model_validate_json
+
+```python
+json_data: 'str | bytes | bytearray', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+!!! abstract "Usage Documentation"
+ [JSON Parsing](../concepts/json.md#json-parsing)
+
+Validate the given JSON data against the Pydantic model.
+
+##### Arguments
+
+- **json_data**: The JSON data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If `json_data` is not a JSON string or the object could not be validated.
+
+
+### method model_validate_strings
```python
-__init__(
- event_type: 'Literal[LINK_ARTIFACT]' = LINK_ARTIFACT,
- scope: '_ArtifactSequenceScope | _ArtifactPortfolioScope | ProjectScope',
- filter: 'And | Or | Nor | Not | Lt | Gt | Lte | Gte | Eq | Ne | In | NotIn | Exists | Regex | Contains | FilterExpr | dict[str, Any]' = And(())
-) → None
+obj: 'Any', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
```
-**Args:**
-
- - `event_type` (Literal[LINK_ARTIFACT]):
- - `scope` (Union[_ArtifactSequenceScope, _ArtifactPortfolioScope, ProjectScope]): The scope of the event.
- - `filter` (Union[And, Or, Nor, Not, Lt, Gt, Lte, Gte, Eq, Ne, In, NotIn, Exists, Regex, Contains, FilterExpr, Dict[str, Any]]): Additional conditions(s), if any, that are required for this event to trigger.
+Validate the given object with string data against the Pydantic model.
+
+##### Arguments
+
+- **obj**: The object containing string data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+
+
+### method parse_file
+
+```python
+path: 'str | Path', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **path**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method parse_obj
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method parse_raw
+
+```python
+b: 'str | bytes', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **b**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+
+
+
+
+### method schema_json
+
+```python
+*,
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}', **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+- **dumps_kwargs**:
+
+
+
+
+### method then
+
+```python
+self,
+action: 'InputAction'
+```
+
+Define a new Automation in which this event triggers the given action.
+
+##### Arguments
+
+- **action**:
+
+
+
+
+### method update_forward_refs
+
+```python
+**localns: 'Any'
+```
+
+
+
+##### Arguments
+
+- **localns**:
+
+
+
+
+### method validate
+
+```python
+value: 'Any'
+```
+
+
+
+##### Arguments
+
+- **value**:
+
+
+
+
+
-**Returns:**
- An `OnLinkArtifact` object.
diff --git a/models/ref/python/automations/onrunmetric.mdx b/models/ref/python/automations/onrunmetric.mdx
index 7f1d168745..db7d797acb 100644
--- a/models/ref/python/automations/onrunmetric.mdx
+++ b/models/ref/python/automations/onrunmetric.mdx
@@ -1,18 +1,38 @@
---
title: OnRunMetric
-namespace: automations_namespace
-python_object_type: class
+kind: class
+namespace: wandb.automations.events
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+```python
+*,
+event_type: Literal[RUN_METRIC_THRESHOLD, RUN_METRIC_CHANGE, RUN_METRIC_ZSCORE],
+scope: wandb.automations.scopes.ProjectScope,
+filter: typing.Annotated[wandb.automations.events.RunMetricFilter, Json, BeforeValidator(func=, json_schema_input_type=PydanticUndefined), PlainSerializer(func=, return_type=PydanticUndefined, when_used='always')]
+```
+
+## Description
-## class `OnRunMetric`
A run metric satisfies a user-defined condition.
-Examples:
+
+
+## Args
+
+- **event_type**:
+- **scope**:
+- **filter**:
+
+
+## Examples
+
Define an event that triggers for any run in project "my-project" when
the average of the last 5 values of metric "my-metric" exceeds 123.45:
@@ -30,21 +50,527 @@ event = OnRunMetric(
```
-### method `OnRunMetric.__init__`
+
+## Methods
+
+### method construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+
+
+##### Arguments
+
+- **_fields_set**:
+- **values**:
+
+
+
+
+### method copy
+
+```python
+self, *,
+include: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+exclude: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+update: 'Dict[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+Returns a copy of the model.
+
+!!! warning "Deprecated"
+ This method is now deprecated; use `model_copy` instead.
+
+If you need `include` or `exclude`, use:
+
+```python {test="skip" lint="skip"}
+data = self.model_dump(include=include, exclude=exclude, round_trip=True)
+data = {**data, **(update or {})}
+copied = self.model_validate(data)
+```
+
+##### Arguments
+
+- **include**: Optional set or mapping specifying which fields to include in the copied model.
+- **exclude**: Optional set or mapping specifying which fields to exclude in the copied model.
+- **update**: Optional dictionary of field-value pairs to override field values in the copied model.
+- **deep**: If True, the values of fields that are Pydantic models will be deep-copied.
+
+
+
+
+### method dict
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+
+
+
+
+### method from_orm
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method json
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False,
+encoder: 'Callable[[Any], Any] | None' = PydanticUndefined,
+models_as_dict: 'bool' = PydanticUndefined, **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+- **encoder**:
+- **models_as_dict**:
+- **dumps_kwargs**:
+
+
+
+
+### method model_construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+Creates a new instance of the `Model` class with validated data.
+
+Creates a new model setting `__dict__` and `__pydantic_fields_set__` from trusted or pre-validated data.
+Default values are respected, but no other validation is performed.
+
+!!! note
+ `model_construct()` generally respects the `model_config.extra` setting on the provided model.
+ That is, if `model_config.extra == 'allow'`, then all extra passed values are added to the model instance's `__dict__`
+ and `__pydantic_extra__` fields. If `model_config.extra == 'ignore'` (the default), then all extra passed values are ignored.
+ Because no validation is performed with a call to `model_construct()`, having `model_config.extra == 'forbid'` does not result in
+ an error if extra values are passed, but they will be ignored.
+
+##### Arguments
+
+- **_fields_set**: A set of field names that were originally explicitly set during instantiation. If provided, this is directly used for the [`model_fields_set`][pydantic.BaseModel.model_fields_set] attribute. Otherwise, the field names from the `values` argument will be used.
+- **values**: Trusted or pre-validated data dictionary.
+
+
+
+
+### method model_copy
+
+```python
+self, *,
+update: 'Mapping[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+!!! abstract "Usage Documentation"
+ [`model_copy`](../concepts/serialization.md#model_copy)
+
+Returns a copy of the model.
+
+!!! note
+ The underlying instance's [`__dict__`][object.__dict__] attribute is copied. This
+ might have unexpected side effects if you store anything in it, on top of the model
+ fields (e.g. the value of [cached properties][functools.cached_property]).
+
+##### Arguments
+
+- **update**: Values to change/add in the new model. Note: the data is not validated before creating the new model. You should trust this data.
+- **deep**: Set to `True` to make a deep copy of the model.
+
+
+
+
+### method model_dump
+
+```python
+self, *,
+mode: 'str' = 'json', **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump`](../concepts/serialization.md#modelmodel_dump)
+
+Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
+
+##### Arguments
+
+- **mode**: The mode in which `to_python` should run. If mode is 'json', the output will only contain JSON serializable types. If mode is 'python', the output may contain non-JSON-serializable Python objects.
+- **kwargs**:
+
+
+
+
+### method model_dump_json
+
+```python
+self, *,
+indent: 'int | None' = None, **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump_json`](../concepts/serialization.md#modelmodel_dump_json)
+
+Generates a JSON representation of the model using Pydantic's `to_json` method.
+
+##### Arguments
+
+- **indent**: Indentation to use in the JSON output. If None is passed, the output will be compact.
+- **kwargs**:
+
+
+
+
+### method model_json_schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}',
+schema_generator: 'type[GenerateJsonSchema]' = ,
+mode: 'JsonSchemaMode' = 'validation'
+```
+
+Generates a JSON schema for a model class.
+
+##### Arguments
+
+- **by_alias**: Whether to use attribute aliases or not.
+- **ref_template**: The reference template.
+- **schema_generator**: To override the logic used to generate the JSON schema, as a subclass of `GenerateJsonSchema` with your desired modifications
+- **mode**: The mode in which to generate the schema.
+
+
+
+
+### method model_parametrized_name
+
+```python
+params: 'tuple[type[Any], ...]'
+```
+
+Compute the class name for parametrizations of generic classes.
+
+This method can be overridden to achieve a custom naming scheme for generic BaseModels.
+
+##### Arguments
+
+- **params**: Tuple of types of the class. Given a generic class `Model` with 2 type variables and a concrete model `Model[str, int]`, the value `(str, int)` would be passed to `params`.
+
+
+##### Raises
+
+- **TypeError**: Raised when trying to generate concrete names for non-generic models.
+
+
+### method model_post_init
+
+```python
+self,
+context: 'Any', /
+```
+
+Override this method to perform additional initialization after `__init__` and `model_construct`.
+This is useful if you want to do some validation that requires the entire model to be initialized.
+
+##### Arguments
+
+- **context**:
+
+
+
+
+### method model_rebuild
+
+```python
+*,
+force: 'bool' = False,
+raise_errors: 'bool' = True,
+_parent_namespace_depth: 'int' = 2,
+_types_namespace: 'MappingNamespace | None' = None
+```
+
+Try to rebuild the pydantic-core schema for the model.
+
+This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
+the initial attempt to build the schema, and automatic rebuilding fails.
+
+##### Arguments
+
+- **force**: Whether to force the rebuilding of the model schema, defaults to `False`.
+- **raise_errors**: Whether to raise errors, defaults to `True`.
+- **_parent_namespace_depth**: The depth level of the parent namespace, defaults to 2.
+- **_types_namespace**: The types namespace, defaults to `None`.
+
+
+
+
+### method model_validate
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+from_attributes: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate a pydantic model instance.
+
+##### Arguments
+
+- **obj**: The object to validate.
+- **strict**: Whether to enforce types strictly.
+- **from_attributes**: Whether to extract data from object attributes.
+- **context**: Additional context to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If the object could not be validated.
+
+
+### method model_validate_json
+
+```python
+json_data: 'str | bytes | bytearray', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+!!! abstract "Usage Documentation"
+ [JSON Parsing](../concepts/json.md#json-parsing)
+
+Validate the given JSON data against the Pydantic model.
+
+##### Arguments
+
+- **json_data**: The JSON data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If `json_data` is not a JSON string or the object could not be validated.
+
+
+### method model_validate_strings
```python
-__init__(
- event_type: 'Literal[RUN_METRIC_THRESHOLD, RUN_METRIC_CHANGE, RUN_METRIC_ZSCORE]',
- scope: 'ProjectScope',
- filter: 'RunMetricFilter'
-) → None
+obj: 'Any', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
```
-**Args:**
-
- - `event_type` (Literal[RUN_METRIC_THRESHOLD, RUN_METRIC_CHANGE, RUN_METRIC_ZSCORE]):
- - `scope` (ProjectScope): The scope of the event: must be a project.
- - `filter` (RunMetricFilter): Run and/or metric condition(s) that must be satisfied for this event to trigger.
+Validate the given object with string data against the Pydantic model.
+
+##### Arguments
+
+- **obj**: The object containing string data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+
+
+### method parse_file
+
+```python
+path: 'str | Path', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **path**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method parse_obj
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method parse_raw
+
+```python
+b: 'str | bytes', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **b**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+
+
+
+
+### method schema_json
+
+```python
+*,
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}', **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+- **dumps_kwargs**:
+
+
+
+
+### method then
+
+```python
+self,
+action: 'InputAction'
+```
+
+Define a new Automation in which this event triggers the given action.
+
+##### Arguments
+
+- **action**:
+
+
+
+
+### method update_forward_refs
+
+```python
+**localns: 'Any'
+```
+
+
+
+##### Arguments
+
+- **localns**:
+
+
+
+
+### method validate
+
+```python
+value: 'Any'
+```
+
+
+
+##### Arguments
+
+- **value**:
+
+
+
+
+
-**Returns:**
- An `OnRunMetric` object.
diff --git a/models/ref/python/automations/onrunstate.mdx b/models/ref/python/automations/onrunstate.mdx
index e819d73d91..090a8a543b 100644
--- a/models/ref/python/automations/onrunstate.mdx
+++ b/models/ref/python/automations/onrunstate.mdx
@@ -1,18 +1,38 @@
---
title: OnRunState
-namespace: automations_namespace
-python_object_type: class
+kind: class
+namespace: wandb.automations.events
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+```python
+*,
+event_type: Literal[RUN_STATE] = RUN_STATE,
+scope: wandb.automations.scopes.ProjectScope,
+filter: typing.Annotated[wandb.automations.events.RunStateFilter, Json, BeforeValidator(func=, json_schema_input_type=PydanticUndefined), PlainSerializer(func=, return_type=PydanticUndefined, when_used='always')]
+```
+
+## Description
-## class `OnRunState`
A run state changes.
-Examples:
+
+
+## Args
+
+- **event_type**:
+- **scope**:
+- **filter**:
+
+
+## Examples
+
Define an event that triggers for any run in project "my-project" when
its state changes to "finished" (i.e. succeeded) or "failed":
@@ -30,21 +50,527 @@ event = OnRunState(
```
-### method `OnRunState.__init__`
+
+## Methods
+
+### method construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+
+
+##### Arguments
+
+- **_fields_set**:
+- **values**:
+
+
+
+
+### method copy
+
+```python
+self, *,
+include: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+exclude: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+update: 'Dict[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+Returns a copy of the model.
+
+!!! warning "Deprecated"
+ This method is now deprecated; use `model_copy` instead.
+
+If you need `include` or `exclude`, use:
+
+```python {test="skip" lint="skip"}
+data = self.model_dump(include=include, exclude=exclude, round_trip=True)
+data = {**data, **(update or {})}
+copied = self.model_validate(data)
+```
+
+##### Arguments
+
+- **include**: Optional set or mapping specifying which fields to include in the copied model.
+- **exclude**: Optional set or mapping specifying which fields to exclude in the copied model.
+- **update**: Optional dictionary of field-value pairs to override field values in the copied model.
+- **deep**: If True, the values of fields that are Pydantic models will be deep-copied.
+
+
+
+
+### method dict
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+
+
+
+
+### method from_orm
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method json
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False,
+encoder: 'Callable[[Any], Any] | None' = PydanticUndefined,
+models_as_dict: 'bool' = PydanticUndefined, **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+- **encoder**:
+- **models_as_dict**:
+- **dumps_kwargs**:
+
+
+
+
+### method model_construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+Creates a new instance of the `Model` class with validated data.
+
+Creates a new model setting `__dict__` and `__pydantic_fields_set__` from trusted or pre-validated data.
+Default values are respected, but no other validation is performed.
+
+!!! note
+ `model_construct()` generally respects the `model_config.extra` setting on the provided model.
+ That is, if `model_config.extra == 'allow'`, then all extra passed values are added to the model instance's `__dict__`
+ and `__pydantic_extra__` fields. If `model_config.extra == 'ignore'` (the default), then all extra passed values are ignored.
+ Because no validation is performed with a call to `model_construct()`, having `model_config.extra == 'forbid'` does not result in
+ an error if extra values are passed, but they will be ignored.
+
+##### Arguments
+
+- **_fields_set**: A set of field names that were originally explicitly set during instantiation. If provided, this is directly used for the [`model_fields_set`][pydantic.BaseModel.model_fields_set] attribute. Otherwise, the field names from the `values` argument will be used.
+- **values**: Trusted or pre-validated data dictionary.
+
+
+
+
+### method model_copy
+
+```python
+self, *,
+update: 'Mapping[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+!!! abstract "Usage Documentation"
+ [`model_copy`](../concepts/serialization.md#model_copy)
+
+Returns a copy of the model.
+
+!!! note
+ The underlying instance's [`__dict__`][object.__dict__] attribute is copied. This
+ might have unexpected side effects if you store anything in it, on top of the model
+ fields (e.g. the value of [cached properties][functools.cached_property]).
+
+##### Arguments
+
+- **update**: Values to change/add in the new model. Note: the data is not validated before creating the new model. You should trust this data.
+- **deep**: Set to `True` to make a deep copy of the model.
+
+
+
+
+### method model_dump
+
+```python
+self, *,
+mode: 'str' = 'json', **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump`](../concepts/serialization.md#modelmodel_dump)
+
+Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
+
+##### Arguments
+
+- **mode**: The mode in which `to_python` should run. If mode is 'json', the output will only contain JSON serializable types. If mode is 'python', the output may contain non-JSON-serializable Python objects.
+- **kwargs**:
+
+
+
+
+### method model_dump_json
+
+```python
+self, *,
+indent: 'int | None' = None, **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump_json`](../concepts/serialization.md#modelmodel_dump_json)
+
+Generates a JSON representation of the model using Pydantic's `to_json` method.
+
+##### Arguments
+
+- **indent**: Indentation to use in the JSON output. If None is passed, the output will be compact.
+- **kwargs**:
+
+
+
+
+### method model_json_schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}',
+schema_generator: 'type[GenerateJsonSchema]' = ,
+mode: 'JsonSchemaMode' = 'validation'
+```
+
+Generates a JSON schema for a model class.
+
+##### Arguments
+
+- **by_alias**: Whether to use attribute aliases or not.
+- **ref_template**: The reference template.
+- **schema_generator**: To override the logic used to generate the JSON schema, as a subclass of `GenerateJsonSchema` with your desired modifications
+- **mode**: The mode in which to generate the schema.
+
+
+
+
+### method model_parametrized_name
+
+```python
+params: 'tuple[type[Any], ...]'
+```
+
+Compute the class name for parametrizations of generic classes.
+
+This method can be overridden to achieve a custom naming scheme for generic BaseModels.
+
+##### Arguments
+
+- **params**: Tuple of types of the class. Given a generic class `Model` with 2 type variables and a concrete model `Model[str, int]`, the value `(str, int)` would be passed to `params`.
+
+
+##### Raises
+
+- **TypeError**: Raised when trying to generate concrete names for non-generic models.
+
+
+### method model_post_init
+
+```python
+self,
+context: 'Any', /
+```
+
+Override this method to perform additional initialization after `__init__` and `model_construct`.
+This is useful if you want to do some validation that requires the entire model to be initialized.
+
+##### Arguments
+
+- **context**:
+
+
+
+
+### method model_rebuild
+
+```python
+*,
+force: 'bool' = False,
+raise_errors: 'bool' = True,
+_parent_namespace_depth: 'int' = 2,
+_types_namespace: 'MappingNamespace | None' = None
+```
+
+Try to rebuild the pydantic-core schema for the model.
+
+This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
+the initial attempt to build the schema, and automatic rebuilding fails.
+
+##### Arguments
+
+- **force**: Whether to force the rebuilding of the model schema, defaults to `False`.
+- **raise_errors**: Whether to raise errors, defaults to `True`.
+- **_parent_namespace_depth**: The depth level of the parent namespace, defaults to 2.
+- **_types_namespace**: The types namespace, defaults to `None`.
+
+
+
+
+### method model_validate
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+from_attributes: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate a pydantic model instance.
+
+##### Arguments
+
+- **obj**: The object to validate.
+- **strict**: Whether to enforce types strictly.
+- **from_attributes**: Whether to extract data from object attributes.
+- **context**: Additional context to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If the object could not be validated.
+
+
+### method model_validate_json
+
+```python
+json_data: 'str | bytes | bytearray', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+!!! abstract "Usage Documentation"
+ [JSON Parsing](../concepts/json.md#json-parsing)
+
+Validate the given JSON data against the Pydantic model.
+
+##### Arguments
+
+- **json_data**: The JSON data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If `json_data` is not a JSON string or the object could not be validated.
+
+
+### method model_validate_strings
```python
-__init__(
- event_type: 'Literal[RUN_STATE]' = RUN_STATE,
- scope: 'ProjectScope',
- filter: 'RunStateFilter'
-) → None
+obj: 'Any', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
```
-**Args:**
-
- - `event_type` (Literal[RUN_STATE]):
- - `scope` (ProjectScope): The scope of the event: must be a project.
- - `filter` (RunStateFilter): Run state condition(s) that must be satisfied for this event to trigger.
+Validate the given object with string data against the Pydantic model.
+
+##### Arguments
+
+- **obj**: The object containing string data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+
+
+### method parse_file
+
+```python
+path: 'str | Path', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **path**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method parse_obj
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method parse_raw
+
+```python
+b: 'str | bytes', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **b**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+
+
+
+
+### method schema_json
+
+```python
+*,
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}', **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+- **dumps_kwargs**:
+
+
+
+
+### method then
+
+```python
+self,
+action: 'InputAction'
+```
+
+Define a new Automation in which this event triggers the given action.
+
+##### Arguments
+
+- **action**:
+
+
+
+
+### method update_forward_refs
+
+```python
+**localns: 'Any'
+```
+
+
+
+##### Arguments
+
+- **localns**:
+
+
+
+
+### method validate
+
+```python
+value: 'Any'
+```
+
+
+
+##### Arguments
+
+- **value**:
+
+
+
+
+
-**Returns:**
- An `OnRunState` object.
diff --git a/models/ref/python/automations/runstatefilter.mdx b/models/ref/python/automations/runstatefilter.mdx
index 686bd9b505..e015b2c0cd 100644
--- a/models/ref/python/automations/runstatefilter.mdx
+++ b/models/ref/python/automations/runstatefilter.mdx
@@ -1,31 +1,542 @@
---
title: RunStateFilter
-namespace: automations_namespace
-python_object_type: class
+kind: class
+namespace: wandb.automations.events
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+```python
+*,
+run_filter: typing.Annotated[wandb.automations._filters.operators.And | wandb.automations._filters.operators.Or | wandb.automations._filters.operators.Nor | wandb.automations._filters.operators.Not | wandb.automations._filters.operators.Lt | wandb.automations._filters.operators.Gt | wandb.automations._filters.operators.Lte | wandb.automations._filters.operators.Gte | wandb.automations._filters.operators.Eq | wandb.automations._filters.operators.Ne | wandb.automations._filters.operators.In | wandb.automations._filters.operators.NotIn | wandb.automations._filters.operators.Exists | wandb.automations._filters.operators.Regex | wandb.automations._filters.operators.Contains | wandb.automations._filters.expressions.FilterExpr | dict[str, typing.Any], Json, BeforeValidator(func=, json_schema_input_type=PydanticUndefined), PlainSerializer(func=, return_type=PydanticUndefined, when_used='always'), AfterValidator(func=)] = And(()),
+run_state_filter: wandb.automations._filters.run_states.StateFilter
+```
+
+## Description
-## class `RunStateFilter`
Represents a filter for triggering events based on changes in run states.
-### method `RunStateFilter.__init__`
+
+## Args
+
+- **run_filter**:
+- **run_state_filter**:
+
+
+
+
+
+
+## Methods
+
+### method construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+
+
+##### Arguments
+
+- **_fields_set**:
+- **values**:
+
+
+
+
+### method copy
+
+```python
+self, *,
+include: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+exclude: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+update: 'Dict[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+Returns a copy of the model.
+
+!!! warning "Deprecated"
+ This method is now deprecated; use `model_copy` instead.
+
+If you need `include` or `exclude`, use:
+
+```python {test="skip" lint="skip"}
+data = self.model_dump(include=include, exclude=exclude, round_trip=True)
+data = {**data, **(update or {})}
+copied = self.model_validate(data)
+```
+
+##### Arguments
+
+- **include**: Optional set or mapping specifying which fields to include in the copied model.
+- **exclude**: Optional set or mapping specifying which fields to exclude in the copied model.
+- **update**: Optional dictionary of field-value pairs to override field values in the copied model.
+- **deep**: If True, the values of fields that are Pydantic models will be deep-copied.
+
+
+
+
+### method dict
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+
+
+
+
+### method from_orm
```python
-__init__(
- run: 'And | Or | Nor | Not | Lt | Gt | Lte | Gte | Eq | Ne | In | NotIn | Exists | Regex | Contains | FilterExpr | dict[str, Any]' = And(()),
- state: 'StateFilter'
-) → None
+obj: 'Any'
```
-**Args:**
-
- - `run` (Union[And, Or, Nor, Not, Lt, Gt, Lte, Gte, Eq, Ne, In, NotIn, Exists, Regex, Contains, FilterExpr, Dict[str, Any]]): Filters that must match any runs that will trigger this event.
- - `state` (StateFilter): Run state condition(s) that must be satisfied for this event to trigger.
-**Returns:**
- An `RunStateFilter` object.
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method json
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False,
+encoder: 'Callable[[Any], Any] | None' = PydanticUndefined,
+models_as_dict: 'bool' = PydanticUndefined, **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+- **encoder**:
+- **models_as_dict**:
+- **dumps_kwargs**:
+
+
+
+
+### method model_construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+Creates a new instance of the `Model` class with validated data.
+
+Creates a new model setting `__dict__` and `__pydantic_fields_set__` from trusted or pre-validated data.
+Default values are respected, but no other validation is performed.
+
+!!! note
+ `model_construct()` generally respects the `model_config.extra` setting on the provided model.
+ That is, if `model_config.extra == 'allow'`, then all extra passed values are added to the model instance's `__dict__`
+ and `__pydantic_extra__` fields. If `model_config.extra == 'ignore'` (the default), then all extra passed values are ignored.
+ Because no validation is performed with a call to `model_construct()`, having `model_config.extra == 'forbid'` does not result in
+ an error if extra values are passed, but they will be ignored.
+
+##### Arguments
+
+- **_fields_set**: A set of field names that were originally explicitly set during instantiation. If provided, this is directly used for the [`model_fields_set`][pydantic.BaseModel.model_fields_set] attribute. Otherwise, the field names from the `values` argument will be used.
+- **values**: Trusted or pre-validated data dictionary.
+
+
+
+
+### method model_copy
+
+```python
+self, *,
+update: 'Mapping[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+!!! abstract "Usage Documentation"
+ [`model_copy`](../concepts/serialization.md#model_copy)
+
+Returns a copy of the model.
+
+!!! note
+ The underlying instance's [`__dict__`][object.__dict__] attribute is copied. This
+ might have unexpected side effects if you store anything in it, on top of the model
+ fields (e.g. the value of [cached properties][functools.cached_property]).
+
+##### Arguments
+
+- **update**: Values to change/add in the new model. Note: the data is not validated before creating the new model. You should trust this data.
+- **deep**: Set to `True` to make a deep copy of the model.
+
+
+
+
+### method model_dump
+
+```python
+self, *,
+mode: 'str' = 'json', **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump`](../concepts/serialization.md#modelmodel_dump)
+
+Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
+
+##### Arguments
+
+- **mode**: The mode in which `to_python` should run. If mode is 'json', the output will only contain JSON serializable types. If mode is 'python', the output may contain non-JSON-serializable Python objects.
+- **kwargs**:
+
+
+
+
+### method model_dump_json
+
+```python
+self, *,
+indent: 'int | None' = None, **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump_json`](../concepts/serialization.md#modelmodel_dump_json)
+
+Generates a JSON representation of the model using Pydantic's `to_json` method.
+
+##### Arguments
+
+- **indent**: Indentation to use in the JSON output. If None is passed, the output will be compact.
+- **kwargs**:
+
+
+
+
+### method model_json_schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}',
+schema_generator: 'type[GenerateJsonSchema]' = ,
+mode: 'JsonSchemaMode' = 'validation'
+```
+
+Generates a JSON schema for a model class.
+
+##### Arguments
+
+- **by_alias**: Whether to use attribute aliases or not.
+- **ref_template**: The reference template.
+- **schema_generator**: To override the logic used to generate the JSON schema, as a subclass of `GenerateJsonSchema` with your desired modifications
+- **mode**: The mode in which to generate the schema.
+
+
+
+
+### method model_parametrized_name
+
+```python
+params: 'tuple[type[Any], ...]'
+```
+
+Compute the class name for parametrizations of generic classes.
+
+This method can be overridden to achieve a custom naming scheme for generic BaseModels.
+
+##### Arguments
+
+- **params**: Tuple of types of the class. Given a generic class `Model` with 2 type variables and a concrete model `Model[str, int]`, the value `(str, int)` would be passed to `params`.
+
+
+##### Raises
+
+- **TypeError**: Raised when trying to generate concrete names for non-generic models.
+
+
+### method model_post_init
+
+```python
+self,
+context: 'Any', /
+```
+
+Override this method to perform additional initialization after `__init__` and `model_construct`.
+This is useful if you want to do some validation that requires the entire model to be initialized.
+
+##### Arguments
+
+- **context**:
+
+
+
+
+### method model_rebuild
+
+```python
+*,
+force: 'bool' = False,
+raise_errors: 'bool' = True,
+_parent_namespace_depth: 'int' = 2,
+_types_namespace: 'MappingNamespace | None' = None
+```
+
+Try to rebuild the pydantic-core schema for the model.
+
+This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
+the initial attempt to build the schema, and automatic rebuilding fails.
+
+##### Arguments
+
+- **force**: Whether to force the rebuilding of the model schema, defaults to `False`.
+- **raise_errors**: Whether to raise errors, defaults to `True`.
+- **_parent_namespace_depth**: The depth level of the parent namespace, defaults to 2.
+- **_types_namespace**: The types namespace, defaults to `None`.
+
+
+
+
+### method model_validate
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+from_attributes: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate a pydantic model instance.
+
+##### Arguments
+
+- **obj**: The object to validate.
+- **strict**: Whether to enforce types strictly.
+- **from_attributes**: Whether to extract data from object attributes.
+- **context**: Additional context to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If the object could not be validated.
+
+
+### method model_validate_json
+
+```python
+json_data: 'str | bytes | bytearray', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+!!! abstract "Usage Documentation"
+ [JSON Parsing](../concepts/json.md#json-parsing)
+
+Validate the given JSON data against the Pydantic model.
+
+##### Arguments
+
+- **json_data**: The JSON data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If `json_data` is not a JSON string or the object could not be validated.
+
+
+### method model_validate_strings
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate the given object with string data against the Pydantic model.
+
+##### Arguments
+
+- **obj**: The object containing string data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+
+
+### method parse_file
+
+```python
+path: 'str | Path', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **path**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method parse_obj
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method parse_raw
+
+```python
+b: 'str | bytes', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **b**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+
+
+
+
+### method schema_json
+
+```python
+*,
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}', **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+- **dumps_kwargs**:
+
+
+
+
+### method update_forward_refs
+
+```python
+**localns: 'Any'
+```
+
+
+
+##### Arguments
+
+- **localns**:
+
+
+
+
+### method validate
+
+```python
+value: 'Any'
+```
+
+
+
+##### Arguments
+
+- **value**:
+
+
+
+
+
+
diff --git a/models/ref/python/automations/sendnotification.mdx b/models/ref/python/automations/sendnotification.mdx
index 5613f57f5d..f7ab06df1c 100644
--- a/models/ref/python/automations/sendnotification.mdx
+++ b/models/ref/python/automations/sendnotification.mdx
@@ -1,50 +1,569 @@
---
title: SendNotification
-namespace: automations_namespace
-python_object_type: class
+kind: class
+namespace: wandb.automations.actions
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+```python
+*,
+integration_id: typing.Annotated[str, Strict(strict=True)],
+text: str = '',
+level: typing.Annotated[wandb.automations._generated.enums.AlertSeverity, BeforeValidator(func=, json_schema_input_type=PydanticUndefined)] = ,
+title: str = '',
+action_type: Literal[NOTIFICATION] = NOTIFICATION
+```
+
+## Description
-## class `SendNotification`
Defines an automation action that sends a (Slack) notification.
-### method `SendNotification.__init__`
+
+## Args
+
+- **integration_id**:
+- **text**:
+- **level**:
+- **title**:
+- **action_type**:
+
+
+
+
+
+
+## Methods
+
+### method construct
```python
-__init__(
- integration_id: 'str',
- message: 'str' = '',
- severity: 'AlertSeverity' = ,
- title: 'str' = '',
- action_type: 'Literal[NOTIFICATION]' = NOTIFICATION
-) → None
+_fields_set: 'set[str] | None' = None, **values: 'Any'
```
-**Args:**
-
- - `integration_id` (str): The ID of the Slack integration that will be used to send the notification.
- - `message` (str): The message body of the sent notification.
- - `severity` (AlertSeverity): The severity (`INFO`, `WARN`, `ERROR`) of the sent notification.
- - `title` (str): The title of the sent notification.
- - `action_type` (Literal[NOTIFICATION]):
-**Returns:**
- An `SendNotification` object.
-### classmethod `SendNotification.from_integration`
+##### Arguments
+
+- **_fields_set**:
+- **values**:
+
+
+
+
+### method copy
```python
-from_integration(
- integration: 'SlackIntegration',
- title: 'str' = '',
- text: 'str' = '',
- level: 'AlertSeverity' =
-) → Self
+self, *,
+include: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+exclude: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+update: 'Dict[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+Returns a copy of the model.
+
+!!! warning "Deprecated"
+ This method is now deprecated; use `model_copy` instead.
+
+If you need `include` or `exclude`, use:
+
+```python {test="skip" lint="skip"}
+data = self.model_dump(include=include, exclude=exclude, round_trip=True)
+data = {**data, **(update or {})}
+copied = self.model_validate(data)
+```
+
+##### Arguments
+
+- **include**: Optional set or mapping specifying which fields to include in the copied model.
+- **exclude**: Optional set or mapping specifying which fields to exclude in the copied model.
+- **update**: Optional dictionary of field-value pairs to override field values in the copied model.
+- **deep**: If True, the values of fields that are Pydantic models will be deep-copied.
+
+
+
+
+### method dict
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+
+
+
+
+### method from_integration
+
+```python
+integration: 'SlackIntegration', *,
+title: 'str' = '',
+text: 'str' = '',
+level: 'AlertSeverity' =
```
Define a notification action that sends to the given (Slack) integration.
+
+##### Arguments
+
+- **integration**:
+- **title**:
+- **text**:
+- **level**:
+
+
+
+
+### method from_orm
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method json
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False,
+encoder: 'Callable[[Any], Any] | None' = PydanticUndefined,
+models_as_dict: 'bool' = PydanticUndefined, **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+- **encoder**:
+- **models_as_dict**:
+- **dumps_kwargs**:
+
+
+
+
+### method model_construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+Creates a new instance of the `Model` class with validated data.
+
+Creates a new model setting `__dict__` and `__pydantic_fields_set__` from trusted or pre-validated data.
+Default values are respected, but no other validation is performed.
+
+!!! note
+ `model_construct()` generally respects the `model_config.extra` setting on the provided model.
+ That is, if `model_config.extra == 'allow'`, then all extra passed values are added to the model instance's `__dict__`
+ and `__pydantic_extra__` fields. If `model_config.extra == 'ignore'` (the default), then all extra passed values are ignored.
+ Because no validation is performed with a call to `model_construct()`, having `model_config.extra == 'forbid'` does not result in
+ an error if extra values are passed, but they will be ignored.
+
+##### Arguments
+
+- **_fields_set**: A set of field names that were originally explicitly set during instantiation. If provided, this is directly used for the [`model_fields_set`][pydantic.BaseModel.model_fields_set] attribute. Otherwise, the field names from the `values` argument will be used.
+- **values**: Trusted or pre-validated data dictionary.
+
+
+
+
+### method model_copy
+
+```python
+self, *,
+update: 'Mapping[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+!!! abstract "Usage Documentation"
+ [`model_copy`](../concepts/serialization.md#model_copy)
+
+Returns a copy of the model.
+
+!!! note
+ The underlying instance's [`__dict__`][object.__dict__] attribute is copied. This
+ might have unexpected side effects if you store anything in it, on top of the model
+ fields (e.g. the value of [cached properties][functools.cached_property]).
+
+##### Arguments
+
+- **update**: Values to change/add in the new model. Note: the data is not validated before creating the new model. You should trust this data.
+- **deep**: Set to `True` to make a deep copy of the model.
+
+
+
+
+### method model_dump
+
+```python
+self, *,
+mode: 'str' = 'json', **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump`](../concepts/serialization.md#modelmodel_dump)
+
+Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
+
+##### Arguments
+
+- **mode**: The mode in which `to_python` should run. If mode is 'json', the output will only contain JSON serializable types. If mode is 'python', the output may contain non-JSON-serializable Python objects.
+- **kwargs**:
+
+
+
+
+### method model_dump_json
+
+```python
+self, *,
+indent: 'int | None' = None, **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump_json`](../concepts/serialization.md#modelmodel_dump_json)
+
+Generates a JSON representation of the model using Pydantic's `to_json` method.
+
+##### Arguments
+
+- **indent**: Indentation to use in the JSON output. If None is passed, the output will be compact.
+- **kwargs**:
+
+
+
+
+### method model_json_schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}',
+schema_generator: 'type[GenerateJsonSchema]' = ,
+mode: 'JsonSchemaMode' = 'validation'
+```
+
+Generates a JSON schema for a model class.
+
+##### Arguments
+
+- **by_alias**: Whether to use attribute aliases or not.
+- **ref_template**: The reference template.
+- **schema_generator**: To override the logic used to generate the JSON schema, as a subclass of `GenerateJsonSchema` with your desired modifications
+- **mode**: The mode in which to generate the schema.
+
+
+
+
+### method model_parametrized_name
+
+```python
+params: 'tuple[type[Any], ...]'
+```
+
+Compute the class name for parametrizations of generic classes.
+
+This method can be overridden to achieve a custom naming scheme for generic BaseModels.
+
+##### Arguments
+
+- **params**: Tuple of types of the class. Given a generic class `Model` with 2 type variables and a concrete model `Model[str, int]`, the value `(str, int)` would be passed to `params`.
+
+
+##### Raises
+
+- **TypeError**: Raised when trying to generate concrete names for non-generic models.
+
+
+### method model_post_init
+
+```python
+self,
+context: 'Any', /
+```
+
+Override this method to perform additional initialization after `__init__` and `model_construct`.
+This is useful if you want to do some validation that requires the entire model to be initialized.
+
+##### Arguments
+
+- **context**:
+
+
+
+
+### method model_rebuild
+
+```python
+*,
+force: 'bool' = False,
+raise_errors: 'bool' = True,
+_parent_namespace_depth: 'int' = 2,
+_types_namespace: 'MappingNamespace | None' = None
+```
+
+Try to rebuild the pydantic-core schema for the model.
+
+This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
+the initial attempt to build the schema, and automatic rebuilding fails.
+
+##### Arguments
+
+- **force**: Whether to force the rebuilding of the model schema, defaults to `False`.
+- **raise_errors**: Whether to raise errors, defaults to `True`.
+- **_parent_namespace_depth**: The depth level of the parent namespace, defaults to 2.
+- **_types_namespace**: The types namespace, defaults to `None`.
+
+
+
+
+### method model_validate
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+from_attributes: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate a pydantic model instance.
+
+##### Arguments
+
+- **obj**: The object to validate.
+- **strict**: Whether to enforce types strictly.
+- **from_attributes**: Whether to extract data from object attributes.
+- **context**: Additional context to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If the object could not be validated.
+
+
+### method model_validate_json
+
+```python
+json_data: 'str | bytes | bytearray', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+!!! abstract "Usage Documentation"
+ [JSON Parsing](../concepts/json.md#json-parsing)
+
+Validate the given JSON data against the Pydantic model.
+
+##### Arguments
+
+- **json_data**: The JSON data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If `json_data` is not a JSON string or the object could not be validated.
+
+
+### method model_validate_strings
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate the given object with string data against the Pydantic model.
+
+##### Arguments
+
+- **obj**: The object containing string data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+
+
+### method parse_file
+
+```python
+path: 'str | Path', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **path**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method parse_obj
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method parse_raw
+
+```python
+b: 'str | bytes', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **b**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+
+
+
+
+### method schema_json
+
+```python
+*,
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}', **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+- **dumps_kwargs**:
+
+
+
+
+### method update_forward_refs
+
+```python
+**localns: 'Any'
+```
+
+
+
+##### Arguments
+
+- **localns**:
+
+
+
+
+### method validate
+
+```python
+value: 'Any'
+```
+
+
+
+##### Arguments
+
+- **value**:
+
+
+
+
+
+
diff --git a/models/ref/python/automations/sendwebhook.mdx b/models/ref/python/automations/sendwebhook.mdx
index 5adf2472e6..b03fa1dc75 100644
--- a/models/ref/python/automations/sendwebhook.mdx
+++ b/models/ref/python/automations/sendwebhook.mdx
@@ -1,44 +1,561 @@
---
title: SendWebhook
-namespace: automations_namespace
-python_object_type: class
+kind: class
+namespace: wandb.automations.actions
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+```python
+*,
+integration_id: typing.Annotated[str, Strict(strict=True)],
+requestPayload: Optional[Annotated[dict[str, Any], Json, BeforeValidator(func=, json_schema_input_type=PydanticUndefined), PlainSerializer(func=, return_type=PydanticUndefined, when_used='always')]] = None,
+action_type: Literal[GENERIC_WEBHOOK] = GENERIC_WEBHOOK
+```
+
+## Description
-## class `SendWebhook`
Defines an automation action that sends a webhook request.
-### method `SendWebhook.__init__`
+
+## Args
+
+- **integration_id**:
+- **requestPayload**:
+- **action_type**:
+
+
+
+
+
+
+## Methods
+
+### method construct
```python
-__init__(
- integration_id: 'str',
- request_payload: 'Annotated | None' = None,
- action_type: 'Literal[GENERIC_WEBHOOK]' = GENERIC_WEBHOOK
-) → None
+_fields_set: 'set[str] | None' = None, **values: 'Any'
```
-**Args:**
-
- - `integration_id` (str): The ID of the webhook integration that will be used to send the request.
- - `request_payload` (Optional[Annotated]): The payload, possibly with template variables, to send in the webhook request.
- - `action_type` (Literal[GENERIC_WEBHOOK]):
-**Returns:**
- An `SendWebhook` object.
-### classmethod `SendWebhook.from_integration`
+##### Arguments
+
+- **_fields_set**:
+- **values**:
+
+
+
+
+### method copy
```python
-from_integration(
- integration: 'WebhookIntegration',
- payload: 'Optional[JsonEncoded[dict[str, Any]]]' = None
-) → Self
+self, *,
+include: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+exclude: 'AbstractSetIntStr | MappingIntStrAny | None' = None,
+update: 'Dict[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+Returns a copy of the model.
+
+!!! warning "Deprecated"
+ This method is now deprecated; use `model_copy` instead.
+
+If you need `include` or `exclude`, use:
+
+```python {test="skip" lint="skip"}
+data = self.model_dump(include=include, exclude=exclude, round_trip=True)
+data = {**data, **(update or {})}
+copied = self.model_validate(data)
+```
+
+##### Arguments
+
+- **include**: Optional set or mapping specifying which fields to include in the copied model.
+- **exclude**: Optional set or mapping specifying which fields to exclude in the copied model.
+- **update**: Optional dictionary of field-value pairs to override field values in the copied model.
+- **deep**: If True, the values of fields that are Pydantic models will be deep-copied.
+
+
+
+
+### method dict
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+
+
+
+
+### method from_integration
+
+```python
+integration: 'WebhookIntegration', *,
+payload: 'JsonEncoded[dict[str, Any]] | None' = None
```
Define a webhook action that sends to the given (webhook) integration.
+
+##### Arguments
+
+- **integration**:
+- **payload**:
+
+
+
+
+### method from_orm
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method json
+
+```python
+self, *,
+include: 'IncEx | None' = None,
+exclude: 'IncEx | None' = None,
+by_alias: 'bool' = False,
+exclude_unset: 'bool' = False,
+exclude_defaults: 'bool' = False,
+exclude_none: 'bool' = False,
+encoder: 'Callable[[Any], Any] | None' = PydanticUndefined,
+models_as_dict: 'bool' = PydanticUndefined, **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **include**:
+- **exclude**:
+- **by_alias**:
+- **exclude_unset**:
+- **exclude_defaults**:
+- **exclude_none**:
+- **encoder**:
+- **models_as_dict**:
+- **dumps_kwargs**:
+
+
+
+
+### method model_construct
+
+```python
+_fields_set: 'set[str] | None' = None, **values: 'Any'
+```
+
+Creates a new instance of the `Model` class with validated data.
+
+Creates a new model setting `__dict__` and `__pydantic_fields_set__` from trusted or pre-validated data.
+Default values are respected, but no other validation is performed.
+
+!!! note
+ `model_construct()` generally respects the `model_config.extra` setting on the provided model.
+ That is, if `model_config.extra == 'allow'`, then all extra passed values are added to the model instance's `__dict__`
+ and `__pydantic_extra__` fields. If `model_config.extra == 'ignore'` (the default), then all extra passed values are ignored.
+ Because no validation is performed with a call to `model_construct()`, having `model_config.extra == 'forbid'` does not result in
+ an error if extra values are passed, but they will be ignored.
+
+##### Arguments
+
+- **_fields_set**: A set of field names that were originally explicitly set during instantiation. If provided, this is directly used for the [`model_fields_set`][pydantic.BaseModel.model_fields_set] attribute. Otherwise, the field names from the `values` argument will be used.
+- **values**: Trusted or pre-validated data dictionary.
+
+
+
+
+### method model_copy
+
+```python
+self, *,
+update: 'Mapping[str, Any] | None' = None,
+deep: 'bool' = False
+```
+
+!!! abstract "Usage Documentation"
+ [`model_copy`](../concepts/serialization.md#model_copy)
+
+Returns a copy of the model.
+
+!!! note
+ The underlying instance's [`__dict__`][object.__dict__] attribute is copied. This
+ might have unexpected side effects if you store anything in it, on top of the model
+ fields (e.g. the value of [cached properties][functools.cached_property]).
+
+##### Arguments
+
+- **update**: Values to change/add in the new model. Note: the data is not validated before creating the new model. You should trust this data.
+- **deep**: Set to `True` to make a deep copy of the model.
+
+
+
+
+### method model_dump
+
+```python
+self, *,
+mode: 'str' = 'json', **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump`](../concepts/serialization.md#modelmodel_dump)
+
+Generate a dictionary representation of the model, optionally specifying which fields to include or exclude.
+
+##### Arguments
+
+- **mode**: The mode in which `to_python` should run. If mode is 'json', the output will only contain JSON serializable types. If mode is 'python', the output may contain non-JSON-serializable Python objects.
+- **kwargs**:
+
+
+
+
+### method model_dump_json
+
+```python
+self, *,
+indent: 'int | None' = None, **kwargs: 'Any'
+```
+
+!!! abstract "Usage Documentation"
+ [`model_dump_json`](../concepts/serialization.md#modelmodel_dump_json)
+
+Generates a JSON representation of the model using Pydantic's `to_json` method.
+
+##### Arguments
+
+- **indent**: Indentation to use in the JSON output. If None is passed, the output will be compact.
+- **kwargs**:
+
+
+
+
+### method model_json_schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}',
+schema_generator: 'type[GenerateJsonSchema]' = ,
+mode: 'JsonSchemaMode' = 'validation'
+```
+
+Generates a JSON schema for a model class.
+
+##### Arguments
+
+- **by_alias**: Whether to use attribute aliases or not.
+- **ref_template**: The reference template.
+- **schema_generator**: To override the logic used to generate the JSON schema, as a subclass of `GenerateJsonSchema` with your desired modifications
+- **mode**: The mode in which to generate the schema.
+
+
+
+
+### method model_parametrized_name
+
+```python
+params: 'tuple[type[Any], ...]'
+```
+
+Compute the class name for parametrizations of generic classes.
+
+This method can be overridden to achieve a custom naming scheme for generic BaseModels.
+
+##### Arguments
+
+- **params**: Tuple of types of the class. Given a generic class `Model` with 2 type variables and a concrete model `Model[str, int]`, the value `(str, int)` would be passed to `params`.
+
+
+##### Raises
+
+- **TypeError**: Raised when trying to generate concrete names for non-generic models.
+
+
+### method model_post_init
+
+```python
+self,
+context: 'Any', /
+```
+
+Override this method to perform additional initialization after `__init__` and `model_construct`.
+This is useful if you want to do some validation that requires the entire model to be initialized.
+
+##### Arguments
+
+- **context**:
+
+
+
+
+### method model_rebuild
+
+```python
+*,
+force: 'bool' = False,
+raise_errors: 'bool' = True,
+_parent_namespace_depth: 'int' = 2,
+_types_namespace: 'MappingNamespace | None' = None
+```
+
+Try to rebuild the pydantic-core schema for the model.
+
+This may be necessary when one of the annotations is a ForwardRef which could not be resolved during
+the initial attempt to build the schema, and automatic rebuilding fails.
+
+##### Arguments
+
+- **force**: Whether to force the rebuilding of the model schema, defaults to `False`.
+- **raise_errors**: Whether to raise errors, defaults to `True`.
+- **_parent_namespace_depth**: The depth level of the parent namespace, defaults to 2.
+- **_types_namespace**: The types namespace, defaults to `None`.
+
+
+
+
+### method model_validate
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+from_attributes: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate a pydantic model instance.
+
+##### Arguments
+
+- **obj**: The object to validate.
+- **strict**: Whether to enforce types strictly.
+- **from_attributes**: Whether to extract data from object attributes.
+- **context**: Additional context to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If the object could not be validated.
+
+
+### method model_validate_json
+
+```python
+json_data: 'str | bytes | bytearray', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+!!! abstract "Usage Documentation"
+ [JSON Parsing](../concepts/json.md#json-parsing)
+
+Validate the given JSON data against the Pydantic model.
+
+##### Arguments
+
+- **json_data**: The JSON data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+##### Raises
+
+- **ValidationError**: If `json_data` is not a JSON string or the object could not be validated.
+
+
+### method model_validate_strings
+
+```python
+obj: 'Any', *,
+strict: 'bool | None' = None,
+context: 'Any | None' = None,
+by_alias: 'bool | None' = None,
+by_name: 'bool | None' = None
+```
+
+Validate the given object with string data against the Pydantic model.
+
+##### Arguments
+
+- **obj**: The object containing string data to validate.
+- **strict**: Whether to enforce types strictly.
+- **context**: Extra variables to pass to the validator.
+- **by_alias**: Whether to use the field's alias when validating against the provided input data.
+- **by_name**: Whether to use the field's name when validating against the provided input data.
+
+
+
+
+### method parse_file
+
+```python
+path: 'str | Path', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **path**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method parse_obj
+
+```python
+obj: 'Any'
+```
+
+
+
+##### Arguments
+
+- **obj**:
+
+
+
+
+### method parse_raw
+
+```python
+b: 'str | bytes', *,
+content_type: 'str | None' = None,
+encoding: 'str' = 'utf8',
+proto: 'DeprecatedParseProtocol | None' = None,
+allow_pickle: 'bool' = False
+```
+
+
+
+##### Arguments
+
+- **b**:
+- **content_type**:
+- **encoding**:
+- **proto**:
+- **allow_pickle**:
+
+
+
+
+### method schema
+
+```python
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+
+
+
+
+### method schema_json
+
+```python
+*,
+by_alias: 'bool' = True,
+ref_template: 'str' = '#/$defs/{model}', **dumps_kwargs: 'Any'
+```
+
+
+
+##### Arguments
+
+- **by_alias**:
+- **ref_template**:
+- **dumps_kwargs**:
+
+
+
+
+### method update_forward_refs
+
+```python
+**localns: 'Any'
+```
+
+
+
+##### Arguments
+
+- **localns**:
+
+
+
+
+### method validate
+
+```python
+value: 'Any'
+```
+
+
+
+##### Arguments
+
+- **value**:
+
+
+
+
+
+
diff --git a/models/ref/python/custom-charts/bar.mdx b/models/ref/python/custom-charts/bar.mdx
index 43ce28b9ad..55bb4d786c 100644
--- a/models/ref/python/custom-charts/bar.mdx
+++ b/models/ref/python/custom-charts/bar.mdx
@@ -1,49 +1,47 @@
---
-title: bar()
-namespace: python_sdk_custom_charts
-python_object_type: function
+title: bar
+kind: function
+namespace: wandb.plot.bar
---
-import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
+
-### function `bar`
```python
-bar(
- table: 'wandb.Table',
- label: 'str',
- value: 'str',
- title: 'str' = '',
- split_table: 'bool' = False
-) → CustomChart
+table: 'wandb.Table',
+label: 'str',
+value: 'str',
+title: 'str' = '',
+split_table: 'bool' = False
```
-Constructs a bar chart from a wandb.Table of data.
+## Description
+
+Constructs a bar chart from a wandb.Table of data.
+
+## Args
-**Args:**
-
- - `table`: A table containing the data for the bar chart.
- - `label`: The name of the column to use for the labels of each bar.
- - `value`: The name of the column to use for the values of each bar.
- - `title`: The title of the bar chart.
- - `split_table`: Whether the table should be split into a separate section in the W&B UI. If `True`, the table will be displayed in a section named "Custom Chart Tables". Default is `False`.
+- **table**: A table containing the data for the bar chart.
+- **label**: The name of the column to use for the labels of each bar.
+- **value**: The name of the column to use for the values of each bar.
+- **title**: The title of the bar chart.
+- **split_table**: Whether the table should be split into a separate section in the W&B UI. If `True`, the table will be displayed in a section named "Custom Chart Tables". Default is `False`.
+## Returns
-**Returns:**
-
- - `CustomChart`: A custom chart object that can be logged to W&B. To log the chart, pass it to `wandb.log()`.
+- **CustomChart**: A custom chart object that can be logged to W&B. To log the chart, pass it to `wandb.log()`.
-**Example:**
-
+
+## Examples
```python
import random
@@ -64,12 +62,13 @@ table = wandb.Table(data=data, columns=["class", "accuracy"])
with wandb.init(project="bar_chart") as run:
# Create a bar plot from the table
bar_plot = wandb.plot.bar(
- table=table,
- label="class",
- value="accuracy",
- title="Object Classification Accuracy",
+ table=table,
+ label="class",
+ value="accuracy",
+ title="Object Classification Accuracy",
)
# Log the bar chart to W&B
run.log({"bar_plot": bar_plot})
-```
+```
+
diff --git a/models/ref/python/custom-charts/confusion_matrix.mdx b/models/ref/python/custom-charts/confusion_matrix.mdx
index bfa5103c30..ff8e93e303 100644
--- a/models/ref/python/custom-charts/confusion_matrix.mdx
+++ b/models/ref/python/custom-charts/confusion_matrix.mdx
@@ -1,58 +1,56 @@
---
-title: confusion_matrix()
-namespace: python_sdk_custom_charts
-python_object_type: function
+title: confusion_matrix
+kind: function
+namespace: wandb.plot.confusion_matrix
---
-import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
+
-### function `confusion_matrix`
```python
-confusion_matrix(
- probs: 'Sequence[Sequence[float]] | None' = None,
- y_true: 'Sequence[T] | None' = None,
- preds: 'Sequence[T] | None' = None,
- class_names: 'Sequence[str] | None' = None,
- title: 'str' = 'Confusion Matrix Curve',
- split_table: 'bool' = False
-) → CustomChart
+probs: 'Sequence[Sequence[float]] | None' = None,
+y_true: 'Sequence[T] | None' = None,
+preds: 'Sequence[T] | None' = None,
+class_names: 'Sequence[str] | None' = None,
+title: 'str' = 'Confusion Matrix Curve',
+split_table: 'bool' = False
```
-Constructs a confusion matrix from a sequence of probabilities or predictions.
+## Description
+
+Constructs a confusion matrix from a sequence of probabilities or predictions.
+
+## Args
-**Args:**
-
- - `probs`: A sequence of predicted probabilities for each class. The sequence shape should be (N, K) where N is the number of samples and K is the number of classes. If provided, `preds` should not be provided.
- - `y_true`: A sequence of true labels.
- - `preds`: A sequence of predicted class labels. If provided, `probs` should not be provided.
- - `class_names`: Sequence of class names. If not provided, class names will be defined as "Class_1", "Class_2", etc.
- - `title`: Title of the confusion matrix chart.
- - `split_table`: Whether the table should be split into a separate section in the W&B UI. If `True`, the table will be displayed in a section named "Custom Chart Tables". Default is `False`.
+- **probs**: A sequence of predicted probabilities for each class. The sequence shape should be (N, K) where N is the number of samples and K is the number of classes. If provided, `preds` should not be provided.
+- **y_true**: A sequence of true labels.
+- **preds**: A sequence of predicted class labels. If provided, `probs` should not be provided.
+- **class_names**: Sequence of class names. If not provided, class names will be defined as "Class_1", "Class_2", etc.
+- **title**: Title of the confusion matrix chart.
+- **split_table**: Whether the table should be split into a separate section in the W&B UI. If `True`, the table will be displayed in a section named "Custom Chart Tables". Default is `False`.
+## Returns
-**Returns:**
-
- - `CustomChart`: A custom chart object that can be logged to W&B. To log the chart, pass it to `wandb.log()`.
+- **CustomChart**: A custom chart object that can be logged to W&B. To log the chart, pass it to `wandb.log()`.
+## Raises
-**Raises:**
-
- - `ValueError`: If both `probs` and `preds` are provided or if the number of predictions and true labels are not equal. If the number of unique predicted classes exceeds the number of class names or if the number of unique true labels exceeds the number of class names.
- - `wandb.Error`: If numpy is not installed.
+- **ValueError**: If both `probs` and `preds` are provided or if the number of predictions and true labels are not equal. If the number of unique predicted classes exceeds the number of class names or if the number of unique true labels exceeds the number of class names.
+- **wandb.Error**: If numpy is not installed.
+## Examples
-**Examples:**
- Logging a confusion matrix with random probabilities for wildlife classification:
+Logging a confusion matrix with random probabilities for wildlife
+classification:
```python
import numpy as np
@@ -75,17 +73,19 @@ wildlife_probs = np.exp(wildlife_probs) / np.sum(
# Initialize W&B run and log confusion matrix
with wandb.init(project="wildlife_classification") as run:
confusion_matrix = wandb.plot.confusion_matrix(
- probs=wildlife_probs,
- y_true=wildlife_y_true,
- class_names=wildlife_class_names,
- title="Wildlife Classification Confusion Matrix",
+ probs=wildlife_probs,
+ y_true=wildlife_y_true,
+ class_names=wildlife_class_names,
+ title="Wildlife Classification Confusion Matrix",
)
run.log({"wildlife_confusion_matrix": confusion_matrix})
-```
+```
-In this example, random probabilities are used to generate a confusion matrix.
+In this example, random probabilities are used to generate a confusion
+matrix.
-Logging a confusion matrix with simulated model predictions and 85% accuracy:
+Logging a confusion matrix with simulated model predictions and 85%
+accuracy:
```python
import numpy as np
@@ -112,12 +112,14 @@ wildlife_preds = [
# Initialize W&B run and log confusion matrix
with wandb.init(project="wildlife_classification") as run:
confusion_matrix = wandb.plot.confusion_matrix(
- preds=wildlife_preds,
- y_true=wildlife_y_true,
- class_names=wildlife_class_names,
- title="Simulated Wildlife Classification Confusion Matrix",
+ preds=wildlife_preds,
+ y_true=wildlife_y_true,
+ class_names=wildlife_class_names,
+ title="Simulated Wildlife Classification Confusion Matrix",
)
run.log({"wildlife_confusion_matrix": confusion_matrix})
-```
+```
+
+In this example, predictions are simulated with 85% accuracy to generate a
+confusion matrix.
-In this example, predictions are simulated with 85% accuracy to generate a confusion matrix.
diff --git a/models/ref/python/custom-charts/histogram.mdx b/models/ref/python/custom-charts/histogram.mdx
index fca5a580f1..538893d577 100644
--- a/models/ref/python/custom-charts/histogram.mdx
+++ b/models/ref/python/custom-charts/histogram.mdx
@@ -1,47 +1,45 @@
---
title: histogram
-namespace: python_sdk_custom_charts
-python_object_type: function
+kind: function
+namespace: wandb.plot.histogram
---
-import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
+
-### function `histogram`
```python
-histogram(
- table: 'wandb.Table',
- value: 'str',
- title: 'str' = '',
- split_table: 'bool' = False
-) → CustomChart
+table: 'wandb.Table',
+value: 'str',
+title: 'str' = '',
+split_table: 'bool' = False
```
-Constructs a histogram chart from a W&B Table.
+## Description
+
+Constructs a histogram chart from a W&B Table.
+
+## Args
-**Args:**
-
- - `table`: The W&B Table containing the data for the histogram.
- - `value`: The label for the bin axis (x-axis).
- - `title`: The title of the histogram plot.
- - `split_table`: Whether the table should be split into a separate section in the W&B UI. If `True`, the table will be displayed in a section named "Custom Chart Tables". Default is `False`.
+- **table**: The W&B Table containing the data for the histogram.
+- **value**: The label for the bin axis (x-axis).
+- **title**: The title of the histogram plot.
+- **split_table**: Whether the table should be split into a separate section in the W&B UI. If `True`, the table will be displayed in a section named "Custom Chart Tables". Default is `False`.
+## Returns
-**Returns:**
-
- - `CustomChart`: A custom chart object that can be logged to W&B. To log the chart, pass it to `wandb.log()`.
+- **CustomChart**: A custom chart object that can be logged to W&B. To log the chart, pass it to `wandb.log()`.
-**Example:**
-
+
+## Examples
```python
import math
@@ -67,4 +65,5 @@ histogram = wandb.plot.histogram(
# Log the histogram plot to W&B
with wandb.init(...) as run:
run.log({"histogram-plot1": histogram})
-```
+```
+
diff --git a/models/ref/python/custom-charts/line.mdx b/models/ref/python/custom-charts/line.mdx
index 1338fa49e3..6942e772e6 100644
--- a/models/ref/python/custom-charts/line.mdx
+++ b/models/ref/python/custom-charts/line.mdx
@@ -1,51 +1,49 @@
---
-title: line()
-namespace: python_sdk_custom_charts
-python_object_type: function
+title: line
+kind: function
+namespace: wandb.plot.line
---
-import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
+
-### function `line`
```python
-line(
- table: 'wandb.Table',
- x: 'str',
- y: 'str',
- stroke: 'str | None' = None,
- title: 'str' = '',
- split_table: 'bool' = False
-) → CustomChart
+table: 'wandb.Table',
+x: 'str',
+y: 'str',
+stroke: 'str | None' = None,
+title: 'str' = '',
+split_table: 'bool' = False
```
-Constructs a customizable line chart.
+## Description
+
+Constructs a customizable line chart.
+
+## Args
-**Args:**
-
- - `table`: The table containing data for the chart.
- - `x`: Column name for the x-axis values.
- - `y`: Column name for the y-axis values.
- - `stroke`: Column name to differentiate line strokes (e.g., for grouping lines).
- - `title`: Title of the chart.
- - `split_table`: Whether the table should be split into a separate section in the W&B UI. If `True`, the table will be displayed in a section named "Custom Chart Tables". Default is `False`.
+- **table**: The table containing data for the chart.
+- **x**: Column name for the x-axis values.
+- **y**: Column name for the y-axis values.
+- **stroke**: Column name to differentiate line strokes (e.g., for grouping lines).
+- **title**: Title of the chart.
+- **split_table**: Whether the table should be split into a separate section in the W&B UI. If `True`, the table will be displayed in a section named "Custom Chart Tables". Default is `False`.
+## Returns
-**Returns:**
-
- - `CustomChart`: A custom chart object that can be logged to W&B. To log the chart, pass it to `wandb.log()`.
+- **CustomChart**: A custom chart object that can be logged to W&B. To log the chart, pass it to `wandb.log()`.
-**Example:**
-
+
+## Examples
```python
import math
@@ -55,24 +53,25 @@ import wandb
# Create multiple series of data with different patterns
data = []
for i in range(100):
- # Series 1: Sinusoidal pattern with random noise
- data.append([i, math.sin(i / 10) + random.uniform(-0.1, 0.1), "series_1"])
- # Series 2: Cosine pattern with random noise
- data.append([i, math.cos(i / 10) + random.uniform(-0.1, 0.1), "series_2"])
- # Series 3: Linear increase with random noise
- data.append([i, i / 10 + random.uniform(-0.5, 0.5), "series_3"])
+ # Series 1: Sinusoidal pattern with random noise
+ data.append([i, math.sin(i / 10) + random.uniform(-0.1, 0.1), "series_1"])
+ # Series 2: Cosine pattern with random noise
+ data.append([i, math.cos(i / 10) + random.uniform(-0.1, 0.1), "series_2"])
+ # Series 3: Linear increase with random noise
+ data.append([i, i / 10 + random.uniform(-0.5, 0.5), "series_3"])
# Define the columns for the table
table = wandb.Table(data=data, columns=["step", "value", "series"])
# Initialize wandb run and log the line chart
with wandb.init(project="line_chart_example") as run:
- line_chart = wandb.plot.line(
- table=table,
- x="step",
- y="value",
- stroke="series", # Group by the "series" column
- title="Multi-Series Line Plot",
- )
- run.log({"line-chart": line_chart})
-```
+ line_chart = wandb.plot.line(
+ table=table,
+ x="step",
+ y="value",
+ stroke="series", # Group by the "series" column
+ title="Multi-Series Line Plot",
+ )
+ run.log({"line-chart": line_chart})
+```
+
diff --git a/models/ref/python/custom-charts/line_series.mdx b/models/ref/python/custom-charts/line_series.mdx
index 68220fd9e1..75aeef300c 100644
--- a/models/ref/python/custom-charts/line_series.mdx
+++ b/models/ref/python/custom-charts/line_series.mdx
@@ -1,51 +1,51 @@
---
-title: line_series()
-namespace: python_sdk_custom_charts
-python_object_type: function
+title: line_series
+kind: function
+namespace: wandb.plot.line_series
---
-import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
+
-### function `line_series`
```python
-line_series(
- xs: 'Iterable[Iterable[Any]] | Iterable[Any]',
- ys: 'Iterable[Iterable[Any]]',
- keys: 'Iterable[str] | None' = None,
- title: 'str' = '',
- xname: 'str' = 'x',
- split_table: 'bool' = False
-) → CustomChart
+xs: 'Iterable[Iterable[Any]] | Iterable[Any]',
+ys: 'Iterable[Iterable[Any]]',
+keys: 'Iterable[str] | None' = None,
+title: 'str' = '',
+xname: 'str' = 'x',
+split_table: 'bool' = False
```
-Constructs a line series chart.
+## Description
+
+Constructs a line series chart.
+
+
+## Args
+- **xs**: Sequence of x values. If a singular array is provided, all y values are plotted against that x array. If an array of arrays is provided, each y value is plotted against the corresponding x array.
+- **ys**: Sequence of y values, where each iterable represents a separate line series.
+- **keys**: Sequence of keys for labeling each line series. If not provided, keys will be automatically generated as "line_1", "line_2", etc.
+- **title**: Title of the chart.
+- **xname**: Label for the x-axis.
+- **split_table**: Whether the table should be split into a separate section in the W&B UI. If `True`, the table will be displayed in a section named "Custom Chart Tables". Default is `False`.
-**Args:**
-
- - `xs`: Sequence of x values. If a singular array is provided, all y values are plotted against that x array. If an array of arrays is provided, each y value is plotted against the corresponding x array.
- - `ys`: Sequence of y values, where each iterable represents a separate line series.
- - `keys`: Sequence of keys for labeling each line series. If not provided, keys will be automatically generated as "line_1", "line_2", etc.
- - `title`: Title of the chart.
- - `xname`: Label for the x-axis.
- - `split_table`: Whether the table should be split into a separate section in the W&B UI. If `True`, the table will be displayed in a section named "Custom Chart Tables". Default is `False`.
+## Returns
+- **CustomChart**: A custom chart object that can be logged to W&B. To log the chart, pass it to `wandb.log()`.
-**Returns:**
-
- - `CustomChart`: A custom chart object that can be logged to W&B. To log the chart, pass it to `wandb.log()`.
-**Examples:**
- Logging a single x array where all y series are plotted against the same x values:
+## Examples
+
+Logging a single x array where all y series are plotted against the same x values:
```python
import wandb
@@ -57,24 +57,26 @@ with wandb.init(project="line_series_example") as run:
# Multiple y series to plot
ys = [
- [i for i in range(10)], # y = x
- [i**2 for i in range(10)], # y = x^2
- [i**3 for i in range(10)], # y = x^3
+ [i for i in range(10)], # y = x
+ [i**2 for i in range(10)], # y = x^2
+ [i**3 for i in range(10)], # y = x^3
]
# Generate and log the line series chart
line_series_chart = wandb.plot.line_series(
- xs,
- ys,
- title="title",
- xname="step",
+ xs,
+ ys,
+ title="title",
+ xname="step",
)
run.log({"line-series-single-x": line_series_chart})
-```
+```
-In this example, a single `xs` series (shared x-values) is used for all `ys` series. This results in each y-series being plotted against the same x-values (0-9).
+In this example, a single `xs` series (shared x-values) is used for all
+`ys` series. This results in each y-series being plotted against the
+same x-values (0-9).
-Logging multiple x arrays where each y series is plotted against its corresponding x array:
+Logging multiple x arrays where each y series is plotted against its corresponding x array:
```python
import wandb
@@ -83,28 +85,30 @@ import wandb
with wandb.init(project="line_series_example") as run:
# Separate x values for each y series
xs = [
- [i for i in range(10)], # x for first series
- [2 * i for i in range(10)], # x for second series (stretched)
- [3 * i for i in range(10)], # x for third series (stretched more)
+ [i for i in range(10)], # x for first series
+ [2 * i for i in range(10)], # x for second series (stretched)
+ [3 * i for i in range(10)], # x for third series (stretched more)
]
# Corresponding y series
ys = [
- [i for i in range(10)], # y = x
- [i**2 for i in range(10)], # y = x^2
- [i**3 for i in range(10)], # y = x^3
+ [i for i in range(10)], # y = x
+ [i**2 for i in range(10)], # y = x^2
+ [i**3 for i in range(10)], # y = x^3
]
# Generate and log the line series chart
line_series_chart = wandb.plot.line_series(
- xs, ys, title="Multiple X Arrays Example", xname="Step"
+ xs, ys, title="Multiple X Arrays Example", xname="Step"
)
run.log({"line-series-multiple-x": line_series_chart})
-```
+```
-In this example, each y series is plotted against its own unique x series. This allows for more flexibility when the x values are not uniform across the data series.
+In this example, each y series is plotted against its own unique x series.
+This allows for more flexibility when the x values are not uniform across
+the data series.
-Customizing line labels using `keys`:
+Customizing line labels using `keys`:
```python
import wandb
@@ -113,9 +117,9 @@ import wandb
with wandb.init(project="line_series_example") as run:
xs = list(range(10)) # Single x array
ys = [
- [i for i in range(10)], # y = x
- [i**2 for i in range(10)], # y = x^2
- [i**3 for i in range(10)], # y = x^3
+ [i for i in range(10)], # y = x
+ [i**2 for i in range(10)], # y = x^2
+ [i**3 for i in range(10)], # y = x^3
]
# Custom labels for each line
@@ -123,13 +127,16 @@ with wandb.init(project="line_series_example") as run:
# Generate and log the line series chart
line_series_chart = wandb.plot.line_series(
- xs,
- ys,
- keys=keys, # Custom keys (line labels)
- title="Custom Line Labels Example",
- xname="Step",
+ xs,
+ ys,
+ keys=keys, # Custom keys (line labels)
+ title="Custom Line Labels Example",
+ xname="Step",
)
run.log({"line-series-custom-keys": line_series_chart})
-```
+```
+
+This example shows how to provide custom labels for the lines using
+the `keys` argument. The keys will appear in the legend as "Linear",
+"Quadratic", and "Cubic".
-This example shows how to provide custom labels for the lines using the `keys` argument. The keys will appear in the legend as "Linear", "Quadratic", and "Cubic".
diff --git a/models/ref/python/custom-charts/plot_table.mdx b/models/ref/python/custom-charts/plot_table.mdx
index 41dd583194..8b6e39eaa2 100644
--- a/models/ref/python/custom-charts/plot_table.mdx
+++ b/models/ref/python/custom-charts/plot_table.mdx
@@ -1,57 +1,57 @@
---
-title: plot_table()
-namespace: python_sdk_custom_charts
-python_object_type: function
+title: plot_table
+kind: function
+namespace: wandb.plot.custom_chart
---
-import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
+
-### function `plot_table`
```python
-plot_table(
- vega_spec_name: 'str',
- data_table: 'wandb.Table',
- fields: 'dict[str, Any]',
- string_fields: 'dict[str, Any] | None' = None,
- split_table: 'bool' = False
-) → CustomChart
+vega_spec_name: 'str',
+data_table: 'wandb.Table',
+fields: 'dict[str, Any]',
+string_fields: 'dict[str, Any] | None' = None,
+split_table: 'bool' = False
```
-Creates a custom charts using a Vega-Lite specification and a `wandb.Table`.
+## Description
+
+Creates a custom charts using a Vega-Lite specification and a `wandb.Table`.
+
+This function creates a custom chart based on a Vega-Lite specification and
+a data table represented by a `wandb.Table` object. The specification needs
+to be predefined and stored in the W&B backend. The function returns a custom
+chart object that can be logged to W&B using `wandb.Run.log()`.
-This function creates a custom chart based on a Vega-Lite specification and a data table represented by a `wandb.Table` object. The specification needs to be predefined and stored in the W&B backend. The function returns a custom chart object that can be logged to W&B using `wandb.Run.log()`.
+## Args
-**Args:**
-
- - `vega_spec_name`: The name or identifier of the Vega-Lite spec that defines the visualization structure.
- - `data_table`: A `wandb.Table` object containing the data to be visualized.
- - `fields`: A mapping between the fields in the Vega-Lite spec and the corresponding columns in the data table to be visualized.
- - `string_fields`: A dictionary for providing values for any string constants required by the custom visualization.
- - `split_table`: Whether the table should be split into a separate section in the W&B UI. If `True`, the table will be displayed in a section named "Custom Chart Tables". Default is `False`.
+- **vega_spec_name**: The name or identifier of the Vega-Lite spec that defines the visualization structure.
+- **data_table**: A `wandb.Table` object containing the data to be visualized.
+- **fields**: A mapping between the fields in the Vega-Lite spec and the corresponding columns in the data table to be visualized.
+- **string_fields**: A dictionary for providing values for any string constants required by the custom visualization.
+- **split_table**: Whether the table should be split into a separate section in the W&B UI. If `True`, the table will be displayed in a section named "Custom Chart Tables". Default is `False`.
+## Returns
-**Returns:**
-
- - `CustomChart`: A custom chart object that can be logged to W&B. To log the chart, pass the chart object as argument to `wandb.Run.log()`.
+- **CustomChart**: A custom chart object that can be logged to W&B. To log the chart, pass the chart object as argument to `wandb.Run.log()`.
+## Raises
-**Raises:**
-
- - `wandb.Error`: If `data_table` is not a `wandb.Table` object.
+- **wandb.Error**: If `data_table` is not a `wandb.Table` object.
+## Examples
-**Example:**
- ```python
+```python
# Create a custom chart using a Vega-Lite spec and the data table.
import wandb
@@ -64,11 +64,12 @@ with wandb.init() as run:
# Create a custom title with `string_fields`.
my_custom_chart = wandb.plot_table(
- vega_spec_name="wandb/line/v0",
- data_table=table,
- fields=fields,
- string_fields={"title": "Title"},
+ vega_spec_name="wandb/line/v0",
+ data_table=table,
+ fields=fields,
+ string_fields={"title": "Title"},
)
run.log({"custom_chart": my_custom_chart})
-```
+```
+
diff --git a/models/ref/python/custom-charts/pr_curve.mdx b/models/ref/python/custom-charts/pr_curve.mdx
index 1b1b209df8..8e05f05ad8 100644
--- a/models/ref/python/custom-charts/pr_curve.mdx
+++ b/models/ref/python/custom-charts/pr_curve.mdx
@@ -1,63 +1,61 @@
---
-title: pr_curve()
-namespace: python_sdk_custom_charts
-python_object_type: function
+title: pr_curve
+kind: function
+namespace: wandb.plot.pr_curve
---
-import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
+
-### function `pr_curve`
```python
-pr_curve(
- y_true: 'Iterable[T] | None' = None,
- y_probas: 'Iterable[numbers.Number] | None' = None,
- labels: 'list[str] | None' = None,
- classes_to_plot: 'list[T] | None' = None,
- interp_size: 'int' = 21,
- title: 'str' = 'Precision-Recall Curve',
- split_table: 'bool' = False
-) → CustomChart
+y_true: 'Iterable[T] | None' = None,
+y_probas: 'Iterable[numbers.Number] | None' = None,
+labels: 'list[str] | None' = None,
+classes_to_plot: 'list[T] | None' = None,
+interp_size: 'int' = 21,
+title: 'str' = 'Precision-Recall Curve',
+split_table: 'bool' = False
```
-Constructs a Precision-Recall (PR) curve.
-
-The Precision-Recall curve is particularly useful for evaluating classifiers on imbalanced datasets. A high area under the PR curve signifies both high precision (a low false positive rate) and high recall (a low false negative rate). The curve provides insights into the balance between false positives and false negatives at various threshold levels, aiding in the assessment of a model's performance.
+## Description
+Constructs a Precision-Recall (PR) curve.
+The Precision-Recall curve is particularly useful for evaluating classifiers
+on imbalanced datasets. A high area under the PR curve signifies both high
+precision (a low false positive rate) and high recall (a low false negative
+rate). The curve provides insights into the balance between false positives
+and false negatives at various threshold levels, aiding in the assessment of
+a model's performance.
-**Args:**
-
- - `y_true`: True binary labels. The shape should be (`num_samples`,).
- - `y_probas`: Predicted scores or probabilities for each class. These can be probability estimates, confidence scores, or non-thresholded decision values. The shape should be (`num_samples`, `num_classes`).
- - `labels`: Optional list of class names to replace numeric values in `y_true` for easier plot interpretation. For example, `labels = ['dog', 'cat', 'owl']` will replace 0 with 'dog', 1 with 'cat', and 2 with 'owl' in the plot. If not provided, numeric values from `y_true` will be used.
- - `classes_to_plot`: Optional list of unique class values from y_true to be included in the plot. If not specified, all unique classes in y_true will be plotted.
- - `interp_size`: Number of points to interpolate recall values. The recall values will be fixed to `interp_size` uniformly distributed points in the range [0, 1], and the precision will be interpolated accordingly.
- - `title`: Title of the plot. Defaults to "Precision-Recall Curve".
- - `split_table`: Whether the table should be split into a separate section in the W&B UI. If `True`, the table will be displayed in a section named "Custom Chart Tables". Default is `False`.
+## Args
-**Returns:**
-
- - `CustomChart`: A custom chart object that can be logged to W&B. To log the chart, pass it to `wandb.log()`.
+- **y_true**: True binary labels. The shape should be (`num_samples`,).
+- **y_probas**: Predicted scores or probabilities for each class. These can be probability estimates, confidence scores, or non-thresholded decision values. The shape should be (`num_samples`, `num_classes`).
+- **labels**: Optional list of class names to replace numeric values in `y_true` for easier plot interpretation. For example, `labels = ['dog', 'cat', 'owl']` will replace 0 with 'dog', 1 with 'cat', and 2 with 'owl' in the plot. If not provided, numeric values from `y_true` will be used.
+- **classes_to_plot**: Optional list of unique class values from y_true to be included in the plot. If not specified, all unique classes in y_true will be plotted.
+- **interp_size**: Number of points to interpolate recall values. The recall values will be fixed to `interp_size` uniformly distributed points in the range [0, 1], and the precision will be interpolated accordingly.
+- **title**: Title of the plot. Defaults to "Precision-Recall Curve".
+- **split_table**: Whether the table should be split into a separate section in the W&B UI. If `True`, the table will be displayed in a section named "Custom Chart Tables". Default is `False`.
+## Returns
-**Raises:**
-
- - `wandb.Error`: If NumPy, pandas, or scikit-learn is not installed.
+- **CustomChart**: A custom chart object that can be logged to W&B. To log the chart, pass it to `wandb.log()`.
+## Raises
+- **wandb.Error**: If NumPy, pandas, or scikit-learn is not installed.
-**Example:**
-
+## Examples
```python
import wandb
@@ -76,10 +74,11 @@ labels = ["not spam", "spam"] # Optional class names for readability
with wandb.init(project="spam-detection") as run:
pr_curve = wandb.plot.pr_curve(
- y_true=y_true,
- y_probas=y_probas,
- labels=labels,
- title="Precision-Recall Curve for Spam Detection",
+ y_true=y_true,
+ y_probas=y_probas,
+ labels=labels,
+ title="Precision-Recall Curve for Spam Detection",
)
run.log({"pr-curve": pr_curve})
-```
+```
+
diff --git a/models/ref/python/custom-charts/roc_curve.mdx b/models/ref/python/custom-charts/roc_curve.mdx
index 8f0d24c81c..0626f19f42 100644
--- a/models/ref/python/custom-charts/roc_curve.mdx
+++ b/models/ref/python/custom-charts/roc_curve.mdx
@@ -1,57 +1,54 @@
---
-title: roc_curve()
-namespace: python_sdk_custom_charts
-python_object_type: function
+title: roc_curve
+kind: function
+namespace: wandb.plot.roc_curve
---
-import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
+
-### function `roc_curve`
```python
-roc_curve(
- y_true: 'Sequence[numbers.Number]',
- y_probas: 'Sequence[Sequence[float]] | None' = None,
- labels: 'list[str] | None' = None,
- classes_to_plot: 'list[numbers.Number] | None' = None,
- title: 'str' = 'ROC Curve',
- split_table: 'bool' = False
-) → CustomChart
+y_true: 'Sequence[numbers.Number]',
+y_probas: 'Sequence[Sequence[float]] | None' = None,
+labels: 'list[str] | None' = None,
+classes_to_plot: 'list[numbers.Number] | None' = None,
+title: 'str' = 'ROC Curve',
+split_table: 'bool' = False
```
-Constructs Receiver Operating Characteristic (ROC) curve chart.
+## Description
+
+Constructs Receiver Operating Characteristic (ROC) curve chart.
+
+## Args
-**Args:**
-
- - `y_true`: The true class labels (ground truth) for the target variable. Shape should be (num_samples,).
- - `y_probas`: The predicted probabilities or decision scores for each class. Shape should be (num_samples, num_classes).
- - `labels`: Human-readable labels corresponding to the class indices in `y_true`. For example, if `labels=['dog', 'cat']`, class 0 will be displayed as 'dog' and class 1 as 'cat' in the plot. If None, the raw class indices from `y_true` will be used. Default is None.
- - `classes_to_plot`: A subset of unique class labels to include in the ROC curve. If None, all classes in `y_true` will be plotted. Default is None.
- - `title`: Title of the ROC curve plot. Default is "ROC Curve".
- - `split_table`: Whether the table should be split into a separate section in the W&B UI. If `True`, the table will be displayed in a section named "Custom Chart Tables". Default is `False`.
+- **y_true**: The true class labels (ground truth) for the target variable. Shape should be (num_samples,).
+- **y_probas**: The predicted probabilities or decision scores for each class. Shape should be (num_samples, num_classes).
+- **labels**: Human-readable labels corresponding to the class indices in `y_true`. For example, if `labels=['dog', 'cat']`, class 0 will be displayed as 'dog' and class 1 as 'cat' in the plot. If None, the raw class indices from `y_true` will be used. Default is None.
+- **classes_to_plot**: A subset of unique class labels to include in the ROC curve. If None, all classes in `y_true` will be plotted. Default is None.
+- **title**: Title of the ROC curve plot. Default is "ROC Curve".
+- **split_table**: Whether the table should be split into a separate section in the W&B UI. If `True`, the table will be displayed in a section named "Custom Chart Tables". Default is `False`.
+## Returns
-**Returns:**
-
- - `CustomChart`: A custom chart object that can be logged to W&B. To log the chart, pass it to `wandb.log()`.
+- **CustomChart**: A custom chart object that can be logged to W&B. To log the chart, pass it to `wandb.log()`.
+## Raises
-**Raises:**
-
- - `wandb.Error`: If numpy, pandas, or scikit-learn are not found.
+- **wandb.Error**: If numpy, pandas, or scikit-learn are not found.
+## Examples
-**Example:**
- ```python
+```python
import numpy as np
import wandb
@@ -75,11 +72,12 @@ classes_to_plot = [0, 1, 2]
# Initialize a W&B run and log a ROC curve plot for disease classification
with wandb.init(project="medical_diagnosis") as run:
roc_plot = wandb.plot.roc_curve(
- y_true=y_true,
- y_probas=y_probas,
- labels=disease_labels,
- classes_to_plot=classes_to_plot,
- title="ROC Curve for Disease Classification",
+ y_true=y_true,
+ y_probas=y_probas,
+ labels=disease_labels,
+ classes_to_plot=classes_to_plot,
+ title="ROC Curve for Disease Classification",
)
run.log({"roc-curve": roc_plot})
-```
+```
+
diff --git a/models/ref/python/custom-charts/scatter.mdx b/models/ref/python/custom-charts/scatter.mdx
index eebcbd41cb..0a490bb991 100644
--- a/models/ref/python/custom-charts/scatter.mdx
+++ b/models/ref/python/custom-charts/scatter.mdx
@@ -1,47 +1,49 @@
---
-title: scatter()
-namespace: python_sdk_custom_charts
-python_object_type: function
+title: scatter
+kind: function
+namespace: wandb.plot.scatter
---
-import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
+
-### function `scatter`
```python
-scatter(
- table: 'wandb.Table',
- x: 'str',
- y: 'str',
- title: 'str' = '',
- split_table: 'bool' = False
-) → CustomChart
+table: 'wandb.Table',
+x: 'str',
+y: 'str',
+title: 'str' = '',
+split_table: 'bool' = False
```
-Constructs a scatter plot from a wandb.Table of data.
+## Description
+
+Constructs a scatter plot from a wandb.Table of data.
+
+
+
+## Args
+- **table**: The W&B Table containing the data to visualize.
+- **x**: The name of the column used for the x-axis.
+- **y**: The name of the column used for the y-axis.
+- **title**: The title of the scatter chart.
+- **split_table**: Whether the table should be split into a separate section in the W&B UI. If `True`, the table will be displayed in a section named "Custom Chart Tables". Default is `False`.
-**Args:**
-
- - `table`: The W&B Table containing the data to visualize.
- - `x`: The name of the column used for the x-axis.
- - `y`: The name of the column used for the y-axis.
- - `title`: The title of the scatter chart.
- - `split_table`: Whether the table should be split into a separate section in the W&B UI. If `True`, the table will be displayed in a section named "Custom Chart Tables". Default is `False`.
+## Returns
+- **CustomChart**: A custom chart object that can be logged to W&B. To log the chart, pass it to `wandb.log()`.
-**Returns:**
-
- - `CustomChart`: A custom chart object that can be logged to W&B. To log the chart, pass it to `wandb.log()`.
-**Example:**
- ```python
+
+## Examples
+
+```python
import math
import random
import wandb
@@ -59,10 +61,11 @@ table = wandb.Table(data=data, columns=["altitude (m)", "temperature (°C)"])
with wandb.init(project="temperature-altitude-scatter") as run:
# Create and log the scatter plot
scatter_plot = wandb.plot.scatter(
- table=table,
- x="altitude (m)",
- y="temperature (°C)",
- title="Altitude vs Temperature",
+ table=table,
+ x="altitude (m)",
+ y="temperature (°C)",
+ title="Altitude vs Temperature",
)
run.log({"altitude-temperature-scatter": scatter_plot})
-```
+```
+
diff --git a/models/ref/python/data-types/audio.mdx b/models/ref/python/data-types/audio.mdx
index 018146a0ba..435175e058 100644
--- a/models/ref/python/data-types/audio.mdx
+++ b/models/ref/python/data-types/audio.mdx
@@ -1,64 +1,172 @@
---
title: Audio
-namespace: python_sdk_data_type
-python_object_type: class
+kind: class
+namespace: wandb.sdk.data_types.audio
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+
+```python
+(data_or_path: 'str | pathlib.Path | list | np.ndarray',
+sample_rate: 'int | None' = None,
+caption: 'str | None' = None)
+```
+
+## Description
+
+W&B class for audio clips.
+
+
+
+## Args
+- **data_or_path**:
+- **sample_rate**:
+- **caption**:
-## class `Audio`
-W&B class for audio clips.
-### method `Audio.__init__`
+
+
+
+## Methods
+
+### method durations
```python
-__init__(
- data_or_path: 'str | pathlib.Path | list | np.ndarray',
- sample_rate: 'int | None' = None,
- caption: 'str | None' = None
-)
+(audio_list)
```
-Accept a path to an audio file or a numpy array of audio data.
+Calculate the duration of the audio files.
+##### Arguments
+- **audio_list**:
-**Args:**
-
- - `data_or_path`: A path to an audio file or a NumPy array of audio data.
- - `sample_rate`: Sample rate, required when passing in raw NumPy array of audio data.
- - `caption`: Caption to display with audio.
+### method file_is_set
+
+```python
+self
+```
+
+
----
-### classmethod `Audio.durations`
+
+### method init_from_json
```python
-durations(audio_list)
+json_obj: 'dict',
+source_artifact: 'Artifact'
```
-Calculate the duration of the audio files.
+Initialize a `WBValue` from a JSON blob based on the class that created it.
+
+Looks through all subclasses and tries to match the json obj with the class
+which created it. It will then call that subclass' `from_json` method.
+Importantly, this function will set the return object's `source_artifact`
+attribute to the passed in source artifact. This is critical for artifact
+bookkeeping. If you choose to create a wandb.Value via it's `from_json` method,
+make sure to properly set this `artifact_source` to avoid data duplication.
+
+##### Arguments
+
+- **json_obj**: A JSON dictionary to deserialize. It must contain a `_type` key. This is used to lookup the correct subclass to use.
+- **source_artifact**: An artifact which will hold any additional resources which were stored during the `to_json` function.
----
-### classmethod `Audio.sample_rates`
+### method is_bound
```python
-sample_rates(audio_list)
+self
```
-Get sample rates of the audio files.
----
+
+
+
+
+
+### method path_is_reference
+
+```python
+path: 'str | pathlib.Path | None'
+```
+
+
+
+##### Arguments
+
+- **path**:
+
+
+
+
+### method sample_rates
+
+```python
+(audio_list)
+```
+
+Get sample rates of the audio files.
+
+##### Arguments
+
+- **audio_list**:
+
+
+
+
+### method to_data_array
+
+```python
+self
+```
+
+Convert the object to a list of primitives representing the underlying data.
+
+
+
+
+
+### method type_mapping
+
+
+
+Return a map from `_log_type` to subclass. Used to lookup correct types for deserialization.
+
+
+
+
+
+### method with_suffix
+
+```python
+name: 'str',
+filetype: 'str' = 'json'
+```
+
+Get the name with the appropriate suffix.
+
+##### Arguments
+
+- **name**: the name of the file
+- **filetype**: the filetype to use. Defaults to "json".
+
+
+
+
+
diff --git a/models/ref/python/data-types/histogram.mdx b/models/ref/python/data-types/histogram.mdx
index 329eba227e..f3a6c35ae9 100644
--- a/models/ref/python/data-types/histogram.mdx
+++ b/models/ref/python/data-types/histogram.mdx
@@ -1,67 +1,130 @@
---
title: Histogram
-namespace: python_sdk_data_type
-python_object_type: class
+kind: class
+namespace: wandb.sdk.data_types.histogram
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+
+
+```python
+sequence: 'Sequence | None' = None,
+np_histogram: 'NumpyHistogram | None' = None,
+num_bins: 'int' = 64
+```
+
+## Description
+
+W&B class for histograms.
+
+This object works just like numpy's histogram function
+https://docs.scipy.org/doc/numpy/reference/generated/numpy.histogram.html
+
+Attributes:
+ bins ([float]): Edges of bins
+ histogram ([int]): Number of elements falling in each bin.
+## Args
-## class `Histogram`
-W&B class for histograms.
+- **sequence**:
+- **np_histogram**:
+- **num_bins**:
-This object works just like numpy's histogram function https://docs.scipy.org/doc/numpy/reference/generated/numpy.histogram.html
-**Attributes:**
-
- - `bins` ([float]): Edges of bins
- - `histogram` ([int]): Number of elements falling in each bin.
-### method `Histogram.__init__`
+
+## Methods
+
+### method from_json
```python
-__init__(
- sequence: 'Sequence | None' = None,
- np_histogram: 'NumpyHistogram | None' = None,
- num_bins: 'int' = 64
-) → None
+json_obj: 'dict',
+source_artifact: 'Artifact'
```
-Initialize a Histogram object.
+Deserialize a `json_obj` into it's class representation.
+
+If additional resources were stored in the `run_or_artifact` artifact during the
+`to_json` call, then those resources should be in the `source_artifact`.
+##### Arguments
+- **json_obj**: A JSON dictionary to deserialize source_artifact
+- **source_artifact**:
-**Args:**
- sequence: Input data for histogram. np_histogram: Alternative input of a precomputed histogram. num_bins: Number of bins for the histogram. The default number of bins is 64. The maximum number of bins is 512.
-**Examples:**
- Generate histogram from a sequence.
+### method init_from_json
```python
-import wandb
+json_obj: 'dict',
+source_artifact: 'Artifact'
+```
+
+Initialize a `WBValue` from a JSON blob based on the class that created it.
+
+Looks through all subclasses and tries to match the json obj with the class
+which created it. It will then call that subclass' `from_json` method.
+Importantly, this function will set the return object's `source_artifact`
+attribute to the passed in source artifact. This is critical for artifact
+bookkeeping. If you choose to create a wandb.Value via it's `from_json` method,
+make sure to properly set this `artifact_source` to avoid data duplication.
-wandb.Histogram([1, 2, 3])
-```
+##### Arguments
-Efficiently initialize from np.histogram.
+- **json_obj**: A JSON dictionary to deserialize. It must contain a `_type` key. This is used to lookup the correct subclass to use.
+- **source_artifact**: An artifact which will hold any additional resources which were stored during the `to_json` function.
+
+
+
+
+### method to_data_array
```python
-import numpy as np
-import wandb
+self
+```
+
+Convert the object to a list of primitives representing the underlying data.
+
+
+
+
+
+### method type_mapping
+
+
+
+Return a map from `_log_type` to subclass. Used to lookup correct types for deserialization.
+
+
+
+
+
+### method with_suffix
+
+```python
+name: 'str',
+filetype: 'str' = 'json'
+```
+
+Get the name with the appropriate suffix.
+
+##### Arguments
+
+- **name**: the name of the file
+- **filetype**: the filetype to use. Defaults to "json".
-hist = np.histogram(data)
-wandb.Histogram(np_histogram=hist)
-```
----
diff --git a/models/ref/python/data-types/html.mdx b/models/ref/python/data-types/html.mdx
index f28e8a10b5..ddf31b9f7d 100644
--- a/models/ref/python/data-types/html.mdx
+++ b/models/ref/python/data-types/html.mdx
@@ -1,58 +1,184 @@
---
title: Html
-namespace: python_sdk_data_type
-python_object_type: class
+kind: class
+namespace: wandb.sdk.data_types.html
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+
+```python
+data: 'str | pathlib.Path | TextIO',
+inject: 'bool' = True,
+data_is_not_path: 'bool' = False
+```
+
+## Description
+
+W&B class for logging HTML content to W&B.
+
+
+
+## Args
+
+- **data**:
+- **inject**:
+- **data_is_not_path**:
+
+
+
+
+
+
+## Methods
+
+### method bind_to_run
+
+```python
+self,
+run: 'wandb.Run',
+key: 'int | str',
+step: 'int | str',
+id_: 'int | str | None' = None,
+ignore_copy_err: 'bool | None' = None
+```
+
+Bind this object to a particular Run.
+
+Calling this function is necessary so that we have somewhere specific to put the
+file associated with this object, from which other Runs can refer to it.
+
+##### Arguments
+- **run**:
+- **key**:
+- **step**:
+- **id_**:
+- **ignore_copy_err**:
-## class `Html`
-W&B class for logging HTML content to W&B.
-### method `Html.__init__`
+
+### method captions
```python
-__init__(
- data: 'str | pathlib.Path | TextIO',
- inject: 'bool' = True,
- data_is_not_path: 'bool' = False
-) → None
+media_items: 'Sequence[Media]'
```
-Creates a W&B HTML object.
+##### Arguments
+
+- **media_items**:
-**Args:**
- data: A string that is a path to a file with the extension ".html", or a string or IO object containing literal HTML.
- - `inject`: Add a stylesheet to the HTML object. If set to False the HTML will pass through unchanged.
- - `data_is_not_path`: If set to False, the data will be treated as a path to a file.
-**Examples:**
- It can be initialized by providing a path to a file:
+### method file_is_set
```python
-with wandb.init() as run:
- run.log({"html": wandb.Html("./index.html")})
-```
+self
+```
+
+
+
+
+
-Alternatively, it can be initialized by providing literal HTML, in either a string or IO object:
+
+### method init_from_json
```python
-with wandb.init() as run:
- run.log({"html": wandb.Html("
Hello, world!
")})
-```
+json_obj: 'dict',
+source_artifact: 'Artifact'
+```
+Initialize a `WBValue` from a JSON blob based on the class that created it.
+
+Looks through all subclasses and tries to match the json obj with the class
+which created it. It will then call that subclass' `from_json` method.
+Importantly, this function will set the return object's `source_artifact`
+attribute to the passed in source artifact. This is critical for artifact
+bookkeeping. If you choose to create a wandb.Value via it's `from_json` method,
+make sure to properly set this `artifact_source` to avoid data duplication.
+
+##### Arguments
+
+- **json_obj**: A JSON dictionary to deserialize. It must contain a `_type` key. This is used to lookup the correct subclass to use.
+- **source_artifact**: An artifact which will hold any additional resources which were stored during the `to_json` function.
+
+
+
+
+### method is_bound
+
+```python
+self
+```
+
+
+
+
+
+
+
+### method path_is_reference
+
+```python
+path: 'str | pathlib.Path | None'
+```
+
+
+
+##### Arguments
+
+- **path**:
+
+
+
+
+### method to_data_array
+
+```python
+self
+```
+
+Convert the object to a list of primitives representing the underlying data.
+
+
+
+
+
+### method type_mapping
+
+
+
+Return a map from `_log_type` to subclass. Used to lookup correct types for deserialization.
+
+
+
+
+
+### method with_suffix
+
+```python
+name: 'str',
+filetype: 'str' = 'json'
+```
+
+Get the name with the appropriate suffix.
+
+##### Arguments
+
+- **name**: the name of the file
+- **filetype**: the filetype to use. Defaults to "json".
----
diff --git a/models/ref/python/data-types/image.mdx b/models/ref/python/data-types/image.mdx
index 3729ff30b3..0dfcc0d43c 100644
--- a/models/ref/python/data-types/image.mdx
+++ b/models/ref/python/data-types/image.mdx
@@ -1,126 +1,160 @@
---
title: Image
-namespace: python_sdk_data_type
-python_object_type: class
+kind: class
+namespace: wandb.sdk.data_types.image
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+
+
+```python
+data_or_path: 'ImageDataOrPathType',
+mode: 'str | None' = None,
+caption: 'str | None' = None,
+grouping: 'int | None' = None,
+classes: 'Classes | Sequence[dict] | None' = None,
+boxes: 'dict[str, BoundingBoxes2D] | dict[str, dict] | None' = None,
+masks: 'dict[str, ImageMask] | dict[str, dict] | None' = None,
+file_type: 'str | None' = None,
+normalize: 'bool' = True
+```
+
+## Description
+
+A class for logging images to W&B.
+
+
+
+## Args
+
+- **data_or_path**:
+- **mode**:
+- **caption**:
+- **grouping**:
+- **classes**:
+- **boxes**:
+- **masks**:
+- **file_type**:
+- **normalize**:
+
+
+## Properties
+### property image
-## class `Image`
-A class for logging images to W&B.
-### method `Image.__init__`
+
+
+
+## Methods
+
+### method captions
```python
-__init__(
- data_or_path: 'ImageDataOrPathType',
- mode: 'str | None' = None,
- caption: 'str | None' = None,
- grouping: 'int | None' = None,
- classes: 'Classes | Sequence[dict] | None' = None,
- boxes: 'dict[str, BoundingBoxes2D] | dict[str, dict] | None' = None,
- masks: 'dict[str, ImageMask] | dict[str, dict] | None' = None,
- file_type: 'str | None' = None,
- normalize: 'bool' = True
-) → None
+media_items: 'Sequence[Media]'
```
-Initialize a `wandb.Image` object.
-This class handles various image data formats and automatically normalizes pixel values to the range [0, 255] when needed, ensuring compatibility with the W&B backend.
-* Data in range [0, 1] is multiplied by 255 and converted to uint8 * Data in range [-1, 1] is rescaled from [-1, 1] to [0, 255] by mapping
- -1 to 0 and 1 to 255, then converted to uint8 * Data outside [-1, 1] but not in [0, 255] is clipped to [0, 255] and converted to uint8 (with a warning if values fall outside [0, 255]) * Data already in [0, 255] is converted to uint8 without modification
+##### Arguments
+
+- **media_items**:
+
+
+### method file_is_set
+
+```python
+self
+```
+
-**Args:**
-
- - `data_or_path`: Accepts NumPy array/pytorch tensor of image data, a PIL image object, or a path to an image file. If a NumPy array or pytorch tensor is provided, the image data will be saved to the given file type. If the values are not in the range [0, 255] or all values are in the range [0, 1], the image pixel values will be normalized to the range [0, 255] unless `normalize` is set to `False`.
- - pytorch tensor should be in the format (channel, height, width)
- - NumPy array should be in the format (height, width, channel)
- - `mode`: The PIL mode for an image. Most common are "L", "RGB", "RGBA".
- - `Full Pillow docs for more information https`: //pillow.readthedocs.io/en/stable/handbook/concepts.html#modes
- - `caption`: Label for display of image.
- - `grouping`: The grouping number for the image.
- - `classes`: A list of class information for the image, used for labeling bounding boxes, and image masks.
- - `boxes`: A dictionary containing bounding box information for the image.
- - `see https`: //docs.wandb.ai/models/ref/python/data-types/boundingboxes2d
- - `masks`: A dictionary containing mask information for the image.
- - `see https`: //docs.wandb.ai/models/ref/python/data-types/imagemask
- - `file_type`: The file type to save the image as. This parameter has no effect if `data_or_path` is a path to an image file.
- - `normalize`: If `True`, normalize the image pixel values to fall within the range of [0, 255]. Normalize is only applied if `data_or_path` is a numpy array or pytorch tensor.
-**Examples:**
- Create a wandb.Image from a numpy array
+
+
+### method init_from_json
```python
-import numpy as np
-import wandb
+json_obj: 'dict',
+source_artifact: 'Artifact'
+```
-with wandb.init() as run:
- examples = []
- for i in range(3):
- pixels = np.random.randint(low=0, high=256, size=(100, 100, 3))
- image = wandb.Image(pixels, caption=f"random field {i}")
- examples.append(image)
- run.log({"examples": examples})
-```
+Initialize a `WBValue` from a JSON blob based on the class that created it.
-Create a wandb.Image from a PILImage
+Looks through all subclasses and tries to match the json obj with the class
+which created it. It will then call that subclass' `from_json` method.
+Importantly, this function will set the return object's `source_artifact`
+attribute to the passed in source artifact. This is critical for artifact
+bookkeeping. If you choose to create a wandb.Value via it's `from_json` method,
+make sure to properly set this `artifact_source` to avoid data duplication.
+
+##### Arguments
+
+- **json_obj**: A JSON dictionary to deserialize. It must contain a `_type` key. This is used to lookup the correct subclass to use.
+- **source_artifact**: An artifact which will hold any additional resources which were stored during the `to_json` function.
+
+
+
+
+### method is_bound
```python
-import numpy as np
-from PIL import Image as PILImage
-import wandb
-
-with wandb.init() as run:
- examples = []
- for i in range(3):
- pixels = np.random.randint(
- low=0, high=256, size=(100, 100, 3), dtype=np.uint8
- )
- pil_image = PILImage.fromarray(pixels, mode="RGB")
- image = wandb.Image(pil_image, caption=f"random field {i}")
- examples.append(image)
- run.log({"examples": examples})
-```
-
-Log .jpg rather than .png (default)
+self
+```
+
+
+
+
+
+
+
+### method path_is_reference
```python
-import numpy as np
-import wandb
+path: 'str | pathlib.Path | None'
+```
-with wandb.init() as run:
- examples = []
- for i in range(3):
- pixels = np.random.randint(low=0, high=256, size=(100, 100, 3))
- image = wandb.Image(
- pixels, caption=f"random field {i}", file_type="jpg"
- )
- examples.append(image)
- run.log({"examples": examples})
-```
----
+##### Arguments
-### property Image.image
+- **path**:
+### method type_mapping
----
+Return a map from `_log_type` to subclass. Used to lookup correct types for deserialization.
+
+
+
+
+
+### method with_suffix
+
+```python
+name: 'str',
+filetype: 'str' = 'json'
+```
+
+Get the name with the appropriate suffix.
+
+##### Arguments
+
+- **name**: the name of the file
+- **filetype**: the filetype to use. Defaults to "json".
diff --git a/models/ref/python/data-types/molecule.mdx b/models/ref/python/data-types/molecule.mdx
index 7de6135d08..d5cc8ad7a0 100644
--- a/models/ref/python/data-types/molecule.mdx
+++ b/models/ref/python/data-types/molecule.mdx
@@ -1,41 +1,243 @@
---
title: Molecule
-namespace: python_sdk_data_type
-python_object_type: class
+kind: class
+namespace: wandb.sdk.data_types.molecule
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+
+```python
+data_or_path: 'str | pathlib.Path | TextIO',
+caption: 'str | None' = None, **kwargs: 'str'
+```
+
+## Description
+
+W&B class for 3D Molecular data.
-## class `Molecule`
-W&B class for 3D Molecular data.
+## Args
-### method `Molecule.__init__`
+- **data_or_path**:
+- **caption**:
+- **kwargs**:
+
+
+
+
+
+
+## Methods
+
+### method bind_to_run
```python
-__init__(
- data_or_path: 'str | pathlib.Path | TextIO',
- caption: 'str | None' = None,
- **kwargs: 'str'
-) → None
+self,
+run: 'wandb.Run',
+key: 'int | str',
+step: 'int | str',
+id_: 'int | str | None' = None,
+ignore_copy_err: 'bool | None' = None
```
-Initialize a Molecule object.
+Bind this object to a particular Run.
+Calling this function is necessary so that we have somewhere specific to put the
+file associated with this object, from which other Runs can refer to it.
+##### Arguments
-**Args:**
-
- - `data_or_path`: Molecule can be initialized from a file name or an io object.
- - `caption`: Caption associated with the molecule for display.
+- **run**:
+- **key**:
+- **step**:
+- **id_**:
+- **ignore_copy_err**:
----
+### method captions
+
+```python
+media_items: 'Sequence[Media]'
+```
+
+
+
+##### Arguments
+
+- **media_items**:
+
+
+
+
+### method file_is_set
+
+```python
+self
+```
+
+
+
+
+
+
+
+### method from_json
+
+```python
+json_obj: 'dict',
+source_artifact: 'Artifact'
+```
+
+Likely will need to override for any more complicated media objects.
+
+##### Arguments
+
+- **json_obj**:
+- **source_artifact**:
+
+
+
+
+### method from_rdkit
+
+```python
+data_or_path: 'RDKitDataType',
+caption: 'str | None' = None,
+convert_to_3d_and_optimize: 'bool' = True,
+mmff_optimize_molecule_max_iterations: 'int' = 200
+```
+
+Convert RDKit-supported file/object types to wandb.Molecule.
+
+##### Arguments
+
+- **data_or_path**: (string, rdkit.Chem.rdchem.Mol) Molecule can be initialized from a file name or an rdkit.Chem.rdchem.Mol object.
+- **caption**: (string) Caption associated with the molecule for display.
+- **convert_to_3d_and_optimize**: (bool) Convert to rdkit.Chem.rdchem.Mol with 3D coordinates. This is an expensive operation that may take a long time for complicated molecules.
+- **mmff_optimize_molecule_max_iterations**: (int) Number of iterations to use in rdkit.Chem.AllChem.MMFFOptimizeMolecule
+
+
+
+
+### method from_smiles
+
+```python
+data: 'str',
+caption: 'str | None' = None,
+sanitize: 'bool' = True,
+convert_to_3d_and_optimize: 'bool' = True,
+mmff_optimize_molecule_max_iterations: 'int' = 200
+```
+
+Convert SMILES string to wandb.Molecule.
+
+##### Arguments
+
+- **data**: SMILES string.
+- **caption**: Caption associated with the molecule for display.
+- **sanitize**: Check if the molecule is chemically reasonable by the RDKit's definition.
+- **convert_to_3d_and_optimize**: Convert to rdkit.Chem.rdchem.Mol with 3D coordinates. This is a computationally intensive operation that may take a long time for complicated molecules.
+- **mmff_optimize_molecule_max_iterations**: Number of iterations to use in rdkit.Chem.AllChem.MMFFOptimizeMolecule.
+
+
+
+
+### method init_from_json
+
+```python
+json_obj: 'dict',
+source_artifact: 'Artifact'
+```
+
+Initialize a `WBValue` from a JSON blob based on the class that created it.
+
+Looks through all subclasses and tries to match the json obj with the class
+which created it. It will then call that subclass' `from_json` method.
+Importantly, this function will set the return object's `source_artifact`
+attribute to the passed in source artifact. This is critical for artifact
+bookkeeping. If you choose to create a wandb.Value via it's `from_json` method,
+make sure to properly set this `artifact_source` to avoid data duplication.
+
+##### Arguments
+
+- **json_obj**: A JSON dictionary to deserialize. It must contain a `_type` key. This is used to lookup the correct subclass to use.
+- **source_artifact**: An artifact which will hold any additional resources which were stored during the `to_json` function.
+
+
+
+
+### method is_bound
+
+```python
+self
+```
+
+
+
+
+
+
+
+### method path_is_reference
+
+```python
+path: 'str | pathlib.Path | None'
+```
+
+
+
+##### Arguments
+
+- **path**:
+
+
+
+
+### method to_data_array
+
+```python
+self
+```
+
+Convert the object to a list of primitives representing the underlying data.
+
+
+
+
+
+### method type_mapping
+
+
+
+Return a map from `_log_type` to subclass. Used to lookup correct types for deserialization.
+
+
+
+
+
+### method with_suffix
+
+```python
+name: 'str',
+filetype: 'str' = 'json'
+```
+
+Get the name with the appropriate suffix.
+
+##### Arguments
+
+- **name**: the name of the file
+- **filetype**: the filetype to use. Defaults to "json".
+
+
diff --git a/models/ref/python/data-types/object3d.mdx b/models/ref/python/data-types/object3d.mdx
index 5abbf63aff..facb30901c 100644
--- a/models/ref/python/data-types/object3d.mdx
+++ b/models/ref/python/data-types/object3d.mdx
@@ -1,52 +1,251 @@
---
title: Object3D
-namespace: python_sdk_data_type
-python_object_type: class
+kind: class
+namespace: wandb.sdk.data_types.object_3d
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+
+
+```python
+data_or_path: 'np.ndarray | str | pathlib.Path | TextIO | dict',
+caption: 'str | None' = None, **kwargs: 'str | FileFormat3D | None'
+```
+
+## Description
+
+W&B class for 3D point clouds.
+## Args
-## class `Object3D`
-W&B class for 3D point clouds.
+- **data_or_path**:
+- **caption**:
+- **kwargs**:
-### method `Object3D.__init__`
+
+
+
+
+
+## Methods
+
+### method bind_to_run
```python
-__init__(
- data_or_path: 'np.ndarray | str | pathlib.Path | TextIO | dict',
- caption: 'str | None' = None,
- **kwargs: 'str | FileFormat3D | None'
-) → None
+self,
+run: 'wandb.Run',
+key: 'int | str',
+step: 'int | str',
+id_: 'int | str | None' = None,
+ignore_copy_err: 'bool | None' = None
```
-Creates a W&B Object3D object.
+Bind this object to a particular Run.
+Calling this function is necessary so that we have somewhere specific to put the
+file associated with this object, from which other Runs can refer to it.
+##### Arguments
-**Args:**
-
- - `data_or_path`: Object3D can be initialized from a file or a numpy array.
- - `caption`: Caption associated with the object for display.
+- **run**:
+- **key**:
+- **step**:
+- **id_**:
+- **ignore_copy_err**:
-**Examples:**
- The shape of the numpy array must be one of either
-```text
-[[x y z], ...] nx3
-[[x y z c], ...] nx4 where c is a category with supported range [1, 14]
-[[x y z r g b], ...] nx6 where is rgb is color
-```
+### method captions
+```python
+media_items: 'Sequence[Media]'
+```
----
+##### Arguments
+
+- **media_items**:
+
+
+
+
+### method file_is_set
+
+```python
+self
+```
+
+
+
+
+
+
+
+### method from_file
+
+```python
+data_or_path: 'TextIO | str',
+file_type: 'FileFormat3D | None' = None
+```
+
+Initializes Object3D from a file or stream.
+
+##### Arguments
+
+- **data_or_path**: A path to a file or a `TextIO` stream.
+- **file_type**: Specifies the data format passed to `data_or_path`. Required when `data_or_path` is a `TextIO` stream. This parameter is ignored if a file path is provided. The type is taken from the file extension.
+
+
+
+
+### method from_json
+
+```python
+json_obj: 'dict',
+source_artifact: 'Artifact'
+```
+
+Likely will need to override for any more complicated media objects.
+
+##### Arguments
+
+- **json_obj**:
+- **source_artifact**:
+
+
+
+
+### method from_numpy
+
+```python
+data: 'np.ndarray'
+```
+
+Initializes Object3D from a numpy array.
+
+##### Arguments
+
+- **data**: Each entry in the array will represent one point in the point cloud.
+
+
+
+
+### method from_point_cloud
+
+```python
+points: 'Sequence[Point]',
+boxes: 'Sequence[Box3D]',
+vectors: 'Sequence[Vector3D] | None' = None,
+point_cloud_type: 'PointCloudType' = 'lidar/beta'
+```
+
+Initializes Object3D from a python object.
+
+##### Arguments
+
+- **points**: The points in the point cloud.
+- **boxes**: 3D bounding boxes for labeling the point cloud. Boxes are displayed in point cloud visualizations.
+- **vectors**: Each vector is displayed in the point cloud visualization. Can be used to indicate directionality of bounding boxes. Defaults to None.
+- **point_cloud_type**: At this time, only the "lidar/beta" type is supported. Defaults to "lidar/beta".
+
+
+
+
+### method init_from_json
+
+```python
+json_obj: 'dict',
+source_artifact: 'Artifact'
+```
+
+Initialize a `WBValue` from a JSON blob based on the class that created it.
+
+Looks through all subclasses and tries to match the json obj with the class
+which created it. It will then call that subclass' `from_json` method.
+Importantly, this function will set the return object's `source_artifact`
+attribute to the passed in source artifact. This is critical for artifact
+bookkeeping. If you choose to create a wandb.Value via it's `from_json` method,
+make sure to properly set this `artifact_source` to avoid data duplication.
+
+##### Arguments
+
+- **json_obj**: A JSON dictionary to deserialize. It must contain a `_type` key. This is used to lookup the correct subclass to use.
+- **source_artifact**: An artifact which will hold any additional resources which were stored during the `to_json` function.
+
+
+
+
+### method is_bound
+
+```python
+self
+```
+
+
+
+
+
+
+
+### method path_is_reference
+
+```python
+path: 'str | pathlib.Path | None'
+```
+
+
+
+##### Arguments
+
+- **path**:
+
+
+
+
+### method to_data_array
+
+```python
+self
+```
+
+Convert the object to a list of primitives representing the underlying data.
+
+
+
+
+
+### method type_mapping
+
+
+
+Return a map from `_log_type` to subclass. Used to lookup correct types for deserialization.
+
+
+
+
+
+### method with_suffix
+
+```python
+name: 'str',
+filetype: 'str' = 'json'
+```
+
+Get the name with the appropriate suffix.
+
+##### Arguments
+
+- **name**: the name of the file
+- **filetype**: the filetype to use. Defaults to "json".
+
diff --git a/models/ref/python/data-types/plotly.mdx b/models/ref/python/data-types/plotly.mdx
index 21ce43040c..34afd616f5 100644
--- a/models/ref/python/data-types/plotly.mdx
+++ b/models/ref/python/data-types/plotly.mdx
@@ -1,35 +1,197 @@
---
title: Plotly
-namespace: python_sdk_data_type
-python_object_type: class
+kind: class
+namespace: wandb.sdk.data_types.plotly
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+
+
+```python
+(val: 'plotly.Figure | matplotlib.artist.Artist')
+```
+
+## Description
+
+W&B class for Plotly plots.
+
+
+
+## Args
+
+- **val**:
+
-## class `Plotly`
-W&B class for Plotly plots.
-### method `Plotly.__init__`
+## Methods
+
+### method bind_to_run
```python
-__init__(val: 'plotly.Figure | matplotlib.artist.Artist')
+self,
+run: 'wandb.Run',
+key: 'int | str',
+step: 'int | str',
+id_: 'int | str | None' = None,
+ignore_copy_err: 'bool | None' = None
```
-Initialize a Plotly object.
+Bind this object to a particular Run.
+Calling this function is necessary so that we have somewhere specific to put the
+file associated with this object, from which other Runs can refer to it.
+##### Arguments
-**Args:**
-
- - `val`: Matplotlib or Plotly figure.
+- **run**:
+- **key**:
+- **step**:
+- **id_**:
+- **ignore_copy_err**:
+
+
+
+
+### method captions
+
+```python
+media_items: 'Sequence[Media]'
+```
+
+
+
+##### Arguments
+
+- **media_items**:
+
+
+
+
+### method file_is_set
+
+```python
+self
+```
+
+
+
+
+
+
+
+### method from_json
+
+```python
+json_obj: 'dict',
+source_artifact: 'Artifact'
+```
+
+Likely will need to override for any more complicated media objects.
+
+##### Arguments
+
+- **json_obj**:
+- **source_artifact**:
+
+
+
+
+### method init_from_json
+
+```python
+json_obj: 'dict',
+source_artifact: 'Artifact'
+```
+
+Initialize a `WBValue` from a JSON blob based on the class that created it.
+
+Looks through all subclasses and tries to match the json obj with the class
+which created it. It will then call that subclass' `from_json` method.
+Importantly, this function will set the return object's `source_artifact`
+attribute to the passed in source artifact. This is critical for artifact
+bookkeeping. If you choose to create a wandb.Value via it's `from_json` method,
+make sure to properly set this `artifact_source` to avoid data duplication.
+
+##### Arguments
+
+- **json_obj**: A JSON dictionary to deserialize. It must contain a `_type` key. This is used to lookup the correct subclass to use.
+- **source_artifact**: An artifact which will hold any additional resources which were stored during the `to_json` function.
+
+
+
+
+### method is_bound
+
+```python
+self
+```
+
+
+
+
+
+
+
+### method path_is_reference
+
+```python
+path: 'str | pathlib.Path | None'
+```
+
+
+
+##### Arguments
+
+- **path**:
+
+
+
+
+### method to_data_array
+
+```python
+self
+```
+
+Convert the object to a list of primitives representing the underlying data.
+
+
+
+
+
+### method type_mapping
+
+
+
+Return a map from `_log_type` to subclass. Used to lookup correct types for deserialization.
+
+
+
+
+
+### method with_suffix
+
+```python
+name: 'str',
+filetype: 'str' = 'json'
+```
+
+Get the name with the appropriate suffix.
+
+##### Arguments
+
+- **name**: the name of the file
+- **filetype**: the filetype to use. Defaults to "json".
----
diff --git a/models/ref/python/data-types/table.mdx b/models/ref/python/data-types/table.mdx
index b3bcbfa624..d1cd09940a 100644
--- a/models/ref/python/data-types/table.mdx
+++ b/models/ref/python/data-types/table.mdx
@@ -1,180 +1,297 @@
---
title: Table
-namespace: python_sdk_data_type
-python_object_type: class
+kind: class
+namespace: wandb.sdk.data_types.table
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+
+```python
+(columns=None, data=None, rows=None, dataframe=None, dtype=None, optional=True, allow_mixed_types=False,
+log_mode: "Literal['IMMUTABLE', 'MUTABLE', 'INCREMENTAL'] | None" = 'IMMUTABLE')
+```
+
+## Description
+
+The Table class used to display and analyze tabular data.
+
+Unlike traditional spreadsheets, Tables support numerous types of data:
+scalar values, strings, numpy arrays, and most subclasses of `wandb.data_types.Media`.
+This means you can embed `Images`, `Video`, `Audio`, and other sorts of rich, annotated media
+directly in Tables, alongside other traditional scalar values.
+
+This class is the primary class used to generate W&B Tables
+https://docs.wandb.ai/models/tables
+
+
+
+## Args
+
+- **columns**:
+- **data**:
+- **rows**:
+- **dataframe**:
+- **dtype**:
+- **optional**:
+- **allow_mixed_types**:
+- **log_mode**:
-## class `Table`
-The Table class used to display and analyze tabular data.
-Unlike traditional spreadsheets, Tables support numerous types of data: scalar values, strings, numpy arrays, and most subclasses of `wandb.data_types.Media`. This means you can embed `Images`, `Video`, `Audio`, and other sorts of rich, annotated media directly in Tables, alongside other traditional scalar values.
-This class is the primary class used to generate W&B Tables https://docs.wandb.ai/models/tables
-### method `Table.__init__`
+## Methods
+
+### method add_column
```python
-__init__(
- columns=None,
- data=None,
- rows=None,
- dataframe=None,
- dtype=None,
- optional=True,
- allow_mixed_types=False,
- log_mode: "Literal['IMMUTABLE', 'MUTABLE', 'INCREMENTAL'] | None" = 'IMMUTABLE'
-)
+(self, name, data, optional=False)
```
-Initializes a Table object.
+Adds a column of data to the table.
-The rows is available for legacy reasons and should not be used. The Table class uses data to mimic the Pandas API.
+##### Arguments
+- **name**: (str) - the unique name of the column
+- **data**: (list | np.array) - a column of homogeneous data
+- **optional**: (bool) - if null-like values are permitted
-**Args:**
-
- - `columns`: (List[str]) Names of the columns in the table. Defaults to ["Input", "Output", "Expected"].
- - `data`: (List[List[any]]) 2D row-oriented array of values.
- - `dataframe`: (pandas.DataFrame) DataFrame object used to create the table. When set, `data` and `columns` arguments are ignored.
- - `rows`: (List[List[any]]) 2D row-oriented array of values.
- - `optional`: (Union[bool,List[bool]]) Determines if `None` values are allowed. Default to True
- - If a singular bool value, then the optionality is enforced for all columns specified at construction time
- - If a list of bool values, then the optionality is applied to each column - should be the same length as `columns` applies to all columns. A list of bool values applies to each respective column.
- - `allow_mixed_types`: (bool) Determines if columns are allowed to have mixed types (disables type validation). Defaults to False
- - `log_mode`: Optional[str] Controls how the Table is logged when mutations occur. Options:
- - "IMMUTABLE" (default): Table can only be logged once; subsequent logging attempts after the table has been mutated will be no-ops.
- - "MUTABLE": Table can be re-logged after mutations, creating a new artifact version each time it's logged.
- - "INCREMENTAL": Table data is logged incrementally, with each log creating a new artifact entry containing the new data since the last log.
+### method add_computed_columns
+```python
+(self, fn)
+```
+
+Adds one or more computed columns based on existing data.
+
+##### Arguments
+
+- **fn**: A function which accepts one or two parameters, ndx (int) and row (dict), which is expected to return a dict representing new columns for that row, keyed by the new column names. - `ndx` is an integer representing the index of the row. Only included if `include_ndx` is set to `True`. - `row` is a dictionary keyed by existing columns
----
-### method `Table.add_column`
+
+
+### method add_data
```python
-add_column(name, data, optional=False)
+(self, *data)
```
-Adds a column of data to the table.
+Adds a new row of data to the table.
+The maximum amount ofrows in a table is determined by
+`wandb.Table.MAX_ARTIFACT_ROWS`.
+The length of the data should match the length of the table column.
-**Args:**
-
- - `name`: (str) - the unique name of the column
- - `data`: (list | np.array) - a column of homogeneous data
- - `optional`: (bool) - if null-like values are permitted
+##### Arguments
+
+- **data**:
----
-### method `Table.add_computed_columns`
+
+
+### method add_row
```python
-add_computed_columns(fn)
+(self, *row)
```
-Adds one or more computed columns based on existing data.
+Deprecated. Use `Table.add_data` method instead.
+##### Arguments
+- **row**:
-**Args:**
-
- - `fn`: A function which accepts one or two parameters, ndx (int) and row (dict), which is expected to return a dict representing new columns for that row, keyed by the new column names.
- - `ndx` is an integer representing the index of the row. Only included if `include_ndx` is set to `True`.
- - `row` is a dictionary keyed by existing columns
----
-### method `Table.add_data`
+
+### method captions
```python
-add_data(*data)
+media_items: 'Sequence[Media]'
```
-Adds a new row of data to the table.
-The maximum amount ofrows in a table is determined by `wandb.Table.MAX_ARTIFACT_ROWS`.
-The length of the data should match the length of the table column.
+##### Arguments
+
+- **media_items**:
+
----
-### method `Table.add_row`
+
+### method cast
```python
-add_row(*row)
+(self, col_name, dtype, optional=False)
```
-Deprecated. Use `Table.add_data` method instead.
+Casts a column to a specific data type.
----
+This can be one of the normal python classes, an internal W&B type,
+or an example object, like an instance of wandb.Image or
+wandb.Classes.
+
+##### Arguments
+- **col_name**: The name of the column to cast.
+- **dtype**: The target dtype.
+- **optional**: If the column should allow Nones.
-### method `Table.cast`
+
+
+
+### method file_is_set
```python
-cast(col_name, dtype, optional=False)
+self
```
-Casts a column to a specific data type.
-This can be one of the normal python classes, an internal W&B type, or an example object, like an instance of wandb.Image or wandb.Classes.
-**Args:**
-
- - `col_name` (str): The name of the column to cast.
- - `dtype` (class, wandb.wandb_sdk.interface._dtypes.Type, any): The target dtype.
- - `optional` (bool): If the column should allow Nones.
----
+### method get_column
+
+```python
+(self, name, convert_to=None)
+```
-### method `Table.get_column`
+Retrieves a column from the table and optionally converts it to a NumPy object.
+
+##### Arguments
+
+- **name**: (str) - the name of the column
+- **convert_to**: (str, optional)
+
+
+
+
+### method get_dataframe
```python
-get_column(name, convert_to=None)
+(self)
```
-Retrieves a column from the table and optionally converts it to a NumPy object.
+Returns a `pandas.DataFrame` of the table.
-**Args:**
-
- - `name`: (str) - the name of the column
- - `convert_to`: (str, optional)
- - "numpy": will convert the underlying data to numpy object
----
-### method `Table.get_dataframe`
+### method get_index
```python
-get_dataframe()
+(self)
```
-Returns a `pandas.DataFrame` of the table.
+Returns an array of row indexes for use in other tables to create links.
+
+
----
-### method `Table.get_index`
+
+### method init_from_json
```python
-get_index()
+json_obj: 'dict',
+source_artifact: 'Artifact'
```
-Returns an array of row indexes for use in other tables to create links.
+Initialize a `WBValue` from a JSON blob based on the class that created it.
+
+Looks through all subclasses and tries to match the json obj with the class
+which created it. It will then call that subclass' `from_json` method.
+Importantly, this function will set the return object's `source_artifact`
+attribute to the passed in source artifact. This is critical for artifact
+bookkeeping. If you choose to create a wandb.Value via it's `from_json` method,
+make sure to properly set this `artifact_source` to avoid data duplication.
+
+##### Arguments
+
+- **json_obj**: A JSON dictionary to deserialize. It must contain a `_type` key. This is used to lookup the correct subclass to use.
+- **source_artifact**: An artifact which will hold any additional resources which were stored during the `to_json` function.
+
+
+
+
+### method is_bound
+
+```python
+self
+```
+
+
+
+
+
+
+
+### method path_is_reference
+
+```python
+path: 'str | pathlib.Path | None'
+```
+
+
+
+##### Arguments
+
+- **path**:
+
+
+
+
+### method to_data_array
+
+```python
+self
+```
+
+Convert the object to a list of primitives representing the underlying data.
+
+
+
+
+
+### method type_mapping
+
+
+
+Return a map from `_log_type` to subclass. Used to lookup correct types for deserialization.
+
+
+
+
+
+### method with_suffix
+
+```python
+name: 'str',
+filetype: 'str' = 'json'
+```
+
+Get the name with the appropriate suffix.
+
+##### Arguments
+
+- **name**: the name of the file
+- **filetype**: the filetype to use. Defaults to "json".
+
+
+
+
----
diff --git a/models/ref/python/data-types/video.mdx b/models/ref/python/data-types/video.mdx
index 7e6ccf5c2f..bf9b82634f 100644
--- a/models/ref/python/data-types/video.mdx
+++ b/models/ref/python/data-types/video.mdx
@@ -1,61 +1,203 @@
---
title: Video
-namespace: python_sdk_data_type
-python_object_type: class
+kind: class
+namespace: wandb.sdk.data_types.video
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+
+
+```python
+(data_or_path: 'str | pathlib.Path | np.ndarray | TextIO | BytesIO',
+caption: 'str | None' = None,
+fps: 'int | None' = None,
+format: "Literal['gif', 'mp4', 'webm', 'ogg'] | None" = None)
+```
+
+## Description
+
+A class for logging videos to W&B.
+
+
+
+## Args
+
+- **data_or_path**:
+- **caption**:
+- **fps**:
+- **format**:
-## class `Video`
-A class for logging videos to W&B.
-### method `Video.__init__`
+
+## Methods
+
+### method bind_to_run
```python
-__init__(
- data_or_path: 'str | pathlib.Path | np.ndarray | TextIO | BytesIO',
- caption: 'str | None' = None,
- fps: 'int | None' = None,
- format: "Literal['gif', 'mp4', 'webm', 'ogg'] | None" = None
-)
+self,
+run: 'wandb.Run',
+key: 'int | str',
+step: 'int | str',
+id_: 'int | str | None' = None,
+ignore_copy_err: 'bool | None' = None
```
-Initialize a W&B Video object.
+Bind this object to a particular Run.
+
+Calling this function is necessary so that we have somewhere specific to put the
+file associated with this object, from which other Runs can refer to it.
+##### Arguments
+- **run**:
+- **key**:
+- **step**:
+- **id_**:
+- **ignore_copy_err**:
-**Args:**
-
- - `data_or_path`: Video can be initialized with a path to a file or an io object. Video can be initialized with a numpy tensor. The numpy tensor must be either 4 dimensional or 5 dimensional. The dimensions should be (number of frames, channel, height, width) or (batch, number of frames, channel, height, width) The format parameter must be specified with the format argument when initializing with a numpy array or io object.
- - `caption`: Caption associated with the video for display.
- - `fps`: The frame rate to use when encoding raw video frames. Default value is 4. This parameter has no effect when data_or_path is a string, or bytes.
- - `format`: Format of video, necessary if initializing with a numpy array or io object. This parameter will be used to determine the format to use when encoding the video data. Accepted values are "gif", "mp4", "webm", or "ogg". If no value is provided, the default format will be "gif".
-**Examples:**
- Log a numpy array as a video
+### method captions
```python
-import numpy as np
-import wandb
+media_items: 'Sequence[Media]'
+```
-with wandb.init() as run:
- # axes are (number of frames, channel, height, width)
- frames = np.random.randint(
- low=0, high=256, size=(10, 3, 100, 100), dtype=np.uint8
- )
- run.log({"video": wandb.Video(frames, format="mp4", fps=4)})
-```
+##### Arguments
+
+- **media_items**:
+
+
+
+
+### method file_is_set
+
+```python
+self
+```
+
+
+
+
+
+
+
+### method from_json
+
+```python
+json_obj: 'dict',
+source_artifact: 'Artifact'
+```
+
+Likely will need to override for any more complicated media objects.
+
+##### Arguments
+
+- **json_obj**:
+- **source_artifact**:
+
+
+
+
+### method init_from_json
+
+```python
+json_obj: 'dict',
+source_artifact: 'Artifact'
+```
+
+Initialize a `WBValue` from a JSON blob based on the class that created it.
+
+Looks through all subclasses and tries to match the json obj with the class
+which created it. It will then call that subclass' `from_json` method.
+Importantly, this function will set the return object's `source_artifact`
+attribute to the passed in source artifact. This is critical for artifact
+bookkeeping. If you choose to create a wandb.Value via it's `from_json` method,
+make sure to properly set this `artifact_source` to avoid data duplication.
+
+##### Arguments
+
+- **json_obj**: A JSON dictionary to deserialize. It must contain a `_type` key. This is used to lookup the correct subclass to use.
+- **source_artifact**: An artifact which will hold any additional resources which were stored during the `to_json` function.
+
+
+
+
+### method is_bound
+
+```python
+self
+```
+
+
+
+
+
+
+
+### method path_is_reference
+
+```python
+path: 'str | pathlib.Path | None'
+```
+
+
+
+##### Arguments
+
+- **path**:
+
+
+
+
+### method to_data_array
+
+```python
+self
+```
+
+Convert the object to a list of primitives representing the underlying data.
+
+
+
+
+
+### method type_mapping
+
+
+
+Return a map from `_log_type` to subclass. Used to lookup correct types for deserialization.
+
+
+
+
+
+### method with_suffix
+
+```python
+name: 'str',
+filetype: 'str' = 'json'
+```
+
+Get the name with the appropriate suffix.
+
+##### Arguments
+
+- **name**: the name of the file
+- **filetype**: the filetype to use. Defaults to "json".
+
----
diff --git a/models/ref/python/experiments/artifact.mdx b/models/ref/python/experiments/artifact.mdx
index 45179e8c43..60d2145018 100644
--- a/models/ref/python/experiments/artifact.mdx
+++ b/models/ref/python/experiments/artifact.mdx
@@ -1,1126 +1,801 @@
---
title: Artifact
-namespace: python_sdk_actions
-python_object_type: class
+kind: class
+namespace: wandb.sdk.artifacts.artifact
---
-import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
-
-
+import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-## class `Artifact`
-Flexible and lightweight building block for dataset and model versioning.
+
-Construct an empty W&B Artifact. Populate an artifacts contents with methods that begin with `add`. Once the artifact has all the desired files, you can call `run.log_artifact()` to log it.
-### method `Artifact.__init__`
```python
-__init__(
- name: 'str',
- type: 'str',
- description: 'str | None' = None,
- metadata: 'dict[str, Any] | None' = None,
- incremental: 'bool' = False,
- use_as: 'str | None' = None,
- storage_region: 'str | None' = None
-) → None
+name: 'str',
+type: 'str',
+description: 'str | None' = None,
+metadata: 'dict[str, Any] | None' = None,
+incremental: 'bool' = False,
+use_as: 'str | None' = None,
+storage_region: 'str | None' = None
```
-**Args:**
-
- - `name` (str): A human-readable name for the artifact. Use the name to identify a specific artifact in the W&B App UI or programmatically. You can interactively reference an artifact with the `use_artifact` Public API. A name can contain letters, numbers, underscores, hyphens, and dots. The name must be unique across a project.
- - `type` (str): The artifact's type. Use the type of an artifact to both organize and differentiate artifacts. You can use any string that contains letters, numbers, underscores, hyphens, and dots. Common types include `dataset` or `model`. Include `model` within your type string if you want to link the artifact to the W&B Model Registry. Note that some types reserved for internal use and cannot be set by users. Such types include `job` and types that start with `wandb-`.
- - `description (str | None) = None`: A description of the artifact. For Model or Dataset Artifacts, add documentation for your standardized team model or dataset card. View an artifact's description programmatically with the `Artifact.description` attribute or programmatically with the W&B App UI. W&B renders the description as markdown in the W&B App.
- - `metadata (dict[str, Any] | None) = None`: Additional information about an artifact. Specify metadata as a dictionary of key-value pairs. You can specify no more than 100 total keys.
- - `incremental`: Use `Artifact.new_draft()` method instead to modify an existing artifact.
- - `use_as`: Deprecated.
-
-
-
-**Returns:**
- An `Artifact` object.
-
-
-
-
-
-
-
----
+## Description
-### property Artifact.aliases
+Flexible and lightweight building block for dataset and model versioning.
-List of one or more semantically-friendly references or
+Construct an empty W&B Artifact. Populate an artifacts contents with methods that
+begin with `add`. Once the artifact has all the desired files, you can call
+`run.log_artifact()` to log it.
-identifying "nicknames" assigned to an artifact version.
-Aliases are mutable references that you can programmatically reference. Change an artifact's alias with the W&B App UI or programmatically. See [Create new artifact versions](https://docs.wandb.ai/models/artifacts/create-a-new-artifact-version) for more information.
+## Args
+- **name**: A human-readable name for the artifact. Use the name to identify a specific artifact in the W&B App UI or programmatically. You can interactively reference an artifact with the `use_artifact` Public API. A name can contain letters, numbers, underscores, hyphens, and dots. The name must be unique across a project.
+- **type**: The artifact's type. Use the type of an artifact to both organize and differentiate artifacts. You can use any string that contains letters, numbers, underscores, hyphens, and dots. Common types include `dataset` or `model`. Include `model` within your type string if you want to link the artifact to the W&B Model Registry. Note that some types reserved for internal use and cannot be set by users. Such types include `job` and types that start with `wandb-`.
+- **description**: A description of the artifact. For Model or Dataset Artifacts, add documentation for your standardized team model or dataset card. View an artifact's description programmatically with the `Artifact.description` attribute or programmatically with the W&B App UI. W&B renders the description as markdown in the W&B App.
+- **metadata**: Additional information about an artifact. Specify metadata as a dictionary of key-value pairs. You can specify no more than 100 total keys.
+- **incremental**: Use `Artifact.new_draft()` method instead to modify an existing artifact.
+- **use_as**: Deprecated.
+- **storage_region**:
-**Returns:**
- - `list[str]`: The aliases property value.
----
-### property Artifact.collection
-The collection this artifact is retrieved from.
-A collection is an ordered group of artifact versions. If this artifact is retrieved from a collection that it is linked to, return that collection. Otherwise, return the collection that the artifact version originates from.
+## Properties
-The collection that an artifact originates from is known as the source sequence.
+### property id
+The artifact's ID.
+### property entity
-**Returns:**
- - `ArtifactCollection`: The collection property value.
----
+The name of the entity that the artifact collection belongs to.
-### property Artifact.commit_hash
+If the artifact is a link, the entity will be the entity of the linked artifact.
-The hash returned when this artifact was committed.
+### property project
+The name of the project that the artifact collection belongs to.
+If the artifact is a link, the project will be the project of the linked artifact.
-**Returns:**
- - `str`: The commit_hash property value.
----
+### property name
-### property Artifact.created_at
+The artifact name and version of the artifact.
-Timestamp when the artifact was created.
+A string with the format `{collection}:{alias}`. If fetched before an artifact is
+logged/saved, the name won't contain the alias.
+If the artifact is a link, the name will be the name of the linked artifact.
+### property qualified_name
+The entity/project/name of the artifact.
-**Returns:**
- - `str`: The created_at property value.
----
+If the artifact is a link, the qualified name will be the qualified name of the
+linked artifact path.
-### property Artifact.description
+### property version
-A description of the artifact.
+The artifact's version.
+A string with the format `v{number}`.
+If this is a link artifact, the version will be from the linked collection.
+### property collection
-**Returns:**
- - `str | None`: The description property value.
----
+The collection this artifact is retrieved from.
-### property Artifact.digest
+A collection is an ordered group of artifact versions.
+If this artifact is retrieved from a collection that it is linked to,
+return that collection. Otherwise, return the collection
+that the artifact version originates from.
-The logical digest of the artifact.
+The collection that an artifact originates from is known as
+the source sequence.
-The digest is the checksum of the artifact's contents. If an artifact has the same digest as the current `latest` version, then `log_artifact` is a no-op.
+### property source_entity
+The name of the entity of the source artifact.
+### property source_project
-**Returns:**
- - `str`: The digest property value.
----
+The name of the project of the source artifact.
+### property source_name
-### property Artifact.entity
+The artifact name and version of the source artifact.
-The name of the entity that the artifact collection belongs to.
+A string with the format `{source_collection}:{alias}`. Before the artifact
+is saved, contains only the name since the version is not yet known.
-If the artifact is a link, the entity will be the entity of the linked artifact.
+### property source_qualified_name
+The source_entity/source_project/source_name of the source artifact.
+### property source_version
-**Returns:**
- - `str`: The entity property value.
----
+The source artifact's version.
-### property Artifact.file_count
+A string with the format `v{number}`.
-The number of files (including references).
+### property source_collection
+The artifact's source collection.
+The source collection is the collection that the artifact was logged from.
-**Returns:**
- - `int`: The file_count property value.
----
+### property is_link
-### property Artifact.history_step
+Boolean flag indicating if the artifact is a link artifact.
-The nearest step which logged history metrics for this artifact's source run.
+True: The artifact is a link artifact to a source artifact.
+False: The artifact is a source artifact.
+### property linked_artifacts
+Returns a list of all the linked artifacts of a source artifact.
-**Examples:**
- ```python
-run = artifact.logged_by()
-if run and (artifact.history_step is not None):
- history = run.sample_history(
- min_step=artifact.history_step,
- max_step=artifact.history_step + 1,
- keys=["my_metric"],
- )
-```
+If this artifact is a link artifact (`artifact.is_link == True`),
+it will return an empty list.
+Limited to 500 results.
+### property source_artifact
-**Returns:**
- - `int | None`: The history_step property value.
----
+Returns the source artifact, which is the original logged artifact.
-### property Artifact.id
+If this artifact is a source artifact (`artifact.is_link == False`),
+it will return itself.
-The artifact's ID.
+### property type
+The artifact's type. Common types include `dataset` or `model`.
+### property url
-**Returns:**
- - `str | None`: The id property value.
----
+Constructs the URL of the artifact.
+### property description
-### property Artifact.is_link
+A description of the artifact.
-Boolean flag indicating if the artifact is a link artifact.
+### property metadata
-True: The artifact is a link artifact to a source artifact. False: The artifact is a source artifact.
+User-defined artifact metadata.
+Structured data associated with the artifact.
+### property ttl
-**Returns:**
- - `bool`: The is_link property value.
----
+The time-to-live (TTL) policy of an artifact.
-### property Artifact.linked_artifacts
+Artifacts are deleted shortly after a TTL policy's duration passes.
+If set to `None`, the artifact deactivates TTL policies and will be not
+scheduled for deletion, even if there is a team default TTL.
+An artifact inherits a TTL policy from
+the team default if the team administrator defines a default
+TTL and there is no custom policy set on an artifact.
-Returns a list of all the linked artifacts of a source artifact.
+### property aliases
-If this artifact is a link artifact (`artifact.is_link == True`), it will return an empty list.
+List of one or more semantically-friendly references or
-Limited to 500 results.
+identifying "nicknames" assigned to an artifact version.
+Aliases are mutable references that you can programmatically reference.
+Change an artifact's alias with the W&B App UI or programmatically.
+See [Create new artifact versions](https://docs.wandb.ai/models/artifacts/create-a-new-artifact-version)
+for more information.
+### property tags
-**Returns:**
- - `list[Artifact]`: The linked_artifacts property value.
----
+List of one or more tags assigned to this artifact version.
-### property Artifact.manifest
+### property use_as
-The artifact's manifest.
+Deprecated.
-The manifest lists all of its contents, and can't be changed once the artifact has been logged.
+### property state
+The status of the artifact. One of: "PENDING", "COMMITTED", or "DELETED".
+### property manifest
-**Returns:**
- - `ArtifactManifest`: The manifest property value.
----
+The artifact's manifest.
-### property Artifact.metadata
+The manifest lists all of its contents, and can't be changed once the artifact
+has been logged.
-User-defined artifact metadata.
+### property digest
-Structured data associated with the artifact.
+The logical digest of the artifact.
+The digest is the checksum of the artifact's contents. If an artifact has the
+same digest as the current `latest` version, then `log_artifact` is a no-op.
+### property size
-**Returns:**
- - `dict`: The metadata property value.
----
+The total size of the artifact in bytes.
-### property Artifact.name
+Includes any references tracked by this artifact.
-The artifact name and version of the artifact.
+### property commit_hash
-A string with the format `{collection}:{alias}`. If fetched before an artifact is logged/saved, the name won't contain the alias. If the artifact is a link, the name will be the name of the linked artifact.
+The hash returned when this artifact was committed.
+### property file_count
+The number of files (including references).
-**Returns:**
- - `str`: The name property value.
----
+### property created_at
-### property Artifact.project
+Timestamp when the artifact was created.
-The name of the project that the artifact collection belongs to.
+### property updated_at
-If the artifact is a link, the project will be the project of the linked artifact.
+The time when the artifact was last updated.
+### property history_step
+The nearest step which logged history metrics for this artifact's source run.
-**Returns:**
- - `str`: The project property value.
----
-
-### property Artifact.qualified_name
-
-The entity/project/name of the artifact.
-
-If the artifact is a link, the qualified name will be the qualified name of the linked artifact path.
-
-
-
-**Returns:**
- - `str`: The qualified_name property value.
----
-
-### property Artifact.size
-
-The total size of the artifact in bytes.
-
-Includes any references tracked by this artifact.
-
-
-
-**Returns:**
- - `int`: The size property value.
----
-
-### property Artifact.source_artifact
-
-Returns the source artifact, which is the original logged artifact.
-
-If this artifact is a source artifact (`artifact.is_link == False`), it will return itself.
-
-
-
-**Returns:**
- - `Artifact`: The source_artifact property value.
----
-
-### property Artifact.source_collection
-
-The artifact's source collection.
-
-The source collection is the collection that the artifact was logged from.
-
-
-
-**Returns:**
- - `ArtifactCollection`: The source_collection property value.
----
-### property Artifact.source_entity
-The name of the entity of the source artifact.
-
-
-
-**Returns:**
- - `str`: The source_entity property value.
----
-
-### property Artifact.source_name
-
-The artifact name and version of the source artifact.
-
-A string with the format `{source_collection}:{alias}`. Before the artifact is saved, contains only the name since the version is not yet known.
-
-
-
-**Returns:**
- - `str`: The source_name property value.
----
-
-### property Artifact.source_project
-
-The name of the project of the source artifact.
-
-
-
-**Returns:**
- - `str`: The source_project property value.
----
-
-### property Artifact.source_qualified_name
-
-The source_entity/source_project/source_name of the source artifact.
-
-
-
-**Returns:**
- - `str`: The source_qualified_name property value.
----
-
-### property Artifact.source_version
-
-The source artifact's version.
-
-A string with the format `v{number}`.
-
-
-
-**Returns:**
- - `str`: The source_version property value.
----
-
-### property Artifact.state
-
-The status of the artifact. One of: "PENDING", "COMMITTED", or "DELETED".
-
-
-
-**Returns:**
- - `str`: The state property value.
----
-
-### property Artifact.tags
-
-List of one or more tags assigned to this artifact version.
-
-
-
-**Returns:**
- - `list[str]`: The tags property value.
----
-
-### property Artifact.ttl
-
-The time-to-live (TTL) policy of an artifact.
-
-Artifacts are deleted shortly after a TTL policy's duration passes. If set to `None`, the artifact deactivates TTL policies and will be not scheduled for deletion, even if there is a team default TTL. An artifact inherits a TTL policy from the team default if the team administrator defines a default TTL and there is no custom policy set on an artifact.
-
-
-
-**Raises:**
-
- - `ArtifactNotLoggedError`: Unable to fetch inherited TTL if the artifact has not been logged or saved.
-
-
-
-**Returns:**
- - `timedelta | None`: The ttl property value.
----
-
-### property Artifact.type
-
-The artifact's type. Common types include `dataset` or `model`.
-
-
-
-**Returns:**
- - `str`: The type property value.
----
+## Methods
-### property Artifact.updated_at
-
-The time when the artifact was last updated.
-
-
-
-**Returns:**
- - `str`: The updated_at property value.
----
-
-### property Artifact.url
-
-Constructs the URL of the artifact.
-
-
-
-**Returns:**
-
- - `str`: The URL of the artifact.
-
-
-
-**Returns:**
- - `str`: The url property value.
----
-
-### property Artifact.use_as
-
-Deprecated.
-
-
-
-**Returns:**
- - `str | None`: The use_as property value.
----
-
-### property Artifact.version
-
-The artifact's version.
-
-A string with the format `v{number}`. If this is a link artifact, the version will be from the linked collection.
-
-
-
-
-
-**Returns:**
- - `str`: The version property value.
----
-
-### method `Artifact.add`
+### method add
```python
-add(
- obj: 'WBValue',
- name: 'StrPath',
- overwrite: 'bool' = False
-) → ArtifactManifestEntry
+self,
+obj: 'WBValue',
+name: 'StrPath',
+overwrite: 'bool' = False
```
-Add wandb.WBValue `obj` to the artifact.
-
-
-
-**Args:**
-
- - `obj`: The object to add. Currently support one of Bokeh, JoinedTable, PartitionedTable, Table, Classes, ImageMask, BoundingBoxes2D, Audio, Image, Video, Html, Object3D
- - `name`: The path within the artifact to add the object.
- - `overwrite`: If True, overwrite existing objects with the same file path if applicable.
+Add wandb.WBValue `obj` to the artifact.
+##### Arguments
+- **obj**: The object to add. Currently support one of Bokeh, JoinedTable, PartitionedTable, Table, Classes, ImageMask, BoundingBoxes2D, Audio, Image, Video, Html, Object3D
+- **name**: The path within the artifact to add the object.
+- **overwrite**: If True, overwrite existing objects with the same file path if applicable.
-**Returns:**
- The added manifest entry
+##### Raises
+- **ArtifactFinalizedError**: You cannot make changes to the current artifact version because it is finalized. Log a new artifact version instead.
-**Raises:**
-
- - `ArtifactFinalizedError`: You cannot make changes to the current artifact version because it is finalized. Log a new artifact version instead.
----
-
-### method `Artifact.add_dir`
+### method add_dir
```python
-add_dir(
- local_path: 'str',
- name: 'str | None' = None,
- skip_cache: 'bool | None' = False,
- policy: "Literal['mutable', 'immutable'] | None" = 'mutable',
- merge: 'bool' = False
-) → None
+self,
+local_path: 'str',
+name: 'str | None' = None,
+skip_cache: 'bool | None' = False,
+policy: "Literal['mutable', 'immutable'] | None" = 'mutable',
+merge: 'bool' = False
```
-Add a local directory to the artifact.
+Add a local directory to the artifact.
+##### Arguments
+- **local_path**: The path of the local directory.
+- **name**: The subdirectory name within an artifact. The name you specify appears in the W&B App UI nested by artifact's `type`. Defaults to the root of the artifact.
+- **skip_cache**: If set to `True`, W&B will not copy/move files to the cache while uploading
+- **policy**: By default, "mutable".
+- **merge**: If `False` (default), throws ValueError if a file was already added in a previous add_dir call and its content has changed. If `True`, overwrites existing files with changed content. Always adds new files and never removes files. To replace an entire directory, pass a name when adding the directory using `add_dir(local_path, name=my_prefix)` and call `remove(my_prefix)` to remove the directory, then add it again.
-**Args:**
-
- - `local_path`: The path of the local directory.
- - `name`: The subdirectory name within an artifact. The name you specify appears in the W&B App UI nested by artifact's `type`. Defaults to the root of the artifact.
- - `skip_cache`: If set to `True`, W&B will not copy/move files to the cache while uploading
- - `policy`: By default, "mutable".
- - mutable: Create a temporary copy of the file to prevent corruption during upload.
- - immutable: Disable protection, rely on the user not to delete or change the file.
- - `merge`: If `False` (default), throws ValueError if a file was already added in a previous add_dir call and its content has changed. If `True`, overwrites existing files with changed content. Always adds new files and never removes files. To replace an entire directory, pass a name when adding the directory using `add_dir(local_path, name=my_prefix)` and call `remove(my_prefix)` to remove the directory, then add it again.
+##### Raises
+- **ArtifactFinalizedError**: You cannot make changes to the current artifact version because it is finalized. Log a new artifact version instead.
+- **ValueError**: Policy must be "mutable" or "immutable"
-**Raises:**
-
- - `ArtifactFinalizedError`: You cannot make changes to the current artifact version because it is finalized. Log a new artifact version instead.
- - `ValueError`: Policy must be "mutable" or "immutable"
-
----
-### method `Artifact.add_file`
+### method add_file
```python
-add_file(
- local_path: 'str',
- name: 'str | None' = None,
- is_tmp: 'bool | None' = False,
- skip_cache: 'bool | None' = False,
- policy: "Literal['mutable', 'immutable'] | None" = 'mutable',
- overwrite: 'bool' = False
-) → ArtifactManifestEntry
+self,
+local_path: 'str',
+name: 'str | None' = None,
+is_tmp: 'bool | None' = False,
+skip_cache: 'bool | None' = False,
+policy: "Literal['mutable', 'immutable'] | None" = 'mutable',
+overwrite: 'bool' = False
```
-Add a local file to the artifact.
+Add a local file to the artifact.
+##### Arguments
+- **local_path**: The path to the file being added.
+- **name**: The path within the artifact to use for the file being added. Defaults to the basename of the file.
+- **is_tmp**: If true, then the file is renamed deterministically to avoid collisions.
+- **skip_cache**: If `True`, do not copy files to the cache after uploading.
+- **policy**: By default, set to "mutable". If set to "mutable", create a temporary copy of the file to prevent corruption during upload. If set to "immutable", disable protection and rely on the user not to delete or change the file.
+- **overwrite**: If `True`, overwrite the file if it already exists.
-**Args:**
-
- - `local_path`: The path to the file being added.
- - `name`: The path within the artifact to use for the file being added. Defaults to the basename of the file.
- - `is_tmp`: If true, then the file is renamed deterministically to avoid collisions.
- - `skip_cache`: If `True`, do not copy files to the cache after uploading.
- - `policy`: By default, set to "mutable". If set to "mutable", create a temporary copy of the file to prevent corruption during upload. If set to "immutable", disable protection and rely on the user not to delete or change the file.
- - `overwrite`: If `True`, overwrite the file if it already exists.
+##### Raises
+- **ArtifactFinalizedError**: You cannot make changes to the current artifact version because it is finalized. Log a new artifact version instead.
+- **ValueError**: Policy must be "mutable" or "immutable"
-**Returns:**
- The added manifest entry.
-
-
-**Raises:**
-
- - `ArtifactFinalizedError`: You cannot make changes to the current artifact version because it is finalized. Log a new artifact version instead.
- - `ValueError`: Policy must be "mutable" or "immutable"
-
----
-
-### method `Artifact.add_reference`
+### method add_reference
```python
-add_reference(
- uri: 'ArtifactManifestEntry | str',
- name: 'StrPath | None' = None,
- checksum: 'bool' = True,
- max_objects: 'int | None' = None
-) → Sequence[ArtifactManifestEntry]
+self,
+uri: 'ArtifactManifestEntry | str',
+name: 'StrPath | None' = None,
+checksum: 'bool' = True,
+max_objects: 'int | None' = None
```
-Add a reference denoted by a URI to the artifact.
-
-Unlike files or directories that you add to an artifact, references are not uploaded to W&B. For more information, see [Track external files](https://docs.wandb.ai/models/artifacts/track-external-files).
-
-By default, the following schemes are supported:
+Add a reference denoted by a URI to the artifact.
+Unlike files or directories that you add to an artifact, references are not
+uploaded to W&B. For more information,
+see [Track external files](https://docs.wandb.ai/models/artifacts/track-external-files).
-- http(s): The size and digest of the file will be inferred by the `Content-Length` and the `ETag` response headers returned by the server.
-- s3: The checksum and size are pulled from the object metadata. If bucket versioning is enabled, then the version ID is also tracked.
-- gs: The checksum and size are pulled from the object metadata. If bucket versioning is enabled, then the version ID is also tracked.
-- https, domain matching `*.blob.core.windows.net`
-- Azure: The checksum and size are be pulled from the blob metadata. If storage account versioning is enabled, then the version ID is also tracked.
-- file: The checksum and size are pulled from the file system. This scheme is useful if you have an NFS share or other externally mounted volume containing files you wish to track but not necessarily upload.
+By default, the following schemes are supported:
-For any other scheme, the digest is just a hash of the URI and the size is left blank.
+- http(s): The size and digest of the file will be inferred by the
+ `Content-Length` and the `ETag` response headers returned by the server.
+- s3: The checksum and size are pulled from the object metadata.
+ If bucket versioning is enabled, then the version ID is also tracked.
+- gs: The checksum and size are pulled from the object metadata. If bucket
+ versioning is enabled, then the version ID is also tracked.
+- https, domain matching `*.blob.core.windows.net`
+- Azure: The checksum and size are be pulled from the blob metadata.
+ If storage account versioning is enabled, then the version ID is
+ also tracked.
+- file: The checksum and size are pulled from the file system. This scheme
+ is useful if you have an NFS share or other externally mounted volume
+ containing files you wish to track but not necessarily upload.
+For any other scheme, the digest is just a hash of the URI and the size is left
+blank.
+##### Arguments
-**Args:**
-
- - `uri`: The URI path of the reference to add. The URI path can be an object returned from `Artifact.get_entry` to store a reference to another artifact's entry.
- - `name`: The path within the artifact to place the contents of this reference.
- - `checksum`: Whether or not to checksum the resource(s) located at the reference URI. Checksumming is strongly recommended as it enables automatic integrity validation. Disabling checksumming will speed up artifact creation but reference directories will not iterated through so the objects in the directory will not be saved to the artifact. We recommend setting `checksum=False` when adding reference objects, in which case a new version will only be created if the reference URI changes.
- - `max_objects`: The maximum number of objects to consider when adding a reference that points to directory or bucket store prefix. By default, the maximum number of objects allowed for Amazon S3, GCS, Azure, and local files is 10,000,000. Other URI schemas do not have a maximum.
+- **uri**: The URI path of the reference to add. The URI path can be an object returned from `Artifact.get_entry` to store a reference to another artifact's entry.
+- **name**: The path within the artifact to place the contents of this reference.
+- **checksum**: Whether or not to checksum the resource(s) located at the reference URI. Checksumming is strongly recommended as it enables automatic integrity validation. Disabling checksumming will speed up artifact creation but reference directories will not iterated through so the objects in the directory will not be saved to the artifact. We recommend setting `checksum=False` when adding reference objects, in which case a new version will only be created if the reference URI changes.
+- **max_objects**: The maximum number of objects to consider when adding a reference that points to directory or bucket store prefix. By default, the maximum number of objects allowed for Amazon S3, GCS, Azure, and local files is 10,000,000. Other URI schemas do not have a maximum.
+##### Raises
-**Returns:**
- The added manifest entries.
+- **ArtifactFinalizedError**: You cannot make changes to the current artifact version because it is finalized. Log a new artifact version instead.
-
-**Raises:**
-
- - `ArtifactFinalizedError`: You cannot make changes to the current artifact version because it is finalized. Log a new artifact version instead.
-
----
-
-### method `Artifact.checkout`
+### method checkout
```python
-checkout(root: 'str | None' = None) → str
+self,
+root: 'str | None' = None
```
-Replace the specified root directory with the contents of the artifact.
-
-WARNING: This will delete all files in `root` that are not included in the artifact.
-
-
+Replace the specified root directory with the contents of the artifact.
-**Args:**
-
- - `root`: The directory to replace with this artifact's files.
+WARNING: This will delete all files in `root` that are not included in the
+artifact.
+##### Arguments
+- **root**: The directory to replace with this artifact's files.
-**Returns:**
- The path of the checked out contents.
+##### Raises
+- **ArtifactNotLoggedError**: If the artifact is not logged.
-**Raises:**
-
- - `ArtifactNotLoggedError`: If the artifact is not logged.
----
-
-### method `Artifact.delete`
+### method delete
```python
-delete(delete_aliases: 'bool' = False) → None
+self,
+delete_aliases: 'bool' = False
```
-Delete an artifact and its files.
+Delete an artifact and its files.
-If called on a linked artifact, only the link is deleted, and the source artifact is unaffected.
+If called on a linked artifact, only the link is deleted, and the
+source artifact is unaffected.
-Use `Artifact.unlink()` instead of `Artifact.delete()` to remove a link between a source artifact and a collection.
+Use `Artifact.unlink()` instead of `Artifact.delete()` to remove a
+link between a source artifact and a collection.
+##### Arguments
+- **delete_aliases**: If set to `True`, delete all aliases associated with the artifact. If `False`, raise an exception if the artifact has existing aliases. This parameter is ignored if the artifact is retrieved from a collection it is linked to.
-**Args:**
-
- - `delete_aliases`: If set to `True`, delete all aliases associated with the artifact. If `False`, raise an exception if the artifact has existing aliases. This parameter is ignored if the artifact is retrieved from a collection it is linked to.
+##### Raises
+- **ArtifactNotLoggedError**: If the artifact is not logged.
-**Raises:**
-
- - `ArtifactNotLoggedError`: If the artifact is not logged.
-
----
-### method `Artifact.download`
+### method download
```python
-download(
- root: 'StrPath | None' = None,
- allow_missing_references: 'bool' = False,
- skip_cache: 'bool | None' = None,
- path_prefix: 'StrPath | None' = None,
- multipart: 'bool | None' = None
-) → FilePathStr
+self,
+root: 'StrPath | None' = None,
+allow_missing_references: 'bool' = False,
+skip_cache: 'bool | None' = None,
+path_prefix: 'StrPath | None' = None,
+multipart: 'bool | None' = None
```
-Download the contents of the artifact to the specified root directory.
-
-Existing files located within `root` are not modified. Explicitly delete `root` before you call `download` if you want the contents of `root` to exactly match the artifact.
-
-
+Download the contents of the artifact to the specified root directory.
-**Args:**
-
- - `root`: The directory W&B stores the artifact's files.
- - `allow_missing_references`: If set to `True`, any invalid reference paths will be ignored while downloading referenced files.
- - `skip_cache`: If set to `True`, the artifact cache will be skipped when downloading and W&B will download each file into the default root or specified download directory.
- - `path_prefix`: If specified, only files with a path that starts with the given prefix will be downloaded. Uses unix format (forward slashes).
- - `multipart`: If set to `None` (default), the artifact will be downloaded in parallel using multipart download if individual file size is greater than 2GB. If set to `True` or `False`, the artifact will be downloaded in parallel or serially regardless of the file size.
+Existing files located within `root` are not modified. Explicitly delete `root`
+before you call `download` if you want the contents of `root` to exactly match
+the artifact.
+##### Arguments
+- **root**: The directory W&B stores the artifact's files.
+- **allow_missing_references**: If set to `True`, any invalid reference paths will be ignored while downloading referenced files.
+- **skip_cache**: If set to `True`, the artifact cache will be skipped when downloading and W&B will download each file into the default root or specified download directory.
+- **path_prefix**: If specified, only files with a path that starts with the given prefix will be downloaded. Uses unix format (forward slashes).
+- **multipart**: If set to `None` (default), the artifact will be downloaded in parallel using multipart download if individual file size is greater than 2GB. If set to `True` or `False`, the artifact will be downloaded in parallel or serially regardless of the file size.
-**Returns:**
- The path to the downloaded contents.
+##### Raises
+- **ArtifactNotLoggedError**: If the artifact is not logged.
-**Raises:**
-
- - `ArtifactNotLoggedError`: If the artifact is not logged.
----
-
-### method `Artifact.file`
+### method file
```python
-file(root: 'str | None' = None) → StrPath
+self,
+root: 'str | None' = None
```
-Download a single file artifact to the directory you specify with `root`.
-
-
+Download a single file artifact to the directory you specify with `root`.
-**Args:**
-
- - `root`: The root directory to store the file. Defaults to `./artifacts/self.name/`.
+##### Arguments
+- **root**: The root directory to store the file. Defaults to `./artifacts/self.name/`.
-**Returns:**
- The full path of the downloaded file.
+##### Raises
+- **ArtifactNotLoggedError**: If the artifact is not logged.
+- **ValueError**: If the artifact contains more than one file.
-**Raises:**
-
- - `ArtifactNotLoggedError`: If the artifact is not logged.
- - `ValueError`: If the artifact contains more than one file.
-
----
-
-### method `Artifact.files`
+### method files
```python
-files(
- names: 'list[str] | None' = None,
- per_page: 'int' = 50,
- start: 'str | None' = None
-) → ArtifactFiles
+self,
+names: 'list[str] | None' = None,
+per_page: 'int' = 50,
+start: 'str | None' = None
```
-Iterate over all files stored in this artifact.
-
+Iterate over all files stored in this artifact.
+##### Arguments
-**Args:**
-
- - `names`: The filename paths relative to the root of the artifact you wish to list.
- - `per_page`: The number of files to return per request.
- - `start`: Pagination cursor for resuming a past query, captured from a previous paginator's `.cursor` attribute.
+- **names**: The filename paths relative to the root of the artifact you wish to list.
+- **per_page**: The number of files to return per request.
+- **start**: Pagination cursor for resuming a past query, captured from a previous paginator's `.cursor` attribute.
+##### Raises
-**Returns:**
- An iterator containing `File` objects.
+- **ArtifactNotLoggedError**: If the artifact is not logged.
-
-**Raises:**
-
- - `ArtifactNotLoggedError`: If the artifact is not logged.
-
----
-
-### method `Artifact.finalize`
+### method finalize
```python
-finalize() → None
+self
```
-Finalize the artifact version.
+Finalize the artifact version.
-You cannot modify an artifact version once it is finalized because the artifact is logged as a specific artifact version. Create a new artifact version to log more data to an artifact. An artifact is automatically finalized when you log the artifact with `log_artifact`.
+You cannot modify an artifact version once it is finalized because the artifact
+is logged as a specific artifact version. Create a new artifact version
+to log more data to an artifact. An artifact is automatically finalized
+when you log the artifact with `log_artifact`.
----
-### method `Artifact.get`
-```python
-get(name: 'str') → WBValue | None
-```
-Get the WBValue object located at the artifact relative `name`.
+### method get
+```python
+self,
+name: 'str'
+```
-**Args:**
-
- - `name`: The artifact relative name to retrieve.
-
+Get the WBValue object located at the artifact relative `name`.
+##### Arguments
-**Returns:**
- W&B object that can be logged with `run.log()` and visualized in the W&B UI.
+- **name**: The artifact relative name to retrieve.
+##### Raises
-**Raises:**
-
- - `ArtifactNotLoggedError`: if the artifact isn't logged or the run is offline.
+- **ArtifactNotLoggedError**: if the artifact isn't logged or the run is offline.
----
-### method `Artifact.get_added_local_path_name`
+### method get_added_local_path_name
```python
-get_added_local_path_name(local_path: 'str') → str | None
+self,
+local_path: 'str'
```
-Get the artifact relative name of a file added by a local filesystem path.
+Get the artifact relative name of a file added by a local filesystem path.
+##### Arguments
+- **local_path**: The local path to resolve into an artifact relative name.
-**Args:**
-
- - `local_path`: The local path to resolve into an artifact relative name.
-**Returns:**
- The artifact relative name.
-
----
-
-### method `Artifact.get_entry`
+### method get_entry
```python
-get_entry(name: 'StrPath') → ArtifactManifestEntry
+self,
+name: 'StrPath'
```
-Get the entry with the given name.
+Get the entry with the given name.
+##### Arguments
+- **name**: The artifact relative name to get
-**Args:**
-
- - `name`: The artifact relative name to get
+##### Raises
+- **ArtifactNotLoggedError**: if the artifact isn't logged or the run is offline.
+- **KeyError**: if the artifact doesn't contain an entry with the given name.
-**Returns:**
- A `W&B` object.
+### method get_path
+```python
+self,
+name: 'StrPath'
+```
-**Raises:**
-
- - `ArtifactNotLoggedError`: if the artifact isn't logged or the run is offline.
- - `KeyError`: if the artifact doesn't contain an entry with the given name.
+Deprecated. Use `get_entry(name)`.
----
+##### Arguments
-### method `Artifact.get_path`
+- **name**:
-```python
-get_path(name: 'StrPath') → ArtifactManifestEntry
-```
-Deprecated. Use `get_entry(name)`.
----
-### method `Artifact.is_draft`
+### method is_draft
```python
-is_draft() → bool
+self
```
-Check if artifact is not saved.
+Check if artifact is not saved.
-**Returns:**
- Boolean. `False` if artifact is saved. `True` if artifact is not saved.
----
-### method `Artifact.json_encode`
+### method json_encode
```python
-json_encode() → dict[str, Any]
+self
```
-Returns the artifact encoded to the JSON format.
+Returns the artifact encoded to the JSON format.
-**Returns:**
- A `dict` with `string` keys representing attributes of the artifact.
----
-### method `Artifact.link`
+### method link
```python
-link(target_path: 'str', aliases: 'Iterable[str] | None' = None) → Artifact
+self,
+target_path: 'str',
+aliases: 'Iterable[str] | None' = None
```
-Link this artifact to a collection.
-
-
-
-**Args:**
-
- - `target_path`: The path of the collection. Path consists of the prefix "wandb-registry-" along with the registry name and the collection name `wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}`.
- - `aliases`: Add one or more aliases to the linked artifact. The "latest" alias is automatically applied to the most recent artifact you link.
+Link this artifact to a collection.
+##### Arguments
+- **target_path**: The path of the collection. Path consists of the prefix "wandb-registry-" along with the registry name and the collection name `wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}`.
+- **aliases**: Add one or more aliases to the linked artifact. The "latest" alias is automatically applied to the most recent artifact you link.
-**Raises:**
-
- - `ArtifactNotLoggedError`: If the artifact is not logged.
+##### Raises
+- **ArtifactNotLoggedError**: If the artifact is not logged.
-**Returns:**
- The linked artifact.
----
-
-### method `Artifact.logged_by`
+### method logged_by
```python
-logged_by() → Run | None
+self
```
-Get the W&B run that originally logged the artifact.
+Get the W&B run that originally logged the artifact.
-**Returns:**
- The name of the W&B run that originally logged the artifact.
+##### Raises
+- **ArtifactNotLoggedError**: If the artifact is not logged.
-**Raises:**
-
- - `ArtifactNotLoggedError`: If the artifact is not logged.
-
----
-
-### method `Artifact.new_draft`
+### method new_draft
```python
-new_draft() → Artifact
+self
```
-Create a new draft artifact with the same content as this committed artifact.
-
-Modifying an existing artifact creates a new artifact version known as an "incremental artifact". The artifact returned can be extended or modified and logged as a new version.
+Create a new draft artifact with the same content as this committed artifact.
+Modifying an existing artifact creates a new artifact version known
+as an "incremental artifact". The artifact returned can be extended or
+modified and logged as a new version.
-**Returns:**
- An `Artifact` object.
+##### Raises
+- **ArtifactNotLoggedError**: If the artifact is not logged.
-**Raises:**
-
- - `ArtifactNotLoggedError`: If the artifact is not logged.
-
----
-### method `Artifact.new_file`
+### method new_file
```python
-new_file(
- name: 'str',
- mode: 'str' = 'x',
- encoding: 'str | None' = None
-) → Iterator[IO]
+self,
+name: 'str',
+mode: 'str' = 'x',
+encoding: 'str | None' = None
```
-Open a new temporary file and add it to the artifact.
+Open a new temporary file and add it to the artifact.
+##### Arguments
+- **name**: The name of the new file to add to the artifact.
+- **mode**: The file access mode to use to open the new file.
+- **encoding**: The encoding used to open the new file.
-**Args:**
-
- - `name`: The name of the new file to add to the artifact.
- - `mode`: The file access mode to use to open the new file.
- - `encoding`: The encoding used to open the new file.
+##### Raises
+- **ArtifactFinalizedError**: You cannot make changes to the current artifact version because it is finalized. Log a new artifact version instead.
-**Returns:**
- A new file object that can be written to. Upon closing, the file is automatically added to the artifact.
-
-
-**Raises:**
-
- - `ArtifactFinalizedError`: You cannot make changes to the current artifact version because it is finalized. Log a new artifact version instead.
-
----
-
-### method `Artifact.remove`
+### method remove
```python
-remove(item: 'StrPath | ArtifactManifestEntry') → None
+self,
+item: 'StrPath | ArtifactManifestEntry'
```
-Remove an item from the artifact.
+Remove an item from the artifact.
+##### Arguments
+- **item**: The item to remove. Can be a specific manifest entry or the name of an artifact-relative path. If the item matches a directory all items in that directory will be removed.
-**Args:**
-
- - `item`: The item to remove. Can be a specific manifest entry or the name of an artifact-relative path. If the item matches a directory all items in that directory will be removed.
+##### Raises
+- **ArtifactFinalizedError**: You cannot make changes to the current artifact version because it is finalized. Log a new artifact version instead.
+- **FileNotFoundError**: If the item isn't found in the artifact.
-**Raises:**
-
- - `ArtifactFinalizedError`: You cannot make changes to the current artifact version because it is finalized. Log a new artifact version instead.
- - `FileNotFoundError`: If the item isn't found in the artifact.
-
----
-### method `Artifact.save`
+### method save
```python
-save(
- project: 'str | None' = None,
- settings: 'wandb.Settings | None' = None
-) → None
+self,
+project: 'str | None' = None,
+settings: 'wandb.Settings | None' = None
```
-Persist any changes made to the artifact.
+Persist any changes made to the artifact.
-If currently in a run, that run will log this artifact. If not currently in a run, a run of type "auto" is created to track this artifact.
+If currently in a run, that run will log this artifact. If not currently in a
+run, a run of type "auto" is created to track this artifact.
+##### Arguments
+
+- **project**: A project to use for the artifact in the case that a run is not already in context.
+- **settings**: A settings object to use when initializing an automatic run. Most commonly used in testing harness.
-**Args:**
-
- - `project`: A project to use for the artifact in the case that a run is not already in context.
- - `settings`: A settings object to use when initializing an automatic run. Most commonly used in testing harness.
----
-### method `Artifact.unlink`
+### method unlink
```python
-unlink() → None
+self
```
-Unlink this artifact if it is a linked member of an artifact collection.
+Unlink this artifact if it is a linked member of an artifact collection.
-**Raises:**
-
- - `ArtifactNotLoggedError`: If the artifact is not logged.
- - `ValueError`: If the artifact is not linked to any collection.
+##### Raises
----
+- **ArtifactNotLoggedError**: If the artifact is not logged.
+- **ValueError**: If the artifact is not linked to any collection.
-### method `Artifact.used_by`
+
+### method used_by
```python
-used_by() → list[Run]
+self
```
-Get a list of the runs that have used this artifact and its linked artifacts.
-
+Get a list of the runs that have used this artifact and its linked artifacts.
-**Returns:**
- A list of `Run` objects.
+##### Raises
+- **ArtifactNotLoggedError**: If the artifact is not logged.
-**Raises:**
-
- - `ArtifactNotLoggedError`: If the artifact is not logged.
-
----
-### method `Artifact.verify`
+### method verify
```python
-verify(root: 'str | None' = None) → None
+self,
+root: 'str | None' = None
```
-Verify that the contents of an artifact match the manifest.
+Verify that the contents of an artifact match the manifest.
-All files in the directory are checksummed and the checksums are then cross-referenced against the artifact's manifest. References are not verified.
+All files in the directory are checksummed and the checksums are then
+cross-referenced against the artifact's manifest. References are not verified.
+##### Arguments
+- **root**: The directory to verify. If None artifact will be downloaded to './artifacts/self.name/'.
-**Args:**
-
- - `root`: The directory to verify. If None artifact will be downloaded to './artifacts/self.name/'.
+##### Raises
+- **ArtifactNotLoggedError**: If the artifact is not logged.
+- **ValueError**: If the verification fails.
-**Raises:**
-
- - `ArtifactNotLoggedError`: If the artifact is not logged.
- - `ValueError`: If the verification fails.
----
-
-### method `Artifact.wait`
+### method wait
```python
-wait(timeout: 'int | None' = None) → Artifact
+self,
+timeout: 'int | None' = None
```
-If needed, wait for this artifact to finish logging.
+If needed, wait for this artifact to finish logging.
+
+##### Arguments
+- **timeout**: The time, in seconds, to wait.
-**Args:**
-
- - `timeout`: The time, in seconds, to wait.
-**Returns:**
- An `Artifact` object.
diff --git a/models/ref/python/experiments/run.mdx b/models/ref/python/experiments/run.mdx
index ae919880fa..0198829140 100644
--- a/models/ref/python/experiments/run.mdx
+++ b/models/ref/python/experiments/run.mdx
@@ -1,37 +1,66 @@
---
title: Run
-namespace: python_sdk_actions
-python_object_type: class
+kind: class
+namespace: wandb.sdk.wandb_run
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+
+```python
+settings: 'Settings',
+config: 'dict[str, Any] | None' = None,
+sweep_config: 'dict[str, Any] | None' = None,
+launch_config: 'dict[str, Any] | None' = None
+```
+
+## Description
+A unit of computation logged by W&B. Typically, this is an ML experiment.
+Call [`wandb.init()`](https://docs.wandb.ai/models/ref/python/functions/init) to create a
+new run. `wandb.init()` starts a new run and returns a `wandb.Run` object.
+Each run is associated with a unique ID (run ID). W&B recommends using
+a context (`with` statement) manager to automatically finish the run.
-## class `Run`
-A unit of computation logged by W&B. Typically, this is an ML experiment.
+For distributed training experiments, you can either track each process
+separately using one run per process or track all processes to a single run.
+See [Log distributed training experiments](https://docs.wandb.ai/models/track/log/distributed-training)
+for more information.
-Call [`wandb.init()`](https://docs.wandb.ai/models/ref/python/functions/init) to create a new run. `wandb.init()` starts a new run and returns a `wandb.Run` object. Each run is associated with a unique ID (run ID). W&B recommends using a context (`with` statement) manager to automatically finish the run.
+You can log data to a run with `wandb.Run.log()`. Anything you log using
+`wandb.Run.log()` is sent to that run. See
+[Create an experiment](https://docs.wandb.ai/models/track/create-an-experiment) or
+[`wandb.init`](https://docs.wandb.ai/models/ref/python/functions/init) API reference page
+or more information.
-For distributed training experiments, you can either track each process separately using one run per process or track all processes to a single run. See [Log distributed training experiments](https://docs.wandb.ai/models/track/log/distributed-training) for more information.
+There is a another `Run` object in the
+[`wandb.apis.public`](https://docs.wandb.ai/models/ref/python/public-api/api)
+namespace. Use this object is to interact with runs that have already been
+created.
-You can log data to a run with `wandb.Run.log()`. Anything you log using `wandb.Run.log()` is sent to that run. See [Create an experiment](https://docs.wandb.ai/models/track/create-an-experiment) or [`wandb.init`](https://docs.wandb.ai/models/ref/python/functions/init) API reference page or more information.
+Attributes:
+ summary: (Summary) A summary of the run, which is a dictionary-like
+ object. For more information, see
+ [Log summary metrics](https://docs.wandb.ai/models/track/log/log-summary).
-There is a another `Run` object in the [`wandb.apis.public`](https://docs.wandb.ai/models/ref/python/public-api/api) namespace. Use this object is to interact with runs that have already been created.
+## Args
-**Attributes:**
-
- - `summary`: (Summary) A summary of the run, which is a dictionary-like object. For more information, see
- - `[Log summary metrics](https`: //docs.wandb.ai/models/track/log/log-summary).
+- **settings**:
+- **config**:
+- **sweep_config**:
+- **launch_config**:
+## Examples
-**Examples:**
- Create a run with `wandb.init()`:
+Create a run with `wandb.init()`:
```python
import wandb
@@ -40,564 +69,447 @@ import wandb
# Use context manager (`with` statement) to automatically finish the run
with wandb.init(entity="entity", project="project") as run:
run.log({"accuracy": acc, "loss": loss})
-```
-
-
-### property Run.config
-
-Config object associated with this run.
-
-
-
-**Returns:**
- - `wandb_config.Config`: The config property value.
----
-
-### property Run.config_static
-
-Static config object associated with this run.
-
-
-
-**Returns:**
- - `wandb_config.ConfigStatic`: The config_static property value.
----
-
-### property Run.dir
-
-The directory where files associated with the run are saved.
-
-
-
-**Returns:**
- - `str`: The dir property value.
----
-
-### property Run.disabled
-
-True if the run is disabled, False otherwise.
-
-
-
-**Returns:**
- - `bool`: The disabled property value.
----
-
-### property Run.entity
-
-The name of the W&B entity associated with the run.
-
-Entity can be a username or the name of a team or organization.
-
-
-
-**Returns:**
- - `str`: The entity property value.
----
-
-### property Run.group
-
-Returns the name of the group associated with this run.
-
-Grouping runs together allows related experiments to be organized and visualized collectively in the W&B UI. This is especially useful for scenarios such as distributed training or cross-validation, where multiple runs should be viewed and managed as a unified experiment.
-
-In shared mode, where all processes share the same run object, setting a group is usually unnecessary, since there is only one run and no grouping is required.
-
-
-
-**Returns:**
- - `str`: The group property value.
----
-
-### property Run.id
-
-Identifier for this run.
-
-
-
-**Returns:**
- - `str`: The id property value.
----
-
-### property Run.job_type
-
-Name of the job type associated with the run.
-
-View a run's job type in the run's Overview page in the W&B App.
-
-You can use this to categorize runs by their job type, such as "training", "evaluation", or "inference". This is useful for organizing and filtering runs in the W&B UI, especially when you have multiple runs with different job types in the same project. For more information, see [Organize runs](https://docs.wandb.ai/models/runs#organize-runs).
-
-
-
-**Returns:**
- - `str`: The job_type property value.
----
-
-### property Run.name
-
-Display name of the run.
+```
-Display names are not guaranteed to be unique and may be descriptive. By default, they are randomly generated.
+## Properties
+### property settings
+A frozen copy of run's Settings object.
-**Returns:**
- - `str | None`: The name property value.
----
+### property dir
-### property Run.notes
+The directory where files associated with the run are saved.
-Notes associated with the run, if there are any.
+### property config
-Notes can be a multiline string and can also use markdown and latex equations inside `$$`, like `$x + 3$`.
+Config object associated with this run.
+### property config_static
+Static config object associated with this run.
-**Returns:**
- - `str | None`: The notes property value.
----
+### property name
-### property Run.offline
+Display name of the run.
-True if the run is offline, False otherwise.
+Display names are not guaranteed to be unique and may be descriptive.
+By default, they are randomly generated.
+### property notes
+Notes associated with the run, if there are any.
-**Returns:**
- - `bool`: The offline property value.
----
+Notes can be a multiline string and can also use markdown and latex
+equations inside `$$`, like `$x + 3$`.
-### property Run.path
+### property tags
-Path to the run.
+Tags associated with the run, if there are any.
-Run paths include entity, project, and run ID, in the format `entity/project/run_id`.
+### property id
+Identifier for this run.
+### property sweep_id
-**Returns:**
- - `str`: The path property value.
----
+Identifier for the sweep associated with the run, if there is one.
-### property Run.project
+### property path
-Name of the W&B project associated with the run.
+Path to the run.
+Run paths include entity, project, and run ID, in the format
+`entity/project/run_id`.
+### property start_time
-**Returns:**
- - `str`: The project property value.
----
+Unix timestamp (in seconds) of when the run started.
-### property Run.project_url
+### property resumed
-URL of the W&B project associated with the run, if there is one.
+True if the run was resumed, False otherwise.
-Offline runs do not have a project URL.
+### property offline
+True if the run is offline, False otherwise.
+### property disabled
-**Returns:**
- - `str | None`: The project_url property value.
----
+True if the run is disabled, False otherwise.
-### property Run.resumed
+### property group
-True if the run was resumed, False otherwise.
+Returns the name of the group associated with this run.
+Grouping runs together allows related experiments to be organized and
+visualized collectively in the W&B UI. This is especially useful for
+scenarios such as distributed training or cross-validation, where
+multiple runs should be viewed and managed as a unified experiment.
+In shared mode, where all processes share the same run object,
+setting a group is usually unnecessary, since there is only one
+run and no grouping is required.
-**Returns:**
- - `bool`: The resumed property value.
----
+### property job_type
-### property Run.settings
+Name of the job type associated with the run.
-A frozen copy of run's Settings object.
+View a run's job type in the run's Overview page in the W&B App.
+You can use this to categorize runs by their job type, such as
+"training", "evaluation", or "inference". This is useful for organizing
+and filtering runs in the W&B UI, especially when you have multiple
+runs with different job types in the same project. For more
+information, see [Organize runs](https://docs.wandb.ai/models/runs#organize-runs).
+### property project
-**Returns:**
- - `Settings`: The settings property value.
----
+Name of the W&B project associated with the run.
-### property Run.start_time
+### property project_url
-Unix timestamp (in seconds) of when the run started.
+URL of the W&B project associated with the run, if there is one.
+Offline runs do not have a project URL.
+### property sweep_url
-**Returns:**
- - `float`: The start_time property value.
----
+URL of the sweep associated with the run, if there is one.
+Offline runs do not have a sweep URL.
+### property url
-### property Run.sweep_id
+The url for the W&B run, if there is one.
-Identifier for the sweep associated with the run, if there is one.
+Offline runs will not have a url.
+### property entity
+The name of the W&B entity associated with the run.
-**Returns:**
- - `str | None`: The sweep_id property value.
----
+Entity can be a username or the name of a team or organization.
-### property Run.sweep_url
-URL of the sweep associated with the run, if there is one.
-Offline runs do not have a sweep URL.
+## Methods
+### method alert
+```python
+self,
+title: 'str',
+text: 'str',
+level: 'str | AlertLevel | None' = None,
+wait_duration: 'int | float | timedelta | None' = None
+```
-**Returns:**
- - `str | None`: The sweep_url property value.
----
-
-### property Run.tags
-
-Tags associated with the run, if there are any.
-
-
-
-**Returns:**
- - `tuple | None`: The tags property value.
----
-
-### property Run.url
-
-The url for the W&B run, if there is one.
-
-Offline runs will not have a url.
+Create an alert with the given title and text.
+##### Arguments
+- **title**: The title of the alert, must be less than 64 characters long.
+- **text**: The text body of the alert.
+- **level**: The alert level to use, either: `INFO`, `WARN`, or `ERROR`.
+- **wait_duration**: The time to wait (in seconds) before sending another alert with this title.
-**Returns:**
- - `str | None`: The url property value.
----
-### method `Run.alert`
+### method define_metric
```python
-alert(
- title: 'str',
- text: 'str',
- level: 'str | AlertLevel | None' = None,
- wait_duration: 'int | float | timedelta | None' = None
-) → None
+self,
+name: 'str',
+step_metric: 'str | wandb_metric.Metric | None' = None,
+step_sync: 'bool | None' = None,
+hidden: 'bool | None' = None,
+summary: 'str | None' = None,
+goal: 'str | None' = None,
+overwrite: 'bool | None' = None
```
-Create an alert with the given title and text.
+Customize metrics logged with `wandb.Run.log()`.
+##### Arguments
+
+- **name**: The name of the metric to customize.
+- **step_metric**: The name of another metric to serve as the X-axis for this metric in automatically generated charts.
+- **step_sync**: Automatically insert the last value of step_metric into `wandb.Run.log()` if it is not provided explicitly. Defaults to True if step_metric is specified.
+- **hidden**: Hide this metric from automatic plots.
+- **summary**: Specify aggregate metrics added to summary. Supported aggregations include "min", "max", "mean", "last", "first", "best", "copy" and "none". "none" prevents a summary from being generated. "best" is used together with the goal parameter, "best" is deprecated and should not be used, use "min" or "max" instead. "copy" is deprecated and should not be used.
+- **goal**: Specify how to interpret the "best" summary type. Supported options are "minimize" and "maximize". "goal" is deprecated and should not be used, use "min" or "max" instead.
+- **overwrite**: If false, then this call is merged with previous `define_metric` calls for the same metric by using their values for any unspecified parameters. If true, then unspecified parameters overwrite values specified by previous calls.
-**Args:**
-
- - `title`: The title of the alert, must be less than 64 characters long.
- - `text`: The text body of the alert.
- - `level`: The alert level to use, either: `INFO`, `WARN`, or `ERROR`.
- - `wait_duration`: The time to wait (in seconds) before sending another alert with this title.
----
-### method `Run.define_metric`
+### method display
```python
-define_metric(
- name: 'str',
- step_metric: 'str | wandb_metric.Metric | None' = None,
- step_sync: 'bool | None' = None,
- hidden: 'bool | None' = None,
- summary: 'str | None' = None,
- goal: 'str | None' = None,
- overwrite: 'bool | None' = None
-) → wandb_metric.Metric
+self,
+height: 'int' = 420,
+hidden: 'bool' = False
```
-Customize metrics logged with `wandb.Run.log()`.
+Display this run in Jupyter.
+##### Arguments
+- **height**:
+- **hidden**:
-**Args:**
-
- - `name`: The name of the metric to customize.
- - `step_metric`: The name of another metric to serve as the X-axis for this metric in automatically generated charts.
- - `step_sync`: Automatically insert the last value of step_metric into `wandb.Run.log()` if it is not provided explicitly. Defaults to True if step_metric is specified.
- - `hidden`: Hide this metric from automatic plots.
- - `summary`: Specify aggregate metrics added to summary. Supported aggregations include "min", "max", "mean", "last", "first", "best", "copy" and "none". "none" prevents a summary from being generated. "best" is used together with the goal parameter, "best" is deprecated and should not be used, use "min" or "max" instead. "copy" is deprecated and should not be used.
- - `goal`: Specify how to interpret the "best" summary type. Supported options are "minimize" and "maximize". "goal" is deprecated and should not be used, use "min" or "max" instead.
- - `overwrite`: If false, then this call is merged with previous `define_metric` calls for the same metric by using their values for any unspecified parameters. If true, then unspecified parameters overwrite values specified by previous calls.
-**Returns:**
- An object that represents this call but can otherwise be discarded.
-
----
-
-### method `Run.display`
+### method finish
```python
-display(height: 'int' = 420, hidden: 'bool' = False) → bool
+self,
+exit_code: 'int | None' = None,
+quiet: 'bool | None' = None
```
-Display this run in Jupyter.
-
----
-
-### method `Run.finish`
-
-```python
-finish(exit_code: 'int | None' = None, quiet: 'bool | None' = None) → None
-```
+Finish a run and upload any remaining data.
-Finish a run and upload any remaining data.
+Marks the completion of a W&B run and ensures all data is synced to the server.
+The run's final state is determined by its exit conditions and sync status.
-Marks the completion of a W&B run and ensures all data is synced to the server. The run's final state is determined by its exit conditions and sync status.
+Run States:
+- Running: Active run that is logging data and/or sending heartbeats.
+- Crashed: Run that stopped sending heartbeats unexpectedly.
+- Finished: Run completed successfully (`exit_code=0`) with all data synced.
+- Failed: Run completed with errors (`exit_code!=0`).
+- Killed: Run was forcibly stopped before it could finish.
-Run States:
-- Running: Active run that is logging data and/or sending heartbeats.
-- Crashed: Run that stopped sending heartbeats unexpectedly.
-- Finished: Run completed successfully (`exit_code=0`) with all data synced.
-- Failed: Run completed with errors (`exit_code!=0`).
-- Killed: Run was forcibly stopped before it could finish.
+##### Arguments
+- **exit_code**: Integer indicating the run's exit status. Use 0 for success, any other value marks the run as failed.
+- **quiet**: Deprecated. Configure logging verbosity using `wandb.Settings(quiet=...)`.
-**Args:**
-
- - `exit_code`: Integer indicating the run's exit status. Use 0 for success, any other value marks the run as failed.
- - `quiet`: Deprecated. Configure logging verbosity using `wandb.Settings(quiet=...)`.
----
-### method `Run.finish_artifact`
+### method finish_artifact
```python
-finish_artifact(
- artifact_or_path: 'Artifact | str',
- name: 'str | None' = None,
- type: 'str | None' = None,
- aliases: 'list[str] | None' = None,
- distributed_id: 'str | None' = None
-) → Artifact
+self,
+artifact_or_path: 'Artifact | str',
+name: 'str | None' = None,
+type: 'str | None' = None,
+aliases: 'list[str] | None' = None,
+distributed_id: 'str | None' = None
```
-Finishes a non-finalized artifact as output of a run.
-
-Subsequent "upserts" with the same distributed ID will result in a new version.
-
-
+Finishes a non-finalized artifact as output of a run.
-**Args:**
-
- - `artifact_or_path`: A path to the contents of this artifact, can be in the following forms:
- - `/local/directory`
- - `/local/directory/file.txt`
- - `s3://bucket/path` You can also pass an Artifact object created by calling `wandb.Artifact`.
- - `name`: An artifact name. May be prefixed with entity/project. Valid names can be in the following forms:
- - name:version
- - name:alias
- - digest This will default to the basename of the path prepended with the current run id if not specified.
- - `type`: The type of artifact to log, examples include `dataset`, `model`
- - `aliases`: Aliases to apply to this artifact, defaults to `["latest"]`
- - `distributed_id`: Unique string that all distributed jobs share. If None, defaults to the run's group name.
+Subsequent "upserts" with the same distributed ID will result in a new version.
+##### Arguments
-
-**Returns:**
- An `Artifact` object.
-
----
+- **artifact_or_path**: A path to the contents of this artifact,
+- **name**: An artifact name. May be prefixed with entity/project.
+- **type**: The type of artifact to log, examples include `dataset`, `model`
+- **aliases**: Aliases to apply to this artifact, defaults to `["latest"]`
+- **distributed_id**: Unique string that all distributed jobs share. If None, defaults to the run's group name.
-### method `Run.link_artifact`
+### method link_artifact
```python
-link_artifact(
- artifact: 'Artifact',
- target_path: 'str',
- aliases: 'list[str] | None' = None
-) → Artifact
+self,
+artifact: 'Artifact',
+target_path: 'str',
+aliases: 'list[str] | None' = None
```
-Link the artifact to a collection.
+Link the artifact to a collection.
-The term “link” refers to pointers that connect where W&B stores the artifact and where the artifact is accessible in the registry. W&B does not duplicate artifacts when you link an artifact to a collection.
+The term “link” refers to pointers that connect where W&B stores the
+artifact and where the artifact is accessible in the registry. W&B
+does not duplicate artifacts when you link an artifact to a collection.
-View linked artifacts in the Registry UI for the specified collection.
+View linked artifacts in the Registry UI for the specified collection.
+##### Arguments
+- **artifact**: The artifact object to link to the collection.
+- **target_path**: The path of the collection. Path consists of the prefix "wandb-registry-" along with the registry name and the collection name `wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}`.
+- **aliases**: Add one or more aliases to the linked artifact. The "latest" alias is automatically applied to the most recent artifact you link.
-**Args:**
-
- - `artifact`: The artifact object to link to the collection.
- - `target_path`: The path of the collection. Path consists of the prefix "wandb-registry-" along with the registry name and the collection name `wandb-registry-{REGISTRY_NAME}/{COLLECTION_NAME}`.
- - `aliases`: Add one or more aliases to the linked artifact. The "latest" alias is automatically applied to the most recent artifact you link.
-**Returns:**
- The linked artifact.
-
----
-
-### method `Run.link_model`
+### method link_model
```python
-link_model(
- path: 'StrPath',
- registered_model_name: 'str',
- name: 'str | None' = None,
- aliases: 'list[str] | None' = None
-) → Artifact | None
+self,
+path: 'StrPath',
+registered_model_name: 'str',
+name: 'str | None' = None,
+aliases: 'list[str] | None' = None
```
-Log a model artifact version and link it to a registered model in the model registry.
+Log a model artifact version and link it to a registered model in the model registry.
-Linked model versions are visible in the UI for the specified registered model.
+Linked model versions are visible in the UI for the specified registered model.
-This method will:
-- Check if 'name' model artifact has been logged. If so, use the artifact version that matches the files located at 'path' or log a new version. Otherwise log files under 'path' as a new model artifact, 'name' of type 'model'.
-- Check if registered model with name 'registered_model_name' exists in the 'model-registry' project. If not, create a new registered model with name 'registered_model_name'.
-- Link version of model artifact 'name' to registered model, 'registered_model_name'.
-- Attach aliases from 'aliases' list to the newly linked model artifact version.
+This method will:
+- Check if 'name' model artifact has been logged. If so, use the artifact version that matches the files
+located at 'path' or log a new version. Otherwise log files under 'path' as a new model artifact, 'name'
+of type 'model'.
+- Check if registered model with name 'registered_model_name' exists in the 'model-registry' project.
+If not, create a new registered model with name 'registered_model_name'.
+- Link version of model artifact 'name' to registered model, 'registered_model_name'.
+- Attach aliases from 'aliases' list to the newly linked model artifact version.
+##### Arguments
+- **path**: (str) A path to the contents of this model, can be in the
+- **registered_model_name**: The name of the registered model that the model is to be linked to. A registered model is a collection of model versions linked to the model registry, typically representing a team's specific ML Task. The entity that this registered model belongs to will be derived from the run.
+- **name**: The name of the model artifact that files in 'path' will be logged to. This will default to the basename of the path prepended with the current run id if not specified.
+- **aliases**: Aliases that will only be applied on this linked artifact inside the registered model. The alias "latest" will always be applied to the latest version of an artifact that is linked.
-**Args:**
-
- - `path`: (str) A path to the contents of this model, can be in the following forms:
- - `/local/directory`
- - `/local/directory/file.txt`
- - `s3://bucket/path`
- - `registered_model_name`: The name of the registered model that the model is to be linked to. A registered model is a collection of model versions linked to the model registry, typically representing a team's specific ML Task. The entity that this registered model belongs to will be derived from the run.
- - `name`: The name of the model artifact that files in 'path' will be logged to. This will default to the basename of the path prepended with the current run id if not specified.
- - `aliases`: Aliases that will only be applied on this linked artifact inside the registered model. The alias "latest" will always be applied to the latest version of an artifact that is linked.
+##### Raises
+- **AssertionError**: If registered_model_name is a path or if model artifact 'name' is of a type that does not contain the substring 'model'.
+- **ValueError**: If name has invalid special characters.
-**Raises:**
-
- - `AssertionError`: If registered_model_name is a path or if model artifact 'name' is of a type that does not contain the substring 'model'.
- - `ValueError`: If name has invalid special characters.
-
-
-**Returns:**
- The linked artifact if linking was successful, otherwise `None`.
-
----
-
-### method `Run.log`
+### method log
```python
-log(
- data: 'dict[str, Any]',
- step: 'int | None' = None,
- commit: 'bool | None' = None
-) → None
+self,
+data: 'dict[str, Any]',
+step: 'int | None' = None,
+commit: 'bool | None' = None
```
-Upload run data.
+Upload run data.
-Use `log` to log data from runs, such as scalars, images, video, histograms, plots, and tables. See [Log objects and media](https://docs.wandb.ai/models/track/log) for code snippets, best practices, and more.
+Use `log` to log data from runs, such as scalars, images, video,
+histograms, plots, and tables. See [Log objects and media](https://docs.wandb.ai/models/track/log) for
+code snippets, best practices, and more.
-Basic usage:
+Basic usage:
```python
import wandb
with wandb.init() as run:
- run.log({"train-loss": 0.5, "accuracy": 0.9})
-```
+ run.log({"train-loss": 0.5, "accuracy": 0.9})
+```
-The previous code snippet saves the loss and accuracy to the run's history and updates the summary values for these metrics.
+The previous code snippet saves the loss and accuracy to the run's
+history and updates the summary values for these metrics.
-Visualize logged data in a workspace at [wandb.ai](https://wandb.ai), or locally on a [self-hosted instance](https://docs.wandb.ai/platform/hosting) of the W&B app, or export data to visualize and explore locally, such as in a Jupyter notebook, with the [Public API](https://docs.wandb.ai/models/track/public-api-guide).
+Visualize logged data in a workspace at [wandb.ai](https://wandb.ai),
+or locally on a [self-hosted instance](https://docs.wandb.ai/platform/hosting)
+of the W&B app, or export data to visualize and explore locally, such as in a
+Jupyter notebook, with the [Public API](https://docs.wandb.ai/models/track/public-api-guide).
-Logged values don't have to be scalars. You can log any [W&B supported Data Type](https://docs.wandb.ai/models/ref/python/data-types) such as images, audio, video, and more. For example, you can use `wandb.Table` to log structured data. See [Log tables, visualize and query data](https://docs.wandb.ai/models/tables/tables-walkthrough) tutorial for more details.
+Logged values don't have to be scalars. You can log any
+[W&B supported Data Type](https://docs.wandb.ai/models/ref/python/data-types)
+such as images, audio, video, and more. For example, you can use
+`wandb.Table` to log structured data. See
+[Log tables, visualize and query data](https://docs.wandb.ai/models/tables/tables-walkthrough)
+tutorial for more details.
-W&B organizes metrics with a forward slash (`/`) in their name into sections named using the text before the final slash. For example, the following results in two sections named "train" and "validate":
+W&B organizes metrics with a forward slash (`/`) in their name
+into sections named using the text before the final slash. For example,
+the following results in two sections named "train" and "validate":
```python
with wandb.init() as run:
- # Log metrics in the "train" section.
- run.log(
- {
- "train/accuracy": 0.9,
- "train/loss": 30,
- "validate/accuracy": 0.8,
- "validate/loss": 20,
- }
- )
-```
+ # Log metrics in the "train" section.
+ run.log(
+ {
+ "train/accuracy": 0.9,
+ "train/loss": 30,
+ "validate/accuracy": 0.8,
+ "validate/loss": 20,
+ }
+ )
+```
-Only one level of nesting is supported; `run.log({"a/b/c": 1})` produces a section named "a".
+Only one level of nesting is supported; `run.log({"a/b/c": 1})`
+produces a section named "a".
-`run.log()` is not intended to be called more than a few times per second. For optimal performance, limit your logging to once every N iterations, or collect data over multiple iterations and log it in a single step.
+`run.log()` is not intended to be called more than a few times per second.
+For optimal performance, limit your logging to once every N iterations,
+or collect data over multiple iterations and log it in a single step.
-By default, each call to `log` creates a new "step". The step must always increase, and it is not possible to log to a previous step. You can use any metric as the X axis in charts. See [Custom log axes](https://docs.wandb.ai/models/track/log/customize-logging-axes) for more details.
+By default, each call to `log` creates a new "step".
+The step must always increase, and it is not possible to log
+to a previous step. You can use any metric as the X axis in charts.
+See [Custom log axes](https://docs.wandb.ai/models/track/log/customize-logging-axes)
+for more details.
-In many cases, it is better to treat the W&B step like you'd treat a timestamp rather than a training step.
+In many cases, it is better to treat the W&B step like
+you'd treat a timestamp rather than a training step.
```python
with wandb.init() as run:
- # Example: log an "epoch" metric for use as an X axis.
- run.log({"epoch": 40, "train-loss": 0.5})
-```
+ # Example: log an "epoch" metric for use as an X axis.
+ run.log({"epoch": 40, "train-loss": 0.5})
+```
-It is possible to use multiple `wandb.Run.log()` invocations to log to the same step with the `step` and `commit` parameters. The following are all equivalent:
+It is possible to use multiple `wandb.Run.log()` invocations to log to
+the same step with the `step` and `commit` parameters.
+The following are all equivalent:
```python
with wandb.init() as run:
- # Normal usage:
- run.log({"train-loss": 0.5, "accuracy": 0.8})
- run.log({"train-loss": 0.4, "accuracy": 0.9})
+ # Normal usage:
+ run.log({"train-loss": 0.5, "accuracy": 0.8})
+ run.log({"train-loss": 0.4, "accuracy": 0.9})
+
+ # Implicit step without auto-incrementing:
+ run.log({"train-loss": 0.5}, commit=False)
+ run.log({"accuracy": 0.8})
+ run.log({"train-loss": 0.4}, commit=False)
+ run.log({"accuracy": 0.9})
+
+ # Explicit step:
+ run.log({"train-loss": 0.5}, step=current_step)
+ run.log({"accuracy": 0.8}, step=current_step)
+ current_step += 1
+ run.log({"train-loss": 0.4}, step=current_step)
+ run.log({"accuracy": 0.9}, step=current_step, commit=True)
+```
- # Implicit step without auto-incrementing:
- run.log({"train-loss": 0.5}, commit=False)
- run.log({"accuracy": 0.8})
- run.log({"train-loss": 0.4}, commit=False)
- run.log({"accuracy": 0.9})
+##### Arguments
- # Explicit step:
- run.log({"train-loss": 0.5}, step=current_step)
- run.log({"accuracy": 0.8}, step=current_step)
- current_step += 1
- run.log({"train-loss": 0.4}, step=current_step)
- run.log({"accuracy": 0.9}, step=current_step, commit=True)
-```
+- **data**: A `dict` with `str` keys and values that are serializable
+- **step**: The step number to log. If `None`, then an implicit auto-incrementing step is used. See the notes in the description.
+- **commit**: If true, finalize and upload the step. If false, then accumulate data for the step. See the notes in the description. If `step` is `None`, then the default is `commit=True`; otherwise, the default is `commit=False`.
+##### Raises
-**Args:**
-
- - `data`: A `dict` with `str` keys and values that are serializable
- - `Python objects including`: `int`, `float` and `string`; any of the `wandb.data_types`; lists, tuples and NumPy arrays of serializable Python objects; other `dict`s of this structure.
- - `step`: The step number to log. If `None`, then an implicit auto-incrementing step is used. See the notes in the description.
- - `commit`: If true, finalize and upload the step. If false, then accumulate data for the step. See the notes in the description. If `step` is `None`, then the default is `commit=True`; otherwise, the default is `commit=False`.
+- **wandb.Error**: If called before `wandb.init()`.
+- **ValueError**: If invalid data is passed.
+##### Examples
-**Examples:**
- For more and more detailed examples, see [our guides to logging](https://docs.wandb.ai/models/track/log).
+For more and more detailed examples, see
+[our guides to logging](https://docs.wandb.ai/models/track/log).
-Basic usage
+Basic usage
```python
import wandb
with wandb.init() as run:
run.log({"train-loss": 0.5, "accuracy": 0.9
-```
+```
-Incremental logging
+Incremental logging
```python
import wandb
@@ -606,9 +518,9 @@ with wandb.init() as run:
run.log({"loss": 0.2}, commit=False)
# Somewhere else when I'm ready to report this step:
run.log({"accuracy": 0.8})
-```
+```
-Histogram
+Histogram
```python
import numpy as np
@@ -618,9 +530,9 @@ import wandb
gradients = np.random.randn(100, 100)
with wandb.init() as run:
run.log({"gradients": wandb.Histogram(gradients)})
-```
+```
-Image from NumPy
+Image from NumPy
```python
import numpy as np
@@ -629,13 +541,13 @@ import wandb
with wandb.init() as run:
examples = []
for i in range(3):
- pixels = np.random.randint(low=0, high=256, size=(100, 100, 3))
- image = wandb.Image(pixels, caption=f"random field {i}")
- examples.append(image)
+ pixels = np.random.randint(low=0, high=256, size=(100, 100, 3))
+ image = wandb.Image(pixels, caption=f"random field {i}")
+ examples.append(image)
run.log({"examples": examples})
-```
+```
-Image from PIL
+Image from PIL
```python
import numpy as np
@@ -645,19 +557,19 @@ import wandb
with wandb.init() as run:
examples = []
for i in range(3):
- pixels = np.random.randint(
- low=0,
- high=256,
- size=(100, 100, 3),
- dtype=np.uint8,
- )
- pil_image = PILImage.fromarray(pixels, mode="RGB")
- image = wandb.Image(pil_image, caption=f"random field {i}")
- examples.append(image)
+ pixels = np.random.randint(
+ low=0,
+ high=256,
+ size=(100, 100, 3),
+ dtype=np.uint8,
+ )
+ pil_image = PILImage.fromarray(pixels, mode="RGB")
+ image = wandb.Image(pil_image, caption=f"random field {i}")
+ examples.append(image)
run.log({"examples": examples})
-```
+```
-Video from NumPy
+Video from NumPy
```python
import numpy as np
@@ -666,15 +578,15 @@ import wandb
with wandb.init() as run:
# axes are (time, channel, height, width)
frames = np.random.randint(
- low=0,
- high=256,
- size=(10, 3, 100, 100),
- dtype=np.uint8,
+ low=0,
+ high=256,
+ size=(10, 3, 100, 100),
+ dtype=np.uint8,
)
run.log({"video": wandb.Video(frames, fps=4)})
-```
+```
-Matplotlib plot
+Matplotlib plot
```python
from matplotlib import pyplot as plt
@@ -687,416 +599,315 @@ with wandb.init() as run:
y = x * x
ax.plot(x, y) # plot y = x^2
run.log({"chart": fig})
-```
+```
-PR Curve
+PR Curve
```python
import wandb
with wandb.init() as run:
run.log({"pr": wandb.plot.pr_curve(y_test, y_probas, labels)})
-```
+```
-3D Object
+3D Object
```python
import wandb
with wandb.init() as run:
run.log(
- {
- "generated_samples": [
- wandb.Object3D(open("sample.obj")),
- wandb.Object3D(open("sample.gltf")),
- wandb.Object3D(open("sample.glb")),
- ]
- }
+ {
+ "generated_samples": [
+ wandb.Object3D(open("sample.obj")),
+ wandb.Object3D(open("sample.gltf")),
+ wandb.Object3D(open("sample.glb")),
+ ]
+ }
)
-```
-
-
-
-**Raises:**
-
- - `wandb.Error`: If called before `wandb.init()`.
- - `ValueError`: If invalid data is passed.
-
----
+```
-### method `Run.log_artifact`
+### method log_artifact
```python
-log_artifact(
- artifact_or_path: 'Artifact | StrPath',
- name: 'str | None' = None,
- type: 'str | None' = None,
- aliases: 'list[str] | None' = None,
- tags: 'list[str] | None' = None
-) → Artifact
+self,
+artifact_or_path: 'Artifact | StrPath',
+name: 'str | None' = None,
+type: 'str | None' = None,
+aliases: 'list[str] | None' = None,
+tags: 'list[str] | None' = None
```
-Declare an artifact as an output of a run.
+Declare an artifact as an output of a run.
+##### Arguments
+- **artifact_or_path**: (str or Artifact) A path to the contents of this artifact,
+- **name**: (str, optional) An artifact name. Valid names can be in the following forms:
+- **type**: (str) The type of artifact to log, examples include `dataset`, `model`
+- **aliases**: (list, optional) Aliases to apply to this artifact, defaults to `["latest"]`
+- **tags**: (list, optional) Tags to apply to this artifact, if any.
-**Args:**
-
- - `artifact_or_path`: (str or Artifact) A path to the contents of this artifact, can be in the following forms:
- - `/local/directory`
- - `/local/directory/file.txt`
- - `s3://bucket/path` You can also pass an Artifact object created by calling `wandb.Artifact`.
- - `name`: (str, optional) An artifact name. Valid names can be in the following forms:
- - name:version
- - name:alias
- - digest This will default to the basename of the path prepended with the current run id if not specified.
- - `type`: (str) The type of artifact to log, examples include `dataset`, `model`
- - `aliases`: (list, optional) Aliases to apply to this artifact, defaults to `["latest"]`
- - `tags`: (list, optional) Tags to apply to this artifact, if any.
-**Returns:**
- An `Artifact` object.
-
----
-
-### method `Run.log_code`
+### method log_code
```python
-log_code(
- root: 'str | None' = '.',
- name: 'str | None' = None,
- include_fn: 'Callable[[str, str], bool] | Callable[[str], bool]' = ,
- exclude_fn: 'Callable[[str, str], bool] | Callable[[str], bool]' =
-) → Artifact | None
+self,
+root: 'str | None' = '.',
+name: 'str | None' = None,
+include_fn: 'Callable[[str, str], bool] | Callable[[str], bool]' = _is_py_requirements_or_dockerfile,
+exclude_fn: 'Callable[[str, str], bool] | Callable[[str], bool]' = exclude_wandb_fn
```
-Save the current state of your code to a W&B Artifact.
+Save the current state of your code to a W&B Artifact.
-By default, it walks the current directory and logs all files that end with `.py`.
+By default, it walks the current directory and logs all files that end with `.py`.
+##### Arguments
+- **root**: The relative (to `os.getcwd()`) or absolute path to recursively find code from.
+- **name**: (str, optional) The name of our code artifact. By default, we'll name the artifact `source-$PROJECT_ID-$ENTRYPOINT_RELPATH`. There may be scenarios where you want many runs to share the same artifact. Specifying name allows you to achieve that.
+- **include_fn**: A callable that accepts a file path and (optionally) root path and returns True when it should be included and False otherwise. This
+- **exclude_fn**: A callable that accepts a file path and (optionally) root path and returns `True` when it should be excluded and `False` otherwise. This defaults to a function that excludes all files within `/.wandb/` and `/wandb/` directories.
-**Args:**
-
- - `root`: The relative (to `os.getcwd()`) or absolute path to recursively find code from.
- - `name`: (str, optional) The name of our code artifact. By default, we'll name the artifact `source-$PROJECT_ID-$ENTRYPOINT_RELPATH`. There may be scenarios where you want many runs to share the same artifact. Specifying name allows you to achieve that.
- - `include_fn`: A callable that accepts a file path and (optionally) root path and returns True when it should be included and False otherwise. This
- - `defaults to `lambda path, root`: path.endswith(".py")`.
- - `exclude_fn`: A callable that accepts a file path and (optionally) root path and returns `True` when it should be excluded and `False` otherwise. This defaults to a function that excludes all files within `/.wandb/` and `/wandb/` directories.
-**Examples:**
- Basic usage
+##### Examples
+
+Basic usage
```python
import wandb
with wandb.init() as run:
run.log_code()
-```
+```
-Advanced usage
+Advanced usage
```python
import wandb
with wandb.init() as run:
run.log_code(
- root="../",
- include_fn=lambda path: path.endswith(".py") or path.endswith(".ipynb"),
- exclude_fn=lambda path, root: os.path.relpath(path, root).startswith(
- "cache/"
- ),
+ root="../",
+ include_fn=lambda path: path.endswith(".py") or path.endswith(".ipynb"),
+ exclude_fn=lambda path, root: os.path.relpath(path, root).startswith(
+ "cache/"
+ ),
)
-```
-
-
-
-**Returns:**
- An `Artifact` object if code was logged
-
----
+```
-### method `Run.log_model`
+### method log_model
```python
-log_model(
- path: 'StrPath',
- name: 'str | None' = None,
- aliases: 'list[str] | None' = None
-) → None
+self,
+path: 'StrPath',
+name: 'str | None' = None,
+aliases: 'list[str] | None' = None
```
-Logs a model artifact containing the contents inside the 'path' to a run and marks it as an output to this run.
-
-The name of model artifact can only contain alphanumeric characters, underscores, and hyphens.
+Logs a model artifact containing the contents inside the 'path' to a run and marks it as an output to this run.
+The name of model artifact can only contain alphanumeric characters,
+underscores, and hyphens.
+##### Arguments
-**Args:**
-
- - `path`: (str) A path to the contents of this model, can be in the following forms:
- - `/local/directory`
- - `/local/directory/file.txt`
- - `s3://bucket/path`
- - `name`: A name to assign to the model artifact that the file contents will be added to. This will default to the basename of the path prepended with the current run id if not specified.
- - `aliases`: Aliases to apply to the created model artifact, defaults to `["latest"]`
+- **path**: (str) A path to the contents of this model,
+- **name**: A name to assign to the model artifact that the file contents will be added to. This will default to the basename of the path prepended with the current run id if not specified.
+- **aliases**: Aliases to apply to the created model artifact, defaults to `["latest"]`
+##### Raises
-**Raises:**
-
- - `ValueError`: If name has invalid special characters.
+- **ValueError**: If name has invalid special characters.
+### method mark_preempting
-**Returns:**
- None
+```python
+self
+```
----
+Mark this run as preempting.
-### method `Run.mark_preempting`
+Also tells the internal process to immediately report this to server.
-```python
-mark_preempting() → None
-```
-Mark this run as preempting.
-Also tells the internal process to immediately report this to server.
----
-### method `Run.pin_config_keys`
+### method pin_config_keys
```python
-pin_config_keys(keys: 'Sequence[str]' = ()) → None
+self,
+keys: 'Sequence[str]' = ()
```
-Pin config keys to display in the References section on Run Overview.
+Pin config keys to display in the References section on Run Overview.
-Pinned keys appear prominently above Notes on the Run Overview page. String values are rendered as markdown; non-strings are rendered as plain text. Calling this again replaces the previously pinned list.
+Pinned keys appear prominently above Notes on the Run Overview page.
+String values are rendered as markdown; non-strings are rendered as
+plain text. Calling this again replaces the previously pinned list.
+##### Arguments
+- **keys**: Config key names to pin, matching keys set via ``run.config``. These are exact key strings (dots and slashes are treated literally, not as path separators). Order is preserved and determines display order.
-**Args:**
-
- - `keys`: Config key names to pin, matching keys set via ``run.config``. These are exact key strings (dots and slashes are treated literally, not as path separators). Order is preserved and determines display order.
----
-### method `Run.restore`
+### method restore
```python
-restore(
- name: 'str',
- run_path: 'str | None' = None,
- replace: 'bool' = False,
- root: 'str | None' = None
-) → None | TextIO
+self,
+name: 'str',
+run_path: 'str | None' = None,
+replace: 'bool' = False,
+root: 'str | None' = None
```
-Download the specified file from cloud storage.
+Download the specified file from cloud storage.
-File is placed into the current directory or run directory. By default, will only download the file if it doesn't already exist.
+File is placed into the current directory or run directory.
+By default, will only download the file if it doesn't already exist.
+##### Arguments
+- **name**: The name of the file.
+- **run_path**: Optional path to a run to pull files from, i.e. `username/project_name/run_id` if wandb.init has not been called, this is required.
+- **replace**: Whether to download the file even if it already exists locally
+- **root**: The directory to download the file to. Defaults to the current directory or the run directory if wandb.init was called.
-**Args:**
-
- - `name`: The name of the file.
- - `run_path`: Optional path to a run to pull files from, i.e. `username/project_name/run_id` if wandb.init has not been called, this is required.
- - `replace`: Whether to download the file even if it already exists locally
- - `root`: The directory to download the file to. Defaults to the current directory or the run directory if wandb.init was called.
+##### Raises
+- **CommError**: If W&B can't connect to the W&B backend.
+- **ValueError**: If the file is not found or can't find run_path.
-**Returns:**
- None if it can't find the file, otherwise a file object open for reading.
-
-
-**Raises:**
-
- - `CommError`: If W&B can't connect to the W&B backend.
- - `ValueError`: If the file is not found or can't find run_path.
-
----
-
-### method `Run.save`
+### method save
```python
-save(
- glob_str: 'str | os.PathLike',
- base_path: 'str | os.PathLike | None' = None,
- policy: 'PolicyName' = 'live'
-) → bool | list[str]
+self,
+glob_str: 'str | os.PathLike',
+base_path: 'str | os.PathLike | None' = None,
+policy: 'PolicyName' = 'live'
```
-Sync one or more files to W&B.
-
-Relative paths are relative to the current working directory.
+Sync one or more files to W&B.
-A Unix glob, such as "myfiles/*", is expanded at the time `save` is called regardless of the `policy`. In particular, new files are not picked up automatically.
+Relative paths are relative to the current working directory.
-A `base_path` may be provided to control the directory structure of uploaded files. It should be a prefix of `glob_str`, and the directory structure beneath it is preserved.
+A Unix glob, such as "myfiles/*", is expanded at the time `save` is
+called regardless of the `policy`. In particular, new files are not
+picked up automatically.
-When given an absolute path or glob and no `base_path`, one directory level is preserved as in the example above.
+A `base_path` may be provided to control the directory structure of
+uploaded files. It should be a prefix of `glob_str`, and the directory
+structure beneath it is preserved.
-Files are automatically deduplicated: calling `save()` multiple times on the same file without modifications will not re-upload it.
+When given an absolute path or glob and no `base_path`, one
+directory level is preserved as in the example above.
+Files are automatically deduplicated: calling `save()` multiple times
+on the same file without modifications will not re-upload it.
+##### Arguments
-**Args:**
-
- - `glob_str`: A relative or absolute path or Unix glob.
- - `base_path`: A path to use to infer a directory structure; see examples.
- - `policy`: One of `live`, `now`, or `end`.
- - live: upload the file as it changes, overwriting the previous version
- - now: upload the file once now
- - end: upload file when the run ends
+- **glob_str**: A relative or absolute path or Unix glob.
+- **base_path**: A path to use to infer a directory structure; see examples.
+- **policy**: One of `live`, `now`, or `end`.
-**Returns:**
- Paths to the symlinks created for the matched files.
-For historical reasons, this may return a boolean in legacy code.
+### method status
```python
-import wandb
-
-run = wandb.init()
-
-run.save("these/are/myfiles/*")
-# => Saves files in a "these/are/myfiles/" folder in the run.
-
-run.save("these/are/myfiles/*", base_path="these")
-# => Saves files in an "are/myfiles/" folder in the run.
+self
+```
-run.save("/Users/username/Documents/run123/*.txt")
-# => Saves files in a "run123/" folder in the run. See note below.
+Get sync info from the internal backend, about the current run's sync status.
-run.save("/Users/username/Documents/run123/*.txt", base_path="/Users")
-# => Saves files in a "username/Documents/run123/" folder in the run.
-run.save("files/*/saveme.txt")
-# => Saves each "saveme.txt" file in an appropriate subdirectory
-# of "files/".
-# Explicitly finish the run since a context manager is not used.
-run.finish()
-```
----
-### method `Run.status`
+### method unwatch
```python
-status() → RunStatus
+self,
+models: 'torch.nn.Module | Sequence[torch.nn.Module] | None' = None
```
-Get sync info from the internal backend, about the current run's sync status.
-
----
+Remove pytorch model topology, gradient and parameter hooks.
+##### Arguments
-### method `Run.unwatch`
+- **models**: Optional list of pytorch models that have had watch called on them.
-```python
-unwatch(
- models: 'torch.nn.Module | Sequence[torch.nn.Module] | None' = None
-) → None
-```
-Remove pytorch model topology, gradient and parameter hooks.
-
-**Args:**
-
- - `models`: Optional list of pytorch models that have had watch called on them.
-
----
-
-### method `Run.upsert_artifact`
+### method upsert_artifact
```python
-upsert_artifact(
- artifact_or_path: 'Artifact | str',
- name: 'str | None' = None,
- type: 'str | None' = None,
- aliases: 'list[str] | None' = None,
- distributed_id: 'str | None' = None
-) → Artifact
+self,
+artifact_or_path: 'Artifact | str',
+name: 'str | None' = None,
+type: 'str | None' = None,
+aliases: 'list[str] | None' = None,
+distributed_id: 'str | None' = None
```
-Declare (or append to) a non-finalized artifact as output of a run.
-
-Note that you must call run.finish_artifact() to finalize the artifact. This is useful when distributed jobs need to all contribute to the same artifact.
-
+Declare (or append to) a non-finalized artifact as output of a run.
+Note that you must call run.finish_artifact() to finalize the artifact.
+This is useful when distributed jobs need to all contribute to the same artifact.
-**Args:**
-
- - `artifact_or_path`: A path to the contents of this artifact, can be in the following forms:
- - `/local/directory`
- - `/local/directory/file.txt`
- - `s3://bucket/path`
- - `name`: An artifact name. May be prefixed with "entity/project". Defaults to the basename of the path prepended with the current run ID if not specified. Valid names can be in the following forms:
- - name:version
- - name:alias
- - digest
- - `type`: The type of artifact to log. Common examples include `dataset`, `model`.
- - `aliases`: Aliases to apply to this artifact, defaults to `["latest"]`.
- - `distributed_id`: Unique string that all distributed jobs share. If None, defaults to the run's group name.
+##### Arguments
+- **artifact_or_path**: A path to the contents of this artifact,
+- **name**: An artifact name. May be prefixed with "entity/project". Defaults to the basename of the path prepended with the current run ID
+- **type**: The type of artifact to log. Common examples include `dataset`, `model`.
+- **aliases**: Aliases to apply to this artifact, defaults to `["latest"]`.
+- **distributed_id**: Unique string that all distributed jobs share. If None, defaults to the run's group name.
-**Returns:**
- An `Artifact` object.
----
-### method `Run.use_artifact`
+### method use_artifact
```python
-use_artifact(
- artifact_or_name: 'str | Artifact',
- type: 'str | None' = None,
- aliases: 'list[str] | None' = None,
- use_as: 'str | None' = None
-) → Artifact
+self,
+artifact_or_name: 'str | Artifact',
+type: 'str | None' = None,
+aliases: 'list[str] | None' = None,
+use_as: 'str | None' = None
```
-Declare an artifact as an input to a run.
-
-Call `download` or `file` on the returned object to get the contents locally.
-
+Declare an artifact as an input to a run.
+Call `download` or `file` on the returned object to get the contents locally.
-**Args:**
-
- - `artifact_or_name`: The name of the artifact to use. May be prefixed with the name of the project the artifact was logged to ("entity" or "entity/project"). If no entity is specified in the name, the Run or API setting's entity is used. Valid names can be in the following forms
- - name:version
- - name:alias
- - `type`: The type of artifact to use.
- - `aliases`: Aliases to apply to this artifact
- - `use_as`: This argument is deprecated and does nothing.
+##### Arguments
+- **artifact_or_name**: The name of the artifact to use. May be prefixed with the name of the project the artifact was logged to ("entity" or "entity/project"). If no entity is specified in the name, the Run or API setting's entity is used. Valid names can be in the following forms
+- **type**: The type of artifact to use.
+- **aliases**: Aliases to apply to this artifact
+- **use_as**: This argument is deprecated and does nothing.
-**Returns:**
- An `Artifact` object.
+##### Examples
-**Examples:**
- ```python
+```python
import wandb
run = wandb.init(project="")
@@ -1119,90 +930,80 @@ artifact_d = run.use_artifact(
# Explicitly finish the run since a context manager is not used.
run.finish()
-```
-
----
+```
-### method `Run.use_model`
+### method use_model
```python
-use_model(name: 'str') → FilePathStr
+self,
+name: 'str'
```
-Download the files logged in a model artifact 'name'.
-
-
+Download the files logged in a model artifact 'name'.
-**Args:**
-
- - `name`: A model artifact name. 'name' must match the name of an existing logged model artifact. May be prefixed with `entity/project/`. Valid names can be in the following forms
- - model_artifact_name:version
- - model_artifact_name:alias
+##### Arguments
+- **name**: A model artifact name. 'name' must match the name of an existing logged model artifact. May be prefixed with `entity/project/`. Valid names can be in the following forms
-**Returns:**
-
- - `path` (str): Path to downloaded model artifact file(s).
+##### Raises
+- **AssertionError**: If model artifact 'name' is of a type that does not contain the substring 'model'.
-**Raises:**
-
- - `AssertionError`: If model artifact 'name' is of a type that does not contain the substring 'model'.
-
----
-
-### method `Run.watch`
+### method watch
```python
-watch(
- models: 'torch.nn.Module | Sequence[torch.nn.Module]',
- criterion: 'torch.F | None' = None,
- log: "Literal['gradients', 'parameters', 'all'] | None" = 'gradients',
- log_freq: 'int' = 1000,
- idx: 'int | None' = None,
- log_graph: 'bool' = False
-) → None
+self,
+models: 'torch.nn.Module | Sequence[torch.nn.Module]',
+criterion: 'torch.F | None' = None,
+log: "Literal['gradients', 'parameters', 'all'] | None" = 'gradients',
+log_freq: 'int' = 1000,
+idx: 'int | None' = None,
+log_graph: 'bool' = False
```
-Hook into given PyTorch model to monitor gradients and the model's computational graph.
+Hook into given PyTorch model to monitor gradients and the model's computational graph.
-This function can track parameters, gradients, or both during training.
+This function can track parameters, gradients, or both during training.
+##### Arguments
+- **models**: A single model or a sequence of models to be monitored.
+- **criterion**: The loss function being optimized (optional).
+- **log**: Specifies whether to log "gradients", "parameters", or "all". Set to None to disable logging. (default="gradients").
+- **log_freq**: Frequency (in batches) to log gradients and parameters. (default=1000)
+- **idx**: Index used when tracking multiple models with `wandb.watch`. (default=None)
+- **log_graph**: Whether to log the model's computational graph. (default=False)
-**Args:**
-
- - `models`: A single model or a sequence of models to be monitored.
- - `criterion`: The loss function being optimized (optional).
- - `log`: Specifies whether to log "gradients", "parameters", or "all". Set to None to disable logging. (default="gradients").
- - `log_freq`: Frequency (in batches) to log gradients and parameters. (default=1000)
- - `idx`: Index used when tracking multiple models with `wandb.watch`. (default=None)
- - `log_graph`: Whether to log the model's computational graph. (default=False)
+##### Raises
+- **ValueError**: If `wandb.init()` has not been called or if any of the models are not instances of `torch.nn.Module`.
-**Raises:**
- ValueError: If `wandb.init()` has not been called or if any of the models are not instances of `torch.nn.Module`.
----
-
-### method `Run.write_logs`
+### method write_logs
```python
-write_logs(text: 'str') → None
+self,
+text: 'str'
```
-Write text to the run's Logs tab.
+Write text to the run's Logs tab.
+
+Use `write_logs` to directly write text to the Logs tab instead of
+relying on automatic stdout/stderr capture. Calls after the run has
+finished are silently ignored.
+
+Consider using the `capture_loggers` setting which integrates with
+Python's `logging` module.
+
+##### Arguments
+
+- **text**: The text to write. A trailing newline is added if not present.
-Use `write_logs` to directly write text to the Logs tab instead of relying on automatic stdout/stderr capture. Calls after the run has finished are silently ignored.
-Consider using the `capture_loggers` setting which integrates with Python's `logging` module.
-**Args:**
-
- - `text`: The text to write. A trailing newline is added if not present.
diff --git a/models/ref/python/experiments/settings.mdx b/models/ref/python/experiments/settings.mdx
index 4e212901b3..ca48657a63 100644
--- a/models/ref/python/experiments/settings.mdx
+++ b/models/ref/python/experiments/settings.mdx
@@ -1,15 +1,176 @@
---
title: Settings
-namespace: python_sdk_actions
-python_object_type: class
+kind: class
+namespace: wandb.sdk.wandb_settings
---
+
import { GitHubLink } from '/snippets/_includes/github-source-link.mdx';
-
+
+
+
+
+```python
+*,
+allow_media_symlink: bool = False,
+allow_offline_artifacts: bool = True,
+allow_val_change: bool = False,
+anonymous: object = object(),
+api_key: str | None = None,
+azure_account_url_to_access_key: dict[str, str] | None = None,
+app_url_override: str | None = None,
+base_url: str = 'https://api.wandb.ai',
+code_dir: str | None = None,
+config_paths: collections.abc.Sequence[str] | None = None,
+console: Literal['auto', 'off', 'wrap', 'redirect', 'wrap_raw', 'wrap_emu'] = 'auto',
+console_multipart: bool = False,
+console_chunk_max_bytes: int = 0,
+console_chunk_max_seconds: int = 0,
+capture_loggers: dict[str, str] | None = None,
+credentials_file: str = ,
+disable_code: bool = False,
+disable_git: bool = False,
+disable_git_fork_point: bool = True,
+disable_job_creation: bool = True,
+docker: str | None = None,
+email: str | None = None,
+entity: str | None = None,
+organization: str | None = None,
+force: bool = False,
+fork_from: wandb.sdk.lib.run_moment.RunMoment | None = None,
+git_commit: str | None = None,
+git_remote: str = 'origin',
+git_remote_url: str | None = None,
+git_root: str | None = None,
+heartbeat_seconds: int = 30,
+host: str | None = None,
+http_proxy: str | None = None,
+https_proxy: str | None = None,
+identity_token_file: str | None = None,
+ignore_globs: collections.abc.Sequence[str] = (),
+init_timeout: float = 90.0,
+finish_timeout: float = 0.0,
+finish_timeout_raises: bool = False,
+insecure_disable_ssl: bool = False,
+job_name: str | None = None,
+job_source: Optional[Literal['repo', 'artifact', 'image']] = None,
+label_disable: bool = False,
+launch: bool = False,
+launch_config_path: str | None = None,
+login_timeout: float | None = None,
+mode: Literal['online', 'offline', 'shared', 'disabled', 'dryrun', 'run'] = 'online',
+notebook_name: str | None = None,
+program: str | None = None,
+program_abspath: str | None = None,
+program_relpath: str | None = None,
+project: str | None = None,
+quiet: bool = False,
+reinit: Union[Literal['default', 'return_previous', 'finish_previous', 'create_new'], bool] = 'default',
+relogin: bool = False,
+resume: Optional[Literal['allow', 'must', 'never', 'auto']] = None,
+resume_from: wandb.sdk.lib.run_moment.RunMoment | None = None,
+resumed: bool = False,
+root_dir: str = ,
+run_group: str | None = None,
+run_id: str | None = None,
+run_job_type: str | None = None,
+run_name: str | None = None,
+run_notes: str | None = None,
+run_tags: tuple[str, ...] | None = None,
+sagemaker_disable: bool = False,
+save_code: bool | None = None,
+settings_system: str | None = None,
+stop_fn: collections.abc.Callable[[], None] | None = None,
+max_end_of_run_history_metrics: int = 10,
+max_end_of_run_summary_metrics: int = 10,
+show_colors: bool | None = None,
+show_emoji: bool | None = None,
+show_errors: bool = True,
+show_info: bool = True,
+show_warnings: bool = True,
+silent: bool = False,
+start_method: str | None = None,
+stop_on_fatal_error: bool = False,
+strict: bool | None = None,
+summary_timeout: int = 60,
+summary_warnings: int = 5,
+sweep_id: str | None = None,
+sweep_param_path: str | None = None,
+symlink: bool = ,
+sync_tensorboard: bool | None = None,
+table_raise_on_max_row_limit_exceeded: bool = False,
+use_dot_wandb: bool | None = None,
+username: str | None = None,
+x_cli_only_mode: bool = False,
+x_disable_meta: bool = False,
+x_disable_stats: bool = False,
+x_disable_viewer: bool = False,
+x_disable_machine_info: bool = False,
+x_executable: str | None = None,
+x_extra_http_headers: dict[str, str] | None = None,
+x_file_stream_max_bytes: int | None = None,
+x_file_stream_max_line_bytes: int | None = None,
+x_file_stream_transmit_interval: float | None = None,
+x_file_stream_retry_max: int | None = None,
+x_file_stream_retry_wait_min_seconds: float | None = None,
+x_file_stream_retry_wait_max_seconds: float | None = None,
+x_file_stream_timeout_seconds: float | None = None,
+x_file_transfer_retry_max: int | None = None,
+x_file_transfer_retry_wait_min_seconds: float | None = None,
+x_file_transfer_retry_wait_max_seconds: float | None = None,
+x_file_transfer_timeout_seconds: float | None = None,
+x_files_dir: str | None = None,
+x_flow_control_custom: bool | None = None,
+x_flow_control_disabled: bool | None = None,
+x_graphql_retry_max: int | None = None,
+x_graphql_retry_wait_min_seconds: float | None = None,
+x_graphql_retry_wait_max_seconds: float | None = None,
+x_graphql_timeout_seconds: float | None = None,
+x_internal_check_process: float = 8.0,
+x_jupyter_name: str | None = None,
+x_jupyter_path: str | None = None,
+x_jupyter_root: str | None = None,
+x_label: str | None = None,
+x_live_policy_rate_limit: int | None = None,
+x_live_policy_wait_time: int | None = None,
+x_log_level: int = 20,
+x_network_buffer: int | None = None,
+x_primary: bool = True,
+x_proxies: dict[str, str] | None = None,
+x_runqueue_item_id: str | None = None,
+x_save_requirements: bool = True,
+x_server_side_derived_summary: bool = False,
+x_server_side_expand_glob_metrics: bool = True,
+x_service_transport: str | None = None,
+x_service_wait: float = 30.0,
+x_skip_transaction_log: bool = False,
+x_start_time: float | None = None,
+x_stats_pid: int = 50165,
+x_stats_sampling_interval: float = 15.0,
+x_stats_neuron_monitor_config_path: str | None = None,
+x_stats_dcgm_exporter: str | None = None,
+x_stats_open_metrics_endpoints: dict[str, str] | None = None,
+x_stats_open_metrics_filters: dict[str, dict[str, str]] | collections.abc.Sequence[str] | None = None,
+x_stats_open_metrics_http_headers: dict[str, str] | None = None,
+x_stats_disk_paths: collections.abc.Sequence[str] | None = ('/',),
+x_stats_cpu_count: int | None = None,
+x_stats_cpu_logical_count: int | None = None,
+x_stats_gpu_count: int | None = None,
+x_stats_gpu_type: str | None = None,
+x_stats_gpu_device_ids: collections.abc.Sequence[int] | None = None,
+x_stats_buffer_size: int = 0,
+x_stats_coreweave_metadata_base_url: str = 'http://169.254.169.254',
+x_stats_coreweave_metadata_endpoint: str = '/api/v2/cloud-init/meta-data',
+x_stats_track_process_tree: bool = False,
+x_stats_no_cgroup: bool = False,
+x_sync: bool = False,
+x_sync_dir_suffix: str = '',
+x_update_finish_state: bool = True
+```
+## Description
-## class `Settings`
Settings for the W&B SDK.
This class manages configuration settings for the W&B SDK,
@@ -28,668 +189,846 @@ The settings are organized into three categories:
the environment.
-### method `Settings.__init__`
+
+## Args
+
+- **allow_media_symlink**:
+- **allow_offline_artifacts**:
+- **allow_val_change**:
+- **anonymous**:
+- **api_key**:
+- **azure_account_url_to_access_key**:
+- **app_url_override**:
+- **base_url**:
+- **code_dir**:
+- **config_paths**:
+- **console**:
+- **console_multipart**:
+- **console_chunk_max_bytes**:
+- **console_chunk_max_seconds**:
+- **capture_loggers**:
+- **credentials_file**:
+- **disable_code**:
+- **disable_git**:
+- **disable_git_fork_point**:
+- **disable_job_creation**:
+- **docker**:
+- **email**:
+- **entity**:
+- **organization**:
+- **force**:
+- **fork_from**:
+- **git_commit**:
+- **git_remote**:
+- **git_remote_url**:
+- **git_root**:
+- **heartbeat_seconds**:
+- **host**:
+- **http_proxy**:
+- **https_proxy**:
+- **identity_token_file**:
+- **ignore_globs**:
+- **init_timeout**:
+- **finish_timeout**:
+- **finish_timeout_raises**:
+- **insecure_disable_ssl**:
+- **job_name**:
+- **job_source**:
+- **label_disable**:
+- **launch**:
+- **launch_config_path**:
+- **login_timeout**:
+- **mode**:
+- **notebook_name**:
+- **program**:
+- **program_abspath**:
+- **program_relpath**:
+- **project**:
+- **quiet**:
+- **reinit**:
+- **relogin**:
+- **resume**:
+- **resume_from**:
+- **resumed**:
+- **root_dir**:
+- **run_group**:
+- **run_id**:
+- **run_job_type**:
+- **run_name**:
+- **run_notes**:
+- **run_tags**:
+- **sagemaker_disable**:
+- **save_code**:
+- **settings_system**:
+- **stop_fn**:
+- **max_end_of_run_history_metrics**:
+- **max_end_of_run_summary_metrics**:
+- **show_colors**:
+- **show_emoji**:
+- **show_errors**:
+- **show_info**:
+- **show_warnings**:
+- **silent**:
+- **start_method**:
+- **stop_on_fatal_error**:
+- **strict**:
+- **summary_timeout**:
+- **summary_warnings**:
+- **sweep_id**:
+- **sweep_param_path**:
+- **symlink**:
+- **sync_tensorboard**:
+- **table_raise_on_max_row_limit_exceeded**:
+- **use_dot_wandb**:
+- **username**:
+- **x_cli_only_mode**:
+- **x_disable_meta**:
+- **x_disable_stats**:
+- **x_disable_viewer**:
+- **x_disable_machine_info**:
+- **x_executable**:
+- **x_extra_http_headers**:
+- **x_file_stream_max_bytes**:
+- **x_file_stream_max_line_bytes**:
+- **x_file_stream_transmit_interval**:
+- **x_file_stream_retry_max**:
+- **x_file_stream_retry_wait_min_seconds**:
+- **x_file_stream_retry_wait_max_seconds**:
+- **x_file_stream_timeout_seconds**:
+- **x_file_transfer_retry_max**:
+- **x_file_transfer_retry_wait_min_seconds**:
+- **x_file_transfer_retry_wait_max_seconds**:
+- **x_file_transfer_timeout_seconds**:
+- **x_files_dir**:
+- **x_flow_control_custom**:
+- **x_flow_control_disabled**:
+- **x_graphql_retry_max**:
+- **x_graphql_retry_wait_min_seconds**:
+- **x_graphql_retry_wait_max_seconds**:
+- **x_graphql_timeout_seconds**:
+- **x_internal_check_process**:
+- **x_jupyter_name**:
+- **x_jupyter_path**:
+- **x_jupyter_root**:
+- **x_label**:
+- **x_live_policy_rate_limit**:
+- **x_live_policy_wait_time**:
+- **x_log_level**:
+- **x_network_buffer**:
+- **x_primary**:
+- **x_proxies**:
+- **x_runqueue_item_id**:
+- **x_save_requirements**:
+- **x_server_side_derived_summary**:
+- **x_server_side_expand_glob_metrics**:
+- **x_service_transport**:
+- **x_service_wait**:
+- **x_skip_transaction_log**:
+- **x_start_time**:
+- **x_stats_pid**:
+- **x_stats_sampling_interval**:
+- **x_stats_neuron_monitor_config_path**:
+- **x_stats_dcgm_exporter**:
+- **x_stats_open_metrics_endpoints**:
+- **x_stats_open_metrics_filters**:
+- **x_stats_open_metrics_http_headers**:
+- **x_stats_disk_paths**:
+- **x_stats_cpu_count**:
+- **x_stats_cpu_logical_count**:
+- **x_stats_gpu_count**:
+- **x_stats_gpu_type**:
+- **x_stats_gpu_device_ids**:
+- **x_stats_buffer_size**:
+- **x_stats_coreweave_metadata_base_url**:
+- **x_stats_coreweave_metadata_endpoint**:
+- **x_stats_track_process_tree**:
+- **x_stats_no_cgroup**:
+- **x_sync**:
+- **x_sync_dir_suffix**:
+- **x_update_finish_state**:
+
+
+
+
+## Properties
+
+### property app_url
+
+The URL for the W&B UI, usually https://wandb.ai.
+
+This is different from `base_url` (like https://api.wandb.ai) which
+is used to access W&B APIs programmatically.
+
+### property colab_url
+
+The URL to the Colab notebook, if running in Colab.
+
+### property deployment
+
+
+
+### property files_dir
+
+Absolute path to the local directory where the run's files are stored.
+
+### property is_local
+
+
+
+### property log_dir
+
+The directory for storing log files.
+
+### property log_internal
+
+The path to the file to use for internal logs.
+
+### property log_symlink_internal
+
+The path to the symlink to the internal log file of the most recent run.
+
+### property log_symlink_user
+
+The path to the symlink to the user-process log file of the most recent run.
+
+### property log_user
+
+The path to the file to use for user-process logs.
+
+### property project_url
+
+The W&B URL where the project can be viewed.
+
+### property resume_fname
+
+The path to the resume file.
+
+### property run_mode
+
+The mode of the run. Can be either "run" or "offline-run".
+
+### property run_url
+
+The W&B URL where the run can be viewed.
+
+### property settings_workspace
+
+The path to the workspace settings file.
+
+### property sweep_url
+
+The W&B URL where the sweep can be viewed.
+
+### property sync_dir
+
+The directory for storing the run's files.
+
+### property sync_file
+
+Path to the append-only binary transaction log file.
+
+### property sync_symlink_latest
+
+Path to the symlink to the most recent run's transaction log file.
+
+### property timespec
+
+The time specification for the run.
+
+### property wandb_dir
+
+Full path to the wandb directory.
+
+
+
+## Methods
+
+### method construct
```python
-__init__(
- allow_media_symlink: 'bool' = False,
- allow_offline_artifacts: 'bool' = True,
- allow_val_change: 'bool' = False,
- anonymous: 'object' =