miro_api.models.update_board_subscription_request
Miro Developer Platform
### Miro Developer Platform concepts - New to the Miro Developer Platform? Interested in learning more about platform concepts?? Read our introduction page and familiarize yourself with the Miro Developer Platform capabilities in a few minutes. ### Getting started with the Miro REST API - Quickstart (video): try the REST API in less than 3 minutes. - Quickstart (article): get started and try the REST API in less than 3 minutes. ### Miro REST API tutorials Check out our how-to articles with step-by-step instructions and code examples so you can: - Get started with OAuth 2.0 and Miro ### Miro App Examples Clone our Miro App Examples repository to get inspiration, customize, and explore apps built on top of Miro's Developer Platform 2.0.
The version of the OpenAPI document: v2.0 Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.
1# coding: utf-8 2 3""" 4Miro Developer Platform 5 6<img src=\"https://content.pstmn.io/47449ea6-0ef7-4af2-bac1-e58a70e61c58/aW1hZ2UucG5n\" width=\"1685\" height=\"593\"> ### Miro Developer Platform concepts - New to the Miro Developer Platform? Interested in learning more about platform concepts?? [Read our introduction page](https://beta.developers.miro.com/docs/introduction) and familiarize yourself with the Miro Developer Platform capabilities in a few minutes. ### Getting started with the Miro REST API - [Quickstart (video):](https://beta.developers.miro.com/docs/try-out-the-rest-api-in-less-than-3-minutes) try the REST API in less than 3 minutes. - [Quickstart (article):](https://beta.developers.miro.com/docs/build-your-first-hello-world-app-1) get started and try the REST API in less than 3 minutes. ### Miro REST API tutorials Check out our how-to articles with step-by-step instructions and code examples so you can: - [Get started with OAuth 2.0 and Miro](https://beta.developers.miro.com/docs/getting-started-with-oauth) ### Miro App Examples Clone our [Miro App Examples repository](https://github.com/miroapp/app-examples) to get inspiration, customize, and explore apps built on top of Miro's Developer Platform 2.0. 7 8The version of the OpenAPI document: v2.0 9Generated by OpenAPI Generator (https://openapi-generator.tech) 10 11Do not edit the class manually. 12""" # noqa: E501 13 14 15from __future__ import annotations 16import pprint 17import re # noqa: F401 18import json 19 20from pydantic import BaseModel, Field, StrictStr, field_validator 21from typing import Any, ClassVar, Dict, List, Optional 22from typing_extensions import Annotated 23from typing import Optional, Set 24from typing_extensions import Self 25 26 27class UpdateBoardSubscriptionRequest(BaseModel): 28 """ 29 Contains updated information about a subscription. 30 """ # noqa: E501 31 32 callback_url: Optional[Annotated[str, Field(min_length=8, strict=True, max_length=256)]] = Field( 33 default=None, 34 description="Indicates the HTTPS URL to which Miro sends a webhook when an event occurs.", 35 alias="callbackUrl", 36 ) 37 status: Optional[StrictStr] = Field( 38 default="enabled", 39 description="Indicates whether the status of the webhook subscription. `enabled`: Miro sends a webhook when an event occurs in the associated board. `disabled`: Miro does not send a webhook even when an event occurs in the associated board. `lost_access`: The user with which the webhook subscription is associated has lost access to the board. The user needs to regain access to the board, and then reenable the webhook subscription by updating the webhook subscription status to `enabled` by using the update webhook endpoint.", 40 ) 41 additional_properties: Dict[str, Any] = {} 42 __properties: ClassVar[List[str]] = ["callbackUrl", "status"] 43 44 @field_validator("callback_url") 45 def callback_url_validate_regular_expression(cls, value): 46 """Validates the regular expression""" 47 if value is None: 48 return value 49 50 if not re.match(r"^https:\/\/(.*)", value): 51 raise ValueError(r"must validate the regular expression /^https:\/\/(.*)/") 52 return value 53 54 @field_validator("status") 55 def status_validate_enum(cls, value): 56 """Validates the enum""" 57 if value is None: 58 return value 59 60 if value not in set(["enabled", "disabled"]): 61 raise ValueError("must be one of enum values ('enabled', 'disabled')") 62 return value 63 64 model_config = { 65 "populate_by_name": True, 66 "validate_assignment": True, 67 "protected_namespaces": (), 68 } 69 70 def to_str(self) -> str: 71 """Returns the string representation of the model using alias""" 72 return pprint.pformat(self.model_dump(by_alias=True)) 73 74 def to_json(self) -> str: 75 """Returns the JSON representation of the model using alias""" 76 # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead 77 return json.dumps(self.to_dict()) 78 79 @classmethod 80 def from_json(cls, json_str: str) -> Optional[Self]: 81 """Create an instance of UpdateBoardSubscriptionRequest from a JSON string""" 82 return cls.from_dict(json.loads(json_str)) 83 84 def to_dict(self) -> Dict[str, Any]: 85 """Return the dictionary representation of the model using alias. 86 87 This has the following differences from calling pydantic's 88 `self.model_dump(by_alias=True)`: 89 90 * `None` is only added to the output dict for nullable fields that 91 were set at model initialization. Other fields with value `None` 92 are ignored. 93 * Fields in `self.additional_properties` are added to the output dict. 94 """ 95 excluded_fields: Set[str] = set( 96 [ 97 "additional_properties", 98 ] 99 ) 100 101 _dict = self.model_dump( 102 by_alias=True, 103 exclude=excluded_fields, 104 exclude_none=True, 105 ) 106 # puts key-value pairs in additional_properties in the top level 107 if self.additional_properties is not None: 108 for _key, _value in self.additional_properties.items(): 109 _dict[_key] = _value 110 111 return _dict 112 113 @classmethod 114 def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]: 115 """Create an instance of UpdateBoardSubscriptionRequest from a dict""" 116 if obj is None: 117 return None 118 119 if not isinstance(obj, dict): 120 return cls.model_validate(obj) 121 122 _obj = cls.model_validate( 123 { 124 "callbackUrl": obj.get("callbackUrl"), 125 "status": obj.get("status") if obj.get("status") is not None else "enabled", 126 } 127 ) 128 # store additional fields in additional_properties 129 for _key in obj.keys(): 130 if _key not in cls.__properties: 131 _obj.additional_properties[_key] = obj.get(_key) 132 133 return _obj
28class UpdateBoardSubscriptionRequest(BaseModel): 29 """ 30 Contains updated information about a subscription. 31 """ # noqa: E501 32 33 callback_url: Optional[Annotated[str, Field(min_length=8, strict=True, max_length=256)]] = Field( 34 default=None, 35 description="Indicates the HTTPS URL to which Miro sends a webhook when an event occurs.", 36 alias="callbackUrl", 37 ) 38 status: Optional[StrictStr] = Field( 39 default="enabled", 40 description="Indicates whether the status of the webhook subscription. `enabled`: Miro sends a webhook when an event occurs in the associated board. `disabled`: Miro does not send a webhook even when an event occurs in the associated board. `lost_access`: The user with which the webhook subscription is associated has lost access to the board. The user needs to regain access to the board, and then reenable the webhook subscription by updating the webhook subscription status to `enabled` by using the update webhook endpoint.", 41 ) 42 additional_properties: Dict[str, Any] = {} 43 __properties: ClassVar[List[str]] = ["callbackUrl", "status"] 44 45 @field_validator("callback_url") 46 def callback_url_validate_regular_expression(cls, value): 47 """Validates the regular expression""" 48 if value is None: 49 return value 50 51 if not re.match(r"^https:\/\/(.*)", value): 52 raise ValueError(r"must validate the regular expression /^https:\/\/(.*)/") 53 return value 54 55 @field_validator("status") 56 def status_validate_enum(cls, value): 57 """Validates the enum""" 58 if value is None: 59 return value 60 61 if value not in set(["enabled", "disabled"]): 62 raise ValueError("must be one of enum values ('enabled', 'disabled')") 63 return value 64 65 model_config = { 66 "populate_by_name": True, 67 "validate_assignment": True, 68 "protected_namespaces": (), 69 } 70 71 def to_str(self) -> str: 72 """Returns the string representation of the model using alias""" 73 return pprint.pformat(self.model_dump(by_alias=True)) 74 75 def to_json(self) -> str: 76 """Returns the JSON representation of the model using alias""" 77 # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead 78 return json.dumps(self.to_dict()) 79 80 @classmethod 81 def from_json(cls, json_str: str) -> Optional[Self]: 82 """Create an instance of UpdateBoardSubscriptionRequest from a JSON string""" 83 return cls.from_dict(json.loads(json_str)) 84 85 def to_dict(self) -> Dict[str, Any]: 86 """Return the dictionary representation of the model using alias. 87 88 This has the following differences from calling pydantic's 89 `self.model_dump(by_alias=True)`: 90 91 * `None` is only added to the output dict for nullable fields that 92 were set at model initialization. Other fields with value `None` 93 are ignored. 94 * Fields in `self.additional_properties` are added to the output dict. 95 """ 96 excluded_fields: Set[str] = set( 97 [ 98 "additional_properties", 99 ] 100 ) 101 102 _dict = self.model_dump( 103 by_alias=True, 104 exclude=excluded_fields, 105 exclude_none=True, 106 ) 107 # puts key-value pairs in additional_properties in the top level 108 if self.additional_properties is not None: 109 for _key, _value in self.additional_properties.items(): 110 _dict[_key] = _value 111 112 return _dict 113 114 @classmethod 115 def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]: 116 """Create an instance of UpdateBoardSubscriptionRequest from a dict""" 117 if obj is None: 118 return None 119 120 if not isinstance(obj, dict): 121 return cls.model_validate(obj) 122 123 _obj = cls.model_validate( 124 { 125 "callbackUrl": obj.get("callbackUrl"), 126 "status": obj.get("status") if obj.get("status") is not None else "enabled", 127 } 128 ) 129 # store additional fields in additional_properties 130 for _key in obj.keys(): 131 if _key not in cls.__properties: 132 _obj.additional_properties[_key] = obj.get(_key) 133 134 return _obj
Contains updated information about a subscription.
45 @field_validator("callback_url") 46 def callback_url_validate_regular_expression(cls, value): 47 """Validates the regular expression""" 48 if value is None: 49 return value 50 51 if not re.match(r"^https:\/\/(.*)", value): 52 raise ValueError(r"must validate the regular expression /^https:\/\/(.*)/") 53 return value
Validates the regular expression
55 @field_validator("status") 56 def status_validate_enum(cls, value): 57 """Validates the enum""" 58 if value is None: 59 return value 60 61 if value not in set(["enabled", "disabled"]): 62 raise ValueError("must be one of enum values ('enabled', 'disabled')") 63 return value
Validates the enum
71 def to_str(self) -> str: 72 """Returns the string representation of the model using alias""" 73 return pprint.pformat(self.model_dump(by_alias=True))
Returns the string representation of the model using alias
75 def to_json(self) -> str: 76 """Returns the JSON representation of the model using alias""" 77 # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead 78 return json.dumps(self.to_dict())
Returns the JSON representation of the model using alias
80 @classmethod 81 def from_json(cls, json_str: str) -> Optional[Self]: 82 """Create an instance of UpdateBoardSubscriptionRequest from a JSON string""" 83 return cls.from_dict(json.loads(json_str))
Create an instance of UpdateBoardSubscriptionRequest from a JSON string
85 def to_dict(self) -> Dict[str, Any]: 86 """Return the dictionary representation of the model using alias. 87 88 This has the following differences from calling pydantic's 89 `self.model_dump(by_alias=True)`: 90 91 * `None` is only added to the output dict for nullable fields that 92 were set at model initialization. Other fields with value `None` 93 are ignored. 94 * Fields in `self.additional_properties` are added to the output dict. 95 """ 96 excluded_fields: Set[str] = set( 97 [ 98 "additional_properties", 99 ] 100 ) 101 102 _dict = self.model_dump( 103 by_alias=True, 104 exclude=excluded_fields, 105 exclude_none=True, 106 ) 107 # puts key-value pairs in additional_properties in the top level 108 if self.additional_properties is not None: 109 for _key, _value in self.additional_properties.items(): 110 _dict[_key] = _value 111 112 return _dict
Return the dictionary representation of the model using alias.
This has the following differences from calling pydantic's
self.model_dump(by_alias=True)
:
None
is only added to the output dict for nullable fields that were set at model initialization. Other fields with valueNone
are ignored.- Fields in
self.additional_properties
are added to the output dict.
114 @classmethod 115 def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]: 116 """Create an instance of UpdateBoardSubscriptionRequest from a dict""" 117 if obj is None: 118 return None 119 120 if not isinstance(obj, dict): 121 return cls.model_validate(obj) 122 123 _obj = cls.model_validate( 124 { 125 "callbackUrl": obj.get("callbackUrl"), 126 "status": obj.get("status") if obj.get("status") is not None else "enabled", 127 } 128 ) 129 # store additional fields in additional_properties 130 for _key in obj.keys(): 131 if _key not in cls.__properties: 132 _obj.additional_properties[_key] = obj.get(_key) 133 134 return _obj
Create an instance of UpdateBoardSubscriptionRequest from a dict
265def init_private_attributes(self: BaseModel, __context: Any) -> None: 266 """This function is meant to behave like a BaseModel method to initialise private attributes. 267 268 It takes context as an argument since that's what pydantic-core passes when calling it. 269 270 Args: 271 self: The BaseModel instance. 272 __context: The context. 273 """ 274 if getattr(self, '__pydantic_private__', None) is None: 275 pydantic_private = {} 276 for name, private_attr in self.__private_attributes__.items(): 277 default = private_attr.get_default() 278 if default is not PydanticUndefined: 279 pydantic_private[name] = default 280 object_setattr(self, '__pydantic_private__', pydantic_private)
This function is meant to behave like a BaseModel method to initialise private attributes.
It takes context as an argument since that's what pydantic-core passes when calling it.
Args: self: The BaseModel instance. __context: The context.
Inherited Members
- pydantic.main.BaseModel
- BaseModel
- model_extra
- model_fields_set
- model_construct
- model_copy
- model_dump
- model_dump_json
- model_json_schema
- model_parametrized_name
- model_rebuild
- model_validate
- model_validate_json
- model_validate_strings
- dict
- json
- parse_obj
- parse_raw
- parse_file
- from_orm
- construct
- copy
- schema
- schema_json
- validate
- update_forward_refs