cloudflare 5.5.0

v5.5.0

on Python PyPI

5.5.0 (2026-07-10)

Full Changelog: v5.4.0...v5.5.0

Breaking Changes

• ssl: The recommendations sub-resource has been removed. client.ssl.recommendations.get() and the RecommendationGetResponse type are no longer available.
• email_routing: The list method has been removed from client.email_routing.rules. Only create, update, delete, and get remain. The RuleListParams type has been removed.
• zero_trust: The UserPolicyCheckGeo type has been removed from cloudflare.types.zero_trust.access.applications. The geo information is now inlined as UserIdentityGeo within UserPolicyCheckListResponse.
• zero_trust: The pagination type for client.zero_trust.devices.ip_profiles.list() changed from SyncSinglePage to SyncV4PagePaginationArray. Code that relied on single-page iteration semantics may need adjustment.
• aisearch: The SourceParamsWebCrawlerStoreOptions type and the store_options field on SourceParamsWebCrawler have been removed from instance create/update params and responses. The parse_type enum value "feed-rss" has been removed (only "sitemap" and "crawl" remain). The search_query field on InstanceSearchResponse and NamespaceSearchResponse changed from required str to Optional[str]. A new required query_kind field (Literal["text", "image", "multimodal"]) has been added to search responses.
• zero_trust: In Organization and related params, MfaSSHPivKeyRequirements has been renamed to MfaPivKeyRequirements, the mfa_ssh_piv_key_requirements field has been renamed to mfa_piv_key_requirements, and the allowed_authenticators enum value "ssh_piv_key" has been changed to "piv_key".

Features

• email_auth: add email_auth resource (43fb66a)
• moq: add moq resource (c409a18)
• logs: add log_explorer sub-resource with query, datasets, and available datasets (b8896ca)
• email_security: add bulk message operations to investigate (e96350d)
• aisearch: add multimodal support with image_url content parts and new @cf/qwen/qwen3-vl-embedding-2b embedding model (de12426)
• zero_trust: add Worker destination types (WorkerDestination, PreviewWorkerDestination, AllWorkersDestination, AllPreviewWorkersDestination) to Access applications and eager_redirect_cookie_setting field to self-hosted applications (de12426)
• magic_transit: add primary and site_id fields to connector create/edit params (de12426)
• rulesets: add Vary cache settings with ActionParametersVary, ActionParametersVaryDefault, and ActionParametersVaryHeaders types (de12426)
• cloudforce_one: threat_events.datasets.list() now accepts optional params (de12426)
• email_security: add expected_disposition param to investigate.move.create() and investigate.move.bulk() (de12426)
• email_routing: add support_subaddress field to Settings response type (de12426)
• zero_trust: add max_ttl_secs field to GatewayConfigurationSettings and new MaxTTL type to gateway Location for DNS TTL cap control (de12426)
• zero_trust: add GlobalAcceleration type to default and custom device policy settings (de12426)
• accounts: add category field to PermissionGroupGetResponse and PermissionGroupListResponse for account and user tokens (de12426)

New Resources

EmailAuth (client.email_auth)

DMARC report management and SPF inspection for email authentication.

DMARCReports (client.email_auth.dmarc_reports)

• edit(*, zone_id, **params) -> Optional[DMARCReportEditResponse]
• get(*, zone_id) -> Optional[DMARCReportGetResponse]

New types:

from cloudflare.types.email_auth import DMARCReportEditResponse, DMARCReportGetResponse

SPF Inspect (client.email_auth.spf.inspect)

• get(*, zone_id, **params) -> Optional[InspectGetResponse]

New types:

from cloudflare.types.email_auth.spf import InspectGetResponse

MoQ (client.moq)

Media over QUIC relay management.

Relays (client.moq.relays)

• create(*, account_id, **params) -> Optional[RelayCreateResponse]
• update(relay_id, *, account_id, **params) -> Optional[RelayUpdateResponse]
• list(*, account_id, **params) -> SyncSinglePage[RelayListResponse]
• delete(relay_id, *, account_id) -> object
• get(relay_id, *, account_id) -> Optional[RelayGetResponse]

New types:

from cloudflare.types.moq import (
    RelayCreateResponse,
    RelayUpdateResponse,
    RelayListResponse,
    RelayGetResponse,
)

Tokens (client.moq.relays.tokens)

• rotate(relay_id, *, account_id, **params) -> Optional[TokenRotateResponse]

New types:

from cloudflare.types.moq.relays import TokenRotateResponse

Log Explorer (client.logs.log_explorer)

SQL-based log querying and dataset management.

Query (client.logs.log_explorer.query)

• sql(body, *, account_id, zone_id, **params) -> SyncSinglePage[QuerySqlResponse]

New types:

from cloudflare.types.logs.log_explorer import QuerySqlResponse

Datasets (client.logs.log_explorer.datasets)

• create(*, account_id, zone_id, **params) -> Optional[Dataset]
• update(dataset_id, *, account_id, zone_id, **params) -> Optional[Dataset]
• list(*, account_id, zone_id, **params) -> SyncSinglePage[DatasetSummary]
• get(dataset_id, *, account_id, zone_id) -> Optional[Dataset]

Available (client.logs.log_explorer.datasets.available)

• list(*, account_id, zone_id) -> SyncSinglePage[AvailableDataset]

New types:

from cloudflare.types.logs.log_explorer import (
    Dataset,
    DatasetSummary,
    CreateRequest,
    UpdateRequest,
)
from cloudflare.types.logs.log_explorer.datasets import AvailableDataset, AvailableList

Email Security Investigate Bulk (client.email_security.investigate.bulk)

Bulk message movement and quarantine release operations.

• create(*, account_id, **params) -> BulkCreateResponse
• list(*, account_id, **params) -> SyncV4PagePaginationArray[BulkListResponse]
• delete(job_id, *, account_id) -> BulkDeleteResponse
• get(job_id, *, account_id) -> BulkGetResponse

Cancel (client.email_security.investigate.bulk.cancel)

• create(job_id, *, account_id) -> CancelCreateResponse

Messages (client.email_security.investigate.bulk.messages)

• list(job_id, *, account_id, **params) -> SyncV4PagePaginationArray[MessageListResponse]

New types:

from cloudflare.types.email_security.investigate import (
    BulkCreateResponse,
    BulkListResponse,
    BulkDeleteResponse,
    BulkGetResponse,
)
from cloudflare.types.email_security.investigate.bulk import (
    CancelCreateResponse,
    MessageListResponse,
)

Chores

• billing: update generated types and methods (de12426)
• pipelines: update generated types and methods (de12426)
• workers: update generated types and methods (de12426)