# Catalog Syncs ## List Catalog Syncs `magic_cloud_networking.catalog_syncs.list(CatalogSyncListParams**kwargs) -> SyncSinglePage[CatalogSyncListResponse]` **get** `/accounts/{account_id}/magic/cloud/catalog-syncs` List Catalog Syncs (Closed Beta). ### Parameters - `account_id: str` ### Returns - `class CatalogSyncListResponse: …` - `id: str` - `description: str` - `destination_id: str` - `destination_type: Literal["NONE", "ZERO_TRUST_LIST"]` - `"NONE"` - `"ZERO_TRUST_LIST"` - `last_user_update_at: str` - `name: str` - `policy: str` - `update_mode: Literal["AUTO", "MANUAL"]` - `"AUTO"` - `"MANUAL"` - `errors: Optional[Dict[str, Errors]]` - `code: Literal[1001, 1002, 1003, 152 more]` - `1001` - `1002` - `1003` - `1004` - `1005` - `1006` - `1007` - `1008` - `1009` - `1010` - `1011` - `1012` - `1013` - `1014` - `1015` - `1016` - `1017` - `1018` - `2001` - `2002` - `2003` - `2004` - `2005` - `2006` - `2007` - `2008` - `2009` - `2010` - `2011` - `2012` - `2013` - `2014` - `2015` - `2016` - `2017` - `2018` - `2019` - `2020` - `2021` - `2022` - `3001` - `3002` - `3003` - `3004` - `3005` - `3006` - `3007` - `4001` - `4002` - `4003` - `4004` - `4005` - `4006` - `4007` - `4008` - `4009` - `4010` - `4011` - `4012` - `4013` - `4014` - `4015` - `4016` - `4017` - `4018` - `4019` - `4020` - `4021` - `4022` - `4023` - `5001` - `5002` - `5003` - `5004` - `102000` - `102001` - `102002` - `102003` - `102004` - `102005` - `102006` - `102007` - `102008` - `102009` - `102010` - `102011` - `102012` - `102013` - `102014` - `102015` - `102016` - `102017` - `102018` - `102019` - `102020` - `102021` - `102022` - `102023` - `102024` - `102025` - `102026` - `102027` - `102028` - `102029` - `102030` - `102031` - `102032` - `102033` - `102034` - `102035` - `102036` - `102037` - `102038` - `102039` - `102040` - `102041` - `102042` - `102043` - `102044` - `102045` - `102046` - `102047` - `102048` - `102049` - `102050` - `102051` - `102052` - `102053` - `102054` - `102055` - `102056` - `102057` - `102058` - `102059` - `102060` - `102061` - `102062` - `102063` - `102064` - `102065` - `102066` - `102067` - `102068` - `102069` - `102070` - `102071` - `102072` - `103001` - `103002` - `103003` - `103004` - `103005` - `103006` - `103007` - `103008` - `message: str` - `documentation_url: Optional[str]` - `meta: Optional[ErrorsMeta]` - `l10n_key: Optional[str]` - `loggable_error: Optional[str]` - `template_data: Optional[object]` - `trace_id: Optional[str]` - `source: Optional[ErrorsSource]` - `parameter: Optional[str]` - `parameter_value_index: Optional[int]` - `pointer: Optional[str]` - `includes_discoveries_until: Optional[str]` - `last_attempted_update_at: Optional[str]` - `last_successful_update_at: Optional[str]` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) page = client.magic_cloud_networking.catalog_syncs.list( account_id="account_id", ) page = page.result[0] print(page.id) ``` #### Response ```json { "errors": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "messages": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "result": [ { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "description": "description", "destination_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "destination_type": "NONE", "last_user_update_at": "last_user_update_at", "name": "name", "policy": "policy", "update_mode": "AUTO", "errors": { "foo": { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } }, "includes_discoveries_until": "includes_discoveries_until", "last_attempted_update_at": "last_attempted_update_at", "last_successful_update_at": "last_successful_update_at" } ], "success": true } ``` ## Read Catalog Sync `magic_cloud_networking.catalog_syncs.get(strsync_id, CatalogSyncGetParams**kwargs) -> CatalogSyncGetResponse` **get** `/accounts/{account_id}/magic/cloud/catalog-syncs/{sync_id}` Read a Catalog Sync (Closed Beta). ### Parameters - `account_id: str` - `sync_id: str` ### Returns - `class CatalogSyncGetResponse: …` - `id: str` - `description: str` - `destination_id: str` - `destination_type: Literal["NONE", "ZERO_TRUST_LIST"]` - `"NONE"` - `"ZERO_TRUST_LIST"` - `last_user_update_at: str` - `name: str` - `policy: str` - `update_mode: Literal["AUTO", "MANUAL"]` - `"AUTO"` - `"MANUAL"` - `errors: Optional[Dict[str, Errors]]` - `code: Literal[1001, 1002, 1003, 152 more]` - `1001` - `1002` - `1003` - `1004` - `1005` - `1006` - `1007` - `1008` - `1009` - `1010` - `1011` - `1012` - `1013` - `1014` - `1015` - `1016` - `1017` - `1018` - `2001` - `2002` - `2003` - `2004` - `2005` - `2006` - `2007` - `2008` - `2009` - `2010` - `2011` - `2012` - `2013` - `2014` - `2015` - `2016` - `2017` - `2018` - `2019` - `2020` - `2021` - `2022` - `3001` - `3002` - `3003` - `3004` - `3005` - `3006` - `3007` - `4001` - `4002` - `4003` - `4004` - `4005` - `4006` - `4007` - `4008` - `4009` - `4010` - `4011` - `4012` - `4013` - `4014` - `4015` - `4016` - `4017` - `4018` - `4019` - `4020` - `4021` - `4022` - `4023` - `5001` - `5002` - `5003` - `5004` - `102000` - `102001` - `102002` - `102003` - `102004` - `102005` - `102006` - `102007` - `102008` - `102009` - `102010` - `102011` - `102012` - `102013` - `102014` - `102015` - `102016` - `102017` - `102018` - `102019` - `102020` - `102021` - `102022` - `102023` - `102024` - `102025` - `102026` - `102027` - `102028` - `102029` - `102030` - `102031` - `102032` - `102033` - `102034` - `102035` - `102036` - `102037` - `102038` - `102039` - `102040` - `102041` - `102042` - `102043` - `102044` - `102045` - `102046` - `102047` - `102048` - `102049` - `102050` - `102051` - `102052` - `102053` - `102054` - `102055` - `102056` - `102057` - `102058` - `102059` - `102060` - `102061` - `102062` - `102063` - `102064` - `102065` - `102066` - `102067` - `102068` - `102069` - `102070` - `102071` - `102072` - `103001` - `103002` - `103003` - `103004` - `103005` - `103006` - `103007` - `103008` - `message: str` - `documentation_url: Optional[str]` - `meta: Optional[ErrorsMeta]` - `l10n_key: Optional[str]` - `loggable_error: Optional[str]` - `template_data: Optional[object]` - `trace_id: Optional[str]` - `source: Optional[ErrorsSource]` - `parameter: Optional[str]` - `parameter_value_index: Optional[int]` - `pointer: Optional[str]` - `includes_discoveries_until: Optional[str]` - `last_attempted_update_at: Optional[str]` - `last_successful_update_at: Optional[str]` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) catalog_sync = client.magic_cloud_networking.catalog_syncs.get( sync_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", account_id="account_id", ) print(catalog_sync.id) ``` #### Response ```json { "errors": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "messages": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "result": { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "description": "description", "destination_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "destination_type": "NONE", "last_user_update_at": "last_user_update_at", "name": "name", "policy": "policy", "update_mode": "AUTO", "errors": { "foo": { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } }, "includes_discoveries_until": "includes_discoveries_until", "last_attempted_update_at": "last_attempted_update_at", "last_successful_update_at": "last_successful_update_at" }, "success": true } ``` ## Create Catalog Sync `magic_cloud_networking.catalog_syncs.create(CatalogSyncCreateParams**kwargs) -> CatalogSyncCreateResponse` **post** `/accounts/{account_id}/magic/cloud/catalog-syncs` Create a new Catalog Sync (Closed Beta). ### Parameters - `account_id: str` - `destination_type: Literal["NONE", "ZERO_TRUST_LIST"]` - `"NONE"` - `"ZERO_TRUST_LIST"` - `name: str` - `update_mode: Literal["AUTO", "MANUAL"]` - `"AUTO"` - `"MANUAL"` - `description: Optional[str]` - `policy: Optional[str]` - `forwarded: Optional[str]` ### Returns - `class CatalogSyncCreateResponse: …` - `id: str` - `description: str` - `destination_id: str` - `destination_type: Literal["NONE", "ZERO_TRUST_LIST"]` - `"NONE"` - `"ZERO_TRUST_LIST"` - `last_user_update_at: str` - `name: str` - `policy: str` - `update_mode: Literal["AUTO", "MANUAL"]` - `"AUTO"` - `"MANUAL"` - `errors: Optional[Dict[str, Errors]]` - `code: Literal[1001, 1002, 1003, 152 more]` - `1001` - `1002` - `1003` - `1004` - `1005` - `1006` - `1007` - `1008` - `1009` - `1010` - `1011` - `1012` - `1013` - `1014` - `1015` - `1016` - `1017` - `1018` - `2001` - `2002` - `2003` - `2004` - `2005` - `2006` - `2007` - `2008` - `2009` - `2010` - `2011` - `2012` - `2013` - `2014` - `2015` - `2016` - `2017` - `2018` - `2019` - `2020` - `2021` - `2022` - `3001` - `3002` - `3003` - `3004` - `3005` - `3006` - `3007` - `4001` - `4002` - `4003` - `4004` - `4005` - `4006` - `4007` - `4008` - `4009` - `4010` - `4011` - `4012` - `4013` - `4014` - `4015` - `4016` - `4017` - `4018` - `4019` - `4020` - `4021` - `4022` - `4023` - `5001` - `5002` - `5003` - `5004` - `102000` - `102001` - `102002` - `102003` - `102004` - `102005` - `102006` - `102007` - `102008` - `102009` - `102010` - `102011` - `102012` - `102013` - `102014` - `102015` - `102016` - `102017` - `102018` - `102019` - `102020` - `102021` - `102022` - `102023` - `102024` - `102025` - `102026` - `102027` - `102028` - `102029` - `102030` - `102031` - `102032` - `102033` - `102034` - `102035` - `102036` - `102037` - `102038` - `102039` - `102040` - `102041` - `102042` - `102043` - `102044` - `102045` - `102046` - `102047` - `102048` - `102049` - `102050` - `102051` - `102052` - `102053` - `102054` - `102055` - `102056` - `102057` - `102058` - `102059` - `102060` - `102061` - `102062` - `102063` - `102064` - `102065` - `102066` - `102067` - `102068` - `102069` - `102070` - `102071` - `102072` - `103001` - `103002` - `103003` - `103004` - `103005` - `103006` - `103007` - `103008` - `message: str` - `documentation_url: Optional[str]` - `meta: Optional[ErrorsMeta]` - `l10n_key: Optional[str]` - `loggable_error: Optional[str]` - `template_data: Optional[object]` - `trace_id: Optional[str]` - `source: Optional[ErrorsSource]` - `parameter: Optional[str]` - `parameter_value_index: Optional[int]` - `pointer: Optional[str]` - `includes_discoveries_until: Optional[str]` - `last_attempted_update_at: Optional[str]` - `last_successful_update_at: Optional[str]` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) catalog_sync = client.magic_cloud_networking.catalog_syncs.create( account_id="account_id", destination_type="NONE", name="name", update_mode="AUTO", ) print(catalog_sync.id) ``` #### Response ```json { "errors": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "messages": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "result": { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "description": "description", "destination_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "destination_type": "NONE", "last_user_update_at": "last_user_update_at", "name": "name", "policy": "policy", "update_mode": "AUTO", "errors": { "foo": { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } }, "includes_discoveries_until": "includes_discoveries_until", "last_attempted_update_at": "last_attempted_update_at", "last_successful_update_at": "last_successful_update_at" }, "success": true } ``` ## Update Catalog Sync `magic_cloud_networking.catalog_syncs.update(strsync_id, CatalogSyncUpdateParams**kwargs) -> CatalogSyncUpdateResponse` **put** `/accounts/{account_id}/magic/cloud/catalog-syncs/{sync_id}` Update a Catalog Sync (Closed Beta). ### Parameters - `account_id: str` - `sync_id: str` - `description: Optional[str]` - `name: Optional[str]` - `policy: Optional[str]` - `update_mode: Optional[Literal["AUTO", "MANUAL"]]` - `"AUTO"` - `"MANUAL"` ### Returns - `class CatalogSyncUpdateResponse: …` - `id: str` - `description: str` - `destination_id: str` - `destination_type: Literal["NONE", "ZERO_TRUST_LIST"]` - `"NONE"` - `"ZERO_TRUST_LIST"` - `last_user_update_at: str` - `name: str` - `policy: str` - `update_mode: Literal["AUTO", "MANUAL"]` - `"AUTO"` - `"MANUAL"` - `errors: Optional[Dict[str, Errors]]` - `code: Literal[1001, 1002, 1003, 152 more]` - `1001` - `1002` - `1003` - `1004` - `1005` - `1006` - `1007` - `1008` - `1009` - `1010` - `1011` - `1012` - `1013` - `1014` - `1015` - `1016` - `1017` - `1018` - `2001` - `2002` - `2003` - `2004` - `2005` - `2006` - `2007` - `2008` - `2009` - `2010` - `2011` - `2012` - `2013` - `2014` - `2015` - `2016` - `2017` - `2018` - `2019` - `2020` - `2021` - `2022` - `3001` - `3002` - `3003` - `3004` - `3005` - `3006` - `3007` - `4001` - `4002` - `4003` - `4004` - `4005` - `4006` - `4007` - `4008` - `4009` - `4010` - `4011` - `4012` - `4013` - `4014` - `4015` - `4016` - `4017` - `4018` - `4019` - `4020` - `4021` - `4022` - `4023` - `5001` - `5002` - `5003` - `5004` - `102000` - `102001` - `102002` - `102003` - `102004` - `102005` - `102006` - `102007` - `102008` - `102009` - `102010` - `102011` - `102012` - `102013` - `102014` - `102015` - `102016` - `102017` - `102018` - `102019` - `102020` - `102021` - `102022` - `102023` - `102024` - `102025` - `102026` - `102027` - `102028` - `102029` - `102030` - `102031` - `102032` - `102033` - `102034` - `102035` - `102036` - `102037` - `102038` - `102039` - `102040` - `102041` - `102042` - `102043` - `102044` - `102045` - `102046` - `102047` - `102048` - `102049` - `102050` - `102051` - `102052` - `102053` - `102054` - `102055` - `102056` - `102057` - `102058` - `102059` - `102060` - `102061` - `102062` - `102063` - `102064` - `102065` - `102066` - `102067` - `102068` - `102069` - `102070` - `102071` - `102072` - `103001` - `103002` - `103003` - `103004` - `103005` - `103006` - `103007` - `103008` - `message: str` - `documentation_url: Optional[str]` - `meta: Optional[ErrorsMeta]` - `l10n_key: Optional[str]` - `loggable_error: Optional[str]` - `template_data: Optional[object]` - `trace_id: Optional[str]` - `source: Optional[ErrorsSource]` - `parameter: Optional[str]` - `parameter_value_index: Optional[int]` - `pointer: Optional[str]` - `includes_discoveries_until: Optional[str]` - `last_attempted_update_at: Optional[str]` - `last_successful_update_at: Optional[str]` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) catalog_sync = client.magic_cloud_networking.catalog_syncs.update( sync_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", account_id="account_id", ) print(catalog_sync.id) ``` #### Response ```json { "errors": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "messages": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "result": { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "description": "description", "destination_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "destination_type": "NONE", "last_user_update_at": "last_user_update_at", "name": "name", "policy": "policy", "update_mode": "AUTO", "errors": { "foo": { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } }, "includes_discoveries_until": "includes_discoveries_until", "last_attempted_update_at": "last_attempted_update_at", "last_successful_update_at": "last_successful_update_at" }, "success": true } ``` ## Patch Catalog Sync `magic_cloud_networking.catalog_syncs.edit(strsync_id, CatalogSyncEditParams**kwargs) -> CatalogSyncEditResponse` **patch** `/accounts/{account_id}/magic/cloud/catalog-syncs/{sync_id}` Update a Catalog Sync (Closed Beta). ### Parameters - `account_id: str` - `sync_id: str` - `description: Optional[str]` - `name: Optional[str]` - `policy: Optional[str]` - `update_mode: Optional[Literal["AUTO", "MANUAL"]]` - `"AUTO"` - `"MANUAL"` ### Returns - `class CatalogSyncEditResponse: …` - `id: str` - `description: str` - `destination_id: str` - `destination_type: Literal["NONE", "ZERO_TRUST_LIST"]` - `"NONE"` - `"ZERO_TRUST_LIST"` - `last_user_update_at: str` - `name: str` - `policy: str` - `update_mode: Literal["AUTO", "MANUAL"]` - `"AUTO"` - `"MANUAL"` - `errors: Optional[Dict[str, Errors]]` - `code: Literal[1001, 1002, 1003, 152 more]` - `1001` - `1002` - `1003` - `1004` - `1005` - `1006` - `1007` - `1008` - `1009` - `1010` - `1011` - `1012` - `1013` - `1014` - `1015` - `1016` - `1017` - `1018` - `2001` - `2002` - `2003` - `2004` - `2005` - `2006` - `2007` - `2008` - `2009` - `2010` - `2011` - `2012` - `2013` - `2014` - `2015` - `2016` - `2017` - `2018` - `2019` - `2020` - `2021` - `2022` - `3001` - `3002` - `3003` - `3004` - `3005` - `3006` - `3007` - `4001` - `4002` - `4003` - `4004` - `4005` - `4006` - `4007` - `4008` - `4009` - `4010` - `4011` - `4012` - `4013` - `4014` - `4015` - `4016` - `4017` - `4018` - `4019` - `4020` - `4021` - `4022` - `4023` - `5001` - `5002` - `5003` - `5004` - `102000` - `102001` - `102002` - `102003` - `102004` - `102005` - `102006` - `102007` - `102008` - `102009` - `102010` - `102011` - `102012` - `102013` - `102014` - `102015` - `102016` - `102017` - `102018` - `102019` - `102020` - `102021` - `102022` - `102023` - `102024` - `102025` - `102026` - `102027` - `102028` - `102029` - `102030` - `102031` - `102032` - `102033` - `102034` - `102035` - `102036` - `102037` - `102038` - `102039` - `102040` - `102041` - `102042` - `102043` - `102044` - `102045` - `102046` - `102047` - `102048` - `102049` - `102050` - `102051` - `102052` - `102053` - `102054` - `102055` - `102056` - `102057` - `102058` - `102059` - `102060` - `102061` - `102062` - `102063` - `102064` - `102065` - `102066` - `102067` - `102068` - `102069` - `102070` - `102071` - `102072` - `103001` - `103002` - `103003` - `103004` - `103005` - `103006` - `103007` - `103008` - `message: str` - `documentation_url: Optional[str]` - `meta: Optional[ErrorsMeta]` - `l10n_key: Optional[str]` - `loggable_error: Optional[str]` - `template_data: Optional[object]` - `trace_id: Optional[str]` - `source: Optional[ErrorsSource]` - `parameter: Optional[str]` - `parameter_value_index: Optional[int]` - `pointer: Optional[str]` - `includes_discoveries_until: Optional[str]` - `last_attempted_update_at: Optional[str]` - `last_successful_update_at: Optional[str]` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) response = client.magic_cloud_networking.catalog_syncs.edit( sync_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", account_id="account_id", ) print(response.id) ``` #### Response ```json { "errors": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "messages": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "result": { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "description": "description", "destination_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "destination_type": "NONE", "last_user_update_at": "last_user_update_at", "name": "name", "policy": "policy", "update_mode": "AUTO", "errors": { "foo": { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } }, "includes_discoveries_until": "includes_discoveries_until", "last_attempted_update_at": "last_attempted_update_at", "last_successful_update_at": "last_successful_update_at" }, "success": true } ``` ## Delete Catalog Sync `magic_cloud_networking.catalog_syncs.delete(strsync_id, CatalogSyncDeleteParams**kwargs) -> CatalogSyncDeleteResponse` **delete** `/accounts/{account_id}/magic/cloud/catalog-syncs/{sync_id}` Delete a Catalog Sync (Closed Beta). ### Parameters - `account_id: str` - `sync_id: str` - `delete_destination: Optional[bool]` ### Returns - `class CatalogSyncDeleteResponse: …` - `id: str` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) catalog_sync = client.magic_cloud_networking.catalog_syncs.delete( sync_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", account_id="account_id", ) print(catalog_sync.id) ``` #### Response ```json { "errors": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "messages": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "result": { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e" }, "success": true } ``` ## Run Catalog Sync `magic_cloud_networking.catalog_syncs.refresh(strsync_id, CatalogSyncRefreshParams**kwargs) -> CatalogSyncRefreshResponse` **post** `/accounts/{account_id}/magic/cloud/catalog-syncs/{sync_id}/refresh` Refresh a Catalog Sync's destination by running the sync policy against latest resource catalog (Closed Beta). ### Parameters - `account_id: str` - `sync_id: str` ### Returns - `str` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) response = client.magic_cloud_networking.catalog_syncs.refresh( sync_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", account_id="account_id", ) print(response) ``` #### Response ```json { "errors": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "messages": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "result": "result", "success": true } ``` ## Domain Types ### Catalog Sync List Response - `class CatalogSyncListResponse: …` - `id: str` - `description: str` - `destination_id: str` - `destination_type: Literal["NONE", "ZERO_TRUST_LIST"]` - `"NONE"` - `"ZERO_TRUST_LIST"` - `last_user_update_at: str` - `name: str` - `policy: str` - `update_mode: Literal["AUTO", "MANUAL"]` - `"AUTO"` - `"MANUAL"` - `errors: Optional[Dict[str, Errors]]` - `code: Literal[1001, 1002, 1003, 152 more]` - `1001` - `1002` - `1003` - `1004` - `1005` - `1006` - `1007` - `1008` - `1009` - `1010` - `1011` - `1012` - `1013` - `1014` - `1015` - `1016` - `1017` - `1018` - `2001` - `2002` - `2003` - `2004` - `2005` - `2006` - `2007` - `2008` - `2009` - `2010` - `2011` - `2012` - `2013` - `2014` - `2015` - `2016` - `2017` - `2018` - `2019` - `2020` - `2021` - `2022` - `3001` - `3002` - `3003` - `3004` - `3005` - `3006` - `3007` - `4001` - `4002` - `4003` - `4004` - `4005` - `4006` - `4007` - `4008` - `4009` - `4010` - `4011` - `4012` - `4013` - `4014` - `4015` - `4016` - `4017` - `4018` - `4019` - `4020` - `4021` - `4022` - `4023` - `5001` - `5002` - `5003` - `5004` - `102000` - `102001` - `102002` - `102003` - `102004` - `102005` - `102006` - `102007` - `102008` - `102009` - `102010` - `102011` - `102012` - `102013` - `102014` - `102015` - `102016` - `102017` - `102018` - `102019` - `102020` - `102021` - `102022` - `102023` - `102024` - `102025` - `102026` - `102027` - `102028` - `102029` - `102030` - `102031` - `102032` - `102033` - `102034` - `102035` - `102036` - `102037` - `102038` - `102039` - `102040` - `102041` - `102042` - `102043` - `102044` - `102045` - `102046` - `102047` - `102048` - `102049` - `102050` - `102051` - `102052` - `102053` - `102054` - `102055` - `102056` - `102057` - `102058` - `102059` - `102060` - `102061` - `102062` - `102063` - `102064` - `102065` - `102066` - `102067` - `102068` - `102069` - `102070` - `102071` - `102072` - `103001` - `103002` - `103003` - `103004` - `103005` - `103006` - `103007` - `103008` - `message: str` - `documentation_url: Optional[str]` - `meta: Optional[ErrorsMeta]` - `l10n_key: Optional[str]` - `loggable_error: Optional[str]` - `template_data: Optional[object]` - `trace_id: Optional[str]` - `source: Optional[ErrorsSource]` - `parameter: Optional[str]` - `parameter_value_index: Optional[int]` - `pointer: Optional[str]` - `includes_discoveries_until: Optional[str]` - `last_attempted_update_at: Optional[str]` - `last_successful_update_at: Optional[str]` ### Catalog Sync Get Response - `class CatalogSyncGetResponse: …` - `id: str` - `description: str` - `destination_id: str` - `destination_type: Literal["NONE", "ZERO_TRUST_LIST"]` - `"NONE"` - `"ZERO_TRUST_LIST"` - `last_user_update_at: str` - `name: str` - `policy: str` - `update_mode: Literal["AUTO", "MANUAL"]` - `"AUTO"` - `"MANUAL"` - `errors: Optional[Dict[str, Errors]]` - `code: Literal[1001, 1002, 1003, 152 more]` - `1001` - `1002` - `1003` - `1004` - `1005` - `1006` - `1007` - `1008` - `1009` - `1010` - `1011` - `1012` - `1013` - `1014` - `1015` - `1016` - `1017` - `1018` - `2001` - `2002` - `2003` - `2004` - `2005` - `2006` - `2007` - `2008` - `2009` - `2010` - `2011` - `2012` - `2013` - `2014` - `2015` - `2016` - `2017` - `2018` - `2019` - `2020` - `2021` - `2022` - `3001` - `3002` - `3003` - `3004` - `3005` - `3006` - `3007` - `4001` - `4002` - `4003` - `4004` - `4005` - `4006` - `4007` - `4008` - `4009` - `4010` - `4011` - `4012` - `4013` - `4014` - `4015` - `4016` - `4017` - `4018` - `4019` - `4020` - `4021` - `4022` - `4023` - `5001` - `5002` - `5003` - `5004` - `102000` - `102001` - `102002` - `102003` - `102004` - `102005` - `102006` - `102007` - `102008` - `102009` - `102010` - `102011` - `102012` - `102013` - `102014` - `102015` - `102016` - `102017` - `102018` - `102019` - `102020` - `102021` - `102022` - `102023` - `102024` - `102025` - `102026` - `102027` - `102028` - `102029` - `102030` - `102031` - `102032` - `102033` - `102034` - `102035` - `102036` - `102037` - `102038` - `102039` - `102040` - `102041` - `102042` - `102043` - `102044` - `102045` - `102046` - `102047` - `102048` - `102049` - `102050` - `102051` - `102052` - `102053` - `102054` - `102055` - `102056` - `102057` - `102058` - `102059` - `102060` - `102061` - `102062` - `102063` - `102064` - `102065` - `102066` - `102067` - `102068` - `102069` - `102070` - `102071` - `102072` - `103001` - `103002` - `103003` - `103004` - `103005` - `103006` - `103007` - `103008` - `message: str` - `documentation_url: Optional[str]` - `meta: Optional[ErrorsMeta]` - `l10n_key: Optional[str]` - `loggable_error: Optional[str]` - `template_data: Optional[object]` - `trace_id: Optional[str]` - `source: Optional[ErrorsSource]` - `parameter: Optional[str]` - `parameter_value_index: Optional[int]` - `pointer: Optional[str]` - `includes_discoveries_until: Optional[str]` - `last_attempted_update_at: Optional[str]` - `last_successful_update_at: Optional[str]` ### Catalog Sync Create Response - `class CatalogSyncCreateResponse: …` - `id: str` - `description: str` - `destination_id: str` - `destination_type: Literal["NONE", "ZERO_TRUST_LIST"]` - `"NONE"` - `"ZERO_TRUST_LIST"` - `last_user_update_at: str` - `name: str` - `policy: str` - `update_mode: Literal["AUTO", "MANUAL"]` - `"AUTO"` - `"MANUAL"` - `errors: Optional[Dict[str, Errors]]` - `code: Literal[1001, 1002, 1003, 152 more]` - `1001` - `1002` - `1003` - `1004` - `1005` - `1006` - `1007` - `1008` - `1009` - `1010` - `1011` - `1012` - `1013` - `1014` - `1015` - `1016` - `1017` - `1018` - `2001` - `2002` - `2003` - `2004` - `2005` - `2006` - `2007` - `2008` - `2009` - `2010` - `2011` - `2012` - `2013` - `2014` - `2015` - `2016` - `2017` - `2018` - `2019` - `2020` - `2021` - `2022` - `3001` - `3002` - `3003` - `3004` - `3005` - `3006` - `3007` - `4001` - `4002` - `4003` - `4004` - `4005` - `4006` - `4007` - `4008` - `4009` - `4010` - `4011` - `4012` - `4013` - `4014` - `4015` - `4016` - `4017` - `4018` - `4019` - `4020` - `4021` - `4022` - `4023` - `5001` - `5002` - `5003` - `5004` - `102000` - `102001` - `102002` - `102003` - `102004` - `102005` - `102006` - `102007` - `102008` - `102009` - `102010` - `102011` - `102012` - `102013` - `102014` - `102015` - `102016` - `102017` - `102018` - `102019` - `102020` - `102021` - `102022` - `102023` - `102024` - `102025` - `102026` - `102027` - `102028` - `102029` - `102030` - `102031` - `102032` - `102033` - `102034` - `102035` - `102036` - `102037` - `102038` - `102039` - `102040` - `102041` - `102042` - `102043` - `102044` - `102045` - `102046` - `102047` - `102048` - `102049` - `102050` - `102051` - `102052` - `102053` - `102054` - `102055` - `102056` - `102057` - `102058` - `102059` - `102060` - `102061` - `102062` - `102063` - `102064` - `102065` - `102066` - `102067` - `102068` - `102069` - `102070` - `102071` - `102072` - `103001` - `103002` - `103003` - `103004` - `103005` - `103006` - `103007` - `103008` - `message: str` - `documentation_url: Optional[str]` - `meta: Optional[ErrorsMeta]` - `l10n_key: Optional[str]` - `loggable_error: Optional[str]` - `template_data: Optional[object]` - `trace_id: Optional[str]` - `source: Optional[ErrorsSource]` - `parameter: Optional[str]` - `parameter_value_index: Optional[int]` - `pointer: Optional[str]` - `includes_discoveries_until: Optional[str]` - `last_attempted_update_at: Optional[str]` - `last_successful_update_at: Optional[str]` ### Catalog Sync Update Response - `class CatalogSyncUpdateResponse: …` - `id: str` - `description: str` - `destination_id: str` - `destination_type: Literal["NONE", "ZERO_TRUST_LIST"]` - `"NONE"` - `"ZERO_TRUST_LIST"` - `last_user_update_at: str` - `name: str` - `policy: str` - `update_mode: Literal["AUTO", "MANUAL"]` - `"AUTO"` - `"MANUAL"` - `errors: Optional[Dict[str, Errors]]` - `code: Literal[1001, 1002, 1003, 152 more]` - `1001` - `1002` - `1003` - `1004` - `1005` - `1006` - `1007` - `1008` - `1009` - `1010` - `1011` - `1012` - `1013` - `1014` - `1015` - `1016` - `1017` - `1018` - `2001` - `2002` - `2003` - `2004` - `2005` - `2006` - `2007` - `2008` - `2009` - `2010` - `2011` - `2012` - `2013` - `2014` - `2015` - `2016` - `2017` - `2018` - `2019` - `2020` - `2021` - `2022` - `3001` - `3002` - `3003` - `3004` - `3005` - `3006` - `3007` - `4001` - `4002` - `4003` - `4004` - `4005` - `4006` - `4007` - `4008` - `4009` - `4010` - `4011` - `4012` - `4013` - `4014` - `4015` - `4016` - `4017` - `4018` - `4019` - `4020` - `4021` - `4022` - `4023` - `5001` - `5002` - `5003` - `5004` - `102000` - `102001` - `102002` - `102003` - `102004` - `102005` - `102006` - `102007` - `102008` - `102009` - `102010` - `102011` - `102012` - `102013` - `102014` - `102015` - `102016` - `102017` - `102018` - `102019` - `102020` - `102021` - `102022` - `102023` - `102024` - `102025` - `102026` - `102027` - `102028` - `102029` - `102030` - `102031` - `102032` - `102033` - `102034` - `102035` - `102036` - `102037` - `102038` - `102039` - `102040` - `102041` - `102042` - `102043` - `102044` - `102045` - `102046` - `102047` - `102048` - `102049` - `102050` - `102051` - `102052` - `102053` - `102054` - `102055` - `102056` - `102057` - `102058` - `102059` - `102060` - `102061` - `102062` - `102063` - `102064` - `102065` - `102066` - `102067` - `102068` - `102069` - `102070` - `102071` - `102072` - `103001` - `103002` - `103003` - `103004` - `103005` - `103006` - `103007` - `103008` - `message: str` - `documentation_url: Optional[str]` - `meta: Optional[ErrorsMeta]` - `l10n_key: Optional[str]` - `loggable_error: Optional[str]` - `template_data: Optional[object]` - `trace_id: Optional[str]` - `source: Optional[ErrorsSource]` - `parameter: Optional[str]` - `parameter_value_index: Optional[int]` - `pointer: Optional[str]` - `includes_discoveries_until: Optional[str]` - `last_attempted_update_at: Optional[str]` - `last_successful_update_at: Optional[str]` ### Catalog Sync Edit Response - `class CatalogSyncEditResponse: …` - `id: str` - `description: str` - `destination_id: str` - `destination_type: Literal["NONE", "ZERO_TRUST_LIST"]` - `"NONE"` - `"ZERO_TRUST_LIST"` - `last_user_update_at: str` - `name: str` - `policy: str` - `update_mode: Literal["AUTO", "MANUAL"]` - `"AUTO"` - `"MANUAL"` - `errors: Optional[Dict[str, Errors]]` - `code: Literal[1001, 1002, 1003, 152 more]` - `1001` - `1002` - `1003` - `1004` - `1005` - `1006` - `1007` - `1008` - `1009` - `1010` - `1011` - `1012` - `1013` - `1014` - `1015` - `1016` - `1017` - `1018` - `2001` - `2002` - `2003` - `2004` - `2005` - `2006` - `2007` - `2008` - `2009` - `2010` - `2011` - `2012` - `2013` - `2014` - `2015` - `2016` - `2017` - `2018` - `2019` - `2020` - `2021` - `2022` - `3001` - `3002` - `3003` - `3004` - `3005` - `3006` - `3007` - `4001` - `4002` - `4003` - `4004` - `4005` - `4006` - `4007` - `4008` - `4009` - `4010` - `4011` - `4012` - `4013` - `4014` - `4015` - `4016` - `4017` - `4018` - `4019` - `4020` - `4021` - `4022` - `4023` - `5001` - `5002` - `5003` - `5004` - `102000` - `102001` - `102002` - `102003` - `102004` - `102005` - `102006` - `102007` - `102008` - `102009` - `102010` - `102011` - `102012` - `102013` - `102014` - `102015` - `102016` - `102017` - `102018` - `102019` - `102020` - `102021` - `102022` - `102023` - `102024` - `102025` - `102026` - `102027` - `102028` - `102029` - `102030` - `102031` - `102032` - `102033` - `102034` - `102035` - `102036` - `102037` - `102038` - `102039` - `102040` - `102041` - `102042` - `102043` - `102044` - `102045` - `102046` - `102047` - `102048` - `102049` - `102050` - `102051` - `102052` - `102053` - `102054` - `102055` - `102056` - `102057` - `102058` - `102059` - `102060` - `102061` - `102062` - `102063` - `102064` - `102065` - `102066` - `102067` - `102068` - `102069` - `102070` - `102071` - `102072` - `103001` - `103002` - `103003` - `103004` - `103005` - `103006` - `103007` - `103008` - `message: str` - `documentation_url: Optional[str]` - `meta: Optional[ErrorsMeta]` - `l10n_key: Optional[str]` - `loggable_error: Optional[str]` - `template_data: Optional[object]` - `trace_id: Optional[str]` - `source: Optional[ErrorsSource]` - `parameter: Optional[str]` - `parameter_value_index: Optional[int]` - `pointer: Optional[str]` - `includes_discoveries_until: Optional[str]` - `last_attempted_update_at: Optional[str]` - `last_successful_update_at: Optional[str]` ### Catalog Sync Delete Response - `class CatalogSyncDeleteResponse: …` - `id: str` ### Catalog Sync Refresh Response - `str` # Prebuilt Policies ## List Prebuilt Policies `magic_cloud_networking.catalog_syncs.prebuilt_policies.list(PrebuiltPolicyListParams**kwargs) -> SyncSinglePage[PrebuiltPolicyListResponse]` **get** `/accounts/{account_id}/magic/cloud/catalog-syncs/prebuilt-policies` List prebuilt catalog sync policies (Closed Beta). ### Parameters - `account_id: str` - `destination_type: Optional[Literal["NONE", "ZERO_TRUST_LIST"]]` Specify type of destination, omit to return all. - `"NONE"` - `"ZERO_TRUST_LIST"` ### Returns - `class PrebuiltPolicyListResponse: …` - `applicable_destinations: List[Literal["NONE", "ZERO_TRUST_LIST"]]` - `"NONE"` - `"ZERO_TRUST_LIST"` - `policy_description: str` - `policy_name: str` - `policy_string: str` ### Example ```python import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) page = client.magic_cloud_networking.catalog_syncs.prebuilt_policies.list( account_id="account_id", ) page = page.result[0] print(page.applicable_destinations) ``` #### Response ```json { "errors": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "messages": [ { "code": 1001, "message": "message", "documentation_url": "documentation_url", "meta": { "l10n_key": "l10n_key", "loggable_error": "loggable_error", "template_data": {}, "trace_id": "trace_id" }, "source": { "parameter": "parameter", "parameter_value_index": 0, "pointer": "pointer" } } ], "result": [ { "applicable_destinations": [ "NONE" ], "policy_description": "policy_description", "policy_name": "policy_name", "policy_string": "policy_string" } ], "success": true } ``` ## Domain Types ### Prebuilt Policy List Response - `class PrebuiltPolicyListResponse: …` - `applicable_destinations: List[Literal["NONE", "ZERO_TRUST_LIST"]]` - `"NONE"` - `"ZERO_TRUST_LIST"` - `policy_description: str` - `policy_name: str` - `policy_string: str`