Skip to content
Cloudflare API
Start here
API Reference
Magic Cloud Networking

Catalog Syncs

List Catalog Syncs
magic_cloud_networking.catalog_syncs.list(CatalogSyncListParams**kwargs) -> SyncSinglePage[CatalogSyncListResponse]
GET/accounts/{account_id}/magic/cloud/catalog-syncs
Read Catalog Sync
magic_cloud_networking.catalog_syncs.get(strsync_id, CatalogSyncGetParams**kwargs) -> CatalogSyncGetResponse
GET/accounts/{account_id}/magic/cloud/catalog-syncs/{sync_id}
Create Catalog Sync
magic_cloud_networking.catalog_syncs.create(CatalogSyncCreateParams**kwargs) -> CatalogSyncCreateResponse
POST/accounts/{account_id}/magic/cloud/catalog-syncs
Update Catalog Sync
magic_cloud_networking.catalog_syncs.update(strsync_id, CatalogSyncUpdateParams**kwargs) -> CatalogSyncUpdateResponse
PUT/accounts/{account_id}/magic/cloud/catalog-syncs/{sync_id}
Patch Catalog Sync
magic_cloud_networking.catalog_syncs.edit(strsync_id, CatalogSyncEditParams**kwargs) -> CatalogSyncEditResponse
PATCH/accounts/{account_id}/magic/cloud/catalog-syncs/{sync_id}
Delete Catalog Sync
magic_cloud_networking.catalog_syncs.delete(strsync_id, CatalogSyncDeleteParams**kwargs) -> CatalogSyncDeleteResponse
DELETE/accounts/{account_id}/magic/cloud/catalog-syncs/{sync_id}
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
ModelsExpand Collapse
class CatalogSyncListResponse: …
id: str
formatuuid
description: str
destination_id: str
formatuuid
destination_type: Literal["NONE", "ZERO_TRUST_LIST"]
One of the following:
"NONE"
"ZERO_TRUST_LIST"
last_user_update_at: str
name: str
policy: str
update_mode: Literal["AUTO", "MANUAL"]
One of the following:
"AUTO"
"MANUAL"
errors: Optional[Dict[str, Errors]]
code: Literal[1001, 1002, 1003, 152 more]
One of the following:
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]
class CatalogSyncGetResponse: …
id: str
formatuuid
description: str
destination_id: str
formatuuid
destination_type: Literal["NONE", "ZERO_TRUST_LIST"]
One of the following:
"NONE"
"ZERO_TRUST_LIST"
last_user_update_at: str
name: str
policy: str
update_mode: Literal["AUTO", "MANUAL"]
One of the following:
"AUTO"
"MANUAL"
errors: Optional[Dict[str, Errors]]
code: Literal[1001, 1002, 1003, 152 more]
One of the following:
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]
class CatalogSyncCreateResponse: …
id: str
formatuuid
description: str
destination_id: str
formatuuid
destination_type: Literal["NONE", "ZERO_TRUST_LIST"]
One of the following:
"NONE"
"ZERO_TRUST_LIST"
last_user_update_at: str
name: str
policy: str
update_mode: Literal["AUTO", "MANUAL"]
One of the following:
"AUTO"
"MANUAL"
errors: Optional[Dict[str, Errors]]
code: Literal[1001, 1002, 1003, 152 more]
One of the following:
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]
class CatalogSyncUpdateResponse: …
id: str
formatuuid
description: str
destination_id: str
formatuuid
destination_type: Literal["NONE", "ZERO_TRUST_LIST"]
One of the following:
"NONE"
"ZERO_TRUST_LIST"
last_user_update_at: str
name: str
policy: str
update_mode: Literal["AUTO", "MANUAL"]
One of the following:
"AUTO"
"MANUAL"
errors: Optional[Dict[str, Errors]]
code: Literal[1001, 1002, 1003, 152 more]
One of the following:
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]
class CatalogSyncEditResponse: …
id: str
formatuuid
description: str
destination_id: str
formatuuid
destination_type: Literal["NONE", "ZERO_TRUST_LIST"]
One of the following:
"NONE"
"ZERO_TRUST_LIST"
last_user_update_at: str
name: str
policy: str
update_mode: Literal["AUTO", "MANUAL"]
One of the following:
"AUTO"
"MANUAL"
errors: Optional[Dict[str, Errors]]
code: Literal[1001, 1002, 1003, 152 more]
One of the following:
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]
class CatalogSyncDeleteResponse: …
id: str
formatuuid
str

Catalog SyncsPrebuilt 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
ModelsExpand Collapse
class PrebuiltPolicyListResponse: …
applicable_destinations: List[Literal["NONE", "ZERO_TRUST_LIST"]]
One of the following:
"NONE"
"ZERO_TRUST_LIST"
policy_description: str
policy_name: str
policy_string: str