--- title: Web3 --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Web3 #### Web3Hostnames ##### [List Web3 Hostnames](https://developers.cloudflare.com/api/python/resources/web3/subresources/hostnames/methods/list) web3.hostnames.list(HostnameListParams\*\*kwargs) -> SyncSinglePage\[[Hostname]()] GET/zones/{zone\_id}/web3/hostnames ##### [Web3 Hostname Details](https://developers.cloudflare.com/api/python/resources/web3/subresources/hostnames/methods/get) web3.hostnames.get(stridentifier, HostnameGetParams\*\*kwargs) -> [Hostname]() GET/zones/{zone\_id}/web3/hostnames/{identifier} ##### [Create Web3 Hostname](https://developers.cloudflare.com/api/python/resources/web3/subresources/hostnames/methods/create) web3.hostnames.create(HostnameCreateParams\*\*kwargs) -> [Hostname]() POST/zones/{zone\_id}/web3/hostnames ##### [Edit Web3 Hostname](https://developers.cloudflare.com/api/python/resources/web3/subresources/hostnames/methods/edit) web3.hostnames.edit(stridentifier, HostnameEditParams\*\*kwargs) -> [Hostname]() PATCH/zones/{zone\_id}/web3/hostnames/{identifier} ##### [Delete Web3 Hostname](https://developers.cloudflare.com/api/python/resources/web3/subresources/hostnames/methods/delete) web3.hostnames.delete(stridentifier, HostnameDeleteParams\*\*kwargs) -> [HostnameDeleteResponse]() DELETE/zones/{zone\_id}/web3/hostnames/{identifier} ##### ModelsExpand Collapse
class Hostname: … id: Optional\[str] Specify the identifier of the hostname. maxLength32 Link to this property created\_on: Optional\[datetime] formatdate-time Link to this property description: Optional\[str] Specify an optional description of the hostname. maxLength500 Link to this property dnslink: Optional\[str] Specify the DNSLink value used if the target is ipfs. Link to this property modified\_on: Optional\[datetime] formatdate-time Link to this property name: Optional\[str] Specify the hostname that points to the target gateway via CNAME. maxLength255 Link to this property
status: Optional\[Literal\["active", "pending", "deleting", "error"]] Specifies the status of the hostname’s activation. One of the following: "active" Link to this property "pending" Link to this property "deleting" Link to this property "error" Link to this property
Link to this property
target: Optional\[Literal\["ethereum", "ipfs", "ipfs\_universal\_path"]] Specify the target gateway of the hostname. One of the following: "ethereum" Link to this property "ipfs" Link to this property "ipfs\_universal\_path" Link to this property
Link to this property
[Link to this property](<#(resource)%20web3.hostnames%20%3E%20(model)%20hostname%20%3E%20(schema)>)
class HostnameDeleteResponse: … id: str Specify the identifier of the hostname. maxLength32 Link to this property
[Link to this property](<#(resource)%20web3.hostnames%20%3E%20(model)%20hostname_delete_response%20%3E%20(schema)>) #### Web3HostnamesIPFS Universal Paths #### Web3HostnamesIPFS Universal PathsContent Lists ##### [IPFS Universal Path Gateway Content List Details](https://developers.cloudflare.com/api/python/resources/web3/subresources/hostnames/subresources/ipfs_universal_paths/subresources/content_lists/methods/get) web3.hostnames.ipfs\_universal\_paths.content\_lists.get(stridentifier, ContentListGetParams\*\*kwargs) -> [ContentList]() GET/zones/{zone\_id}/web3/hostnames/{identifier}/ipfs\_universal\_path/content\_list ##### [Update IPFS Universal Path Gateway Content List](https://developers.cloudflare.com/api/python/resources/web3/subresources/hostnames/subresources/ipfs_universal_paths/subresources/content_lists/methods/update) web3.hostnames.ipfs\_universal\_paths.content\_lists.update(stridentifier, ContentListUpdateParams\*\*kwargs) -> [ContentList]() PUT/zones/{zone\_id}/web3/hostnames/{identifier}/ipfs\_universal\_path/content\_list ##### ModelsExpand Collapse
class ContentList: … action: Optional\[Literal\["block"]] Behavior of the content list. Link to this property
[Link to this property](<#(resource)%20web3.hostnames.ipfs_universal_paths.content_lists%20%3E%20(model)%20content_list%20%3E%20(schema)>) #### Web3HostnamesIPFS Universal PathsContent ListsEntries ##### [List IPFS Universal Path Gateway Content List Entries](https://developers.cloudflare.com/api/python/resources/web3/subresources/hostnames/subresources/ipfs_universal_paths/subresources/content_lists/subresources/entries/methods/list) web3.hostnames.ipfs\_universal\_paths.content\_lists.entries.list(stridentifier, EntryListParams\*\*kwargs) -> [EntryListResponse]() GET/zones/{zone\_id}/web3/hostnames/{identifier}/ipfs\_universal\_path/content\_list/entries ##### [IPFS Universal Path Gateway Content List Entry Details](https://developers.cloudflare.com/api/python/resources/web3/subresources/hostnames/subresources/ipfs_universal_paths/subresources/content_lists/subresources/entries/methods/get) web3.hostnames.ipfs\_universal\_paths.content\_lists.entries.get(strcontent\_list\_entry\_identifier, EntryGetParams\*\*kwargs) -> [EntryGetResponse]() GET/zones/{zone\_id}/web3/hostnames/{identifier}/ipfs\_universal\_path/content\_list/entries/{content\_list\_entry\_identifier} ##### [Create IPFS Universal Path Gateway Content List Entry](https://developers.cloudflare.com/api/python/resources/web3/subresources/hostnames/subresources/ipfs_universal_paths/subresources/content_lists/subresources/entries/methods/create) web3.hostnames.ipfs\_universal\_paths.content\_lists.entries.create(stridentifier, EntryCreateParams\*\*kwargs) -> [EntryCreateResponse]() POST/zones/{zone\_id}/web3/hostnames/{identifier}/ipfs\_universal\_path/content\_list/entries ##### [Edit IPFS Universal Path Gateway Content List Entry](https://developers.cloudflare.com/api/python/resources/web3/subresources/hostnames/subresources/ipfs_universal_paths/subresources/content_lists/subresources/entries/methods/update) web3.hostnames.ipfs\_universal\_paths.content\_lists.entries.update(strcontent\_list\_entry\_identifier, EntryUpdateParams\*\*kwargs) -> [EntryUpdateResponse]() PUT/zones/{zone\_id}/web3/hostnames/{identifier}/ipfs\_universal\_path/content\_list/entries/{content\_list\_entry\_identifier} ##### [Delete IPFS Universal Path Gateway Content List Entry](https://developers.cloudflare.com/api/python/resources/web3/subresources/hostnames/subresources/ipfs_universal_paths/subresources/content_lists/subresources/entries/methods/delete) web3.hostnames.ipfs\_universal\_paths.content\_lists.entries.delete(strcontent\_list\_entry\_identifier, EntryDeleteParams\*\*kwargs) -> [EntryDeleteResponse]() DELETE/zones/{zone\_id}/web3/hostnames/{identifier}/ipfs\_universal\_path/content\_list/entries/{content\_list\_entry\_identifier} ##### ModelsExpand Collapse
class EntryListResponse: …
entries: Optional\[List\[Entry]] Provides content list entries. id: Optional\[str] Specify the identifier of the hostname. maxLength32 Link to this property content: Optional\[str] Specify the CID or content path of content to block. maxLength500 Link to this property created\_on: Optional\[datetime] formatdate-time Link to this property description: Optional\[str] Specify an optional description of the content list entry. maxLength500 Link to this property modified\_on: Optional\[datetime] formatdate-time Link to this property
type: Optional\[Literal\["cid", "content\_path"]] Specify the type of content list entry to block. One of the following: "cid" Link to this property "content\_path" Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20web3.hostnames.ipfs_universal_paths.content_lists.entries%20%3E%20(model)%20entry_list_response%20%3E%20(schema)>)
class EntryGetResponse: … Specify a content list entry to block. id: Optional\[str] Specify the identifier of the hostname. maxLength32 Link to this property content: Optional\[str] Specify the CID or content path of content to block. maxLength500 Link to this property created\_on: Optional\[datetime] formatdate-time Link to this property description: Optional\[str] Specify an optional description of the content list entry. maxLength500 Link to this property modified\_on: Optional\[datetime] formatdate-time Link to this property
type: Optional\[Literal\["cid", "content\_path"]] Specify the type of content list entry to block. One of the following: "cid" Link to this property "content\_path" Link to this property
Link to this property
[Link to this property](<#(resource)%20web3.hostnames.ipfs_universal_paths.content_lists.entries%20%3E%20(model)%20entry_get_response%20%3E%20(schema)>)
class EntryCreateResponse: … Specify a content list entry to block. id: Optional\[str] Specify the identifier of the hostname. maxLength32 Link to this property content: Optional\[str] Specify the CID or content path of content to block. maxLength500 Link to this property created\_on: Optional\[datetime] formatdate-time Link to this property description: Optional\[str] Specify an optional description of the content list entry. maxLength500 Link to this property modified\_on: Optional\[datetime] formatdate-time Link to this property
type: Optional\[Literal\["cid", "content\_path"]] Specify the type of content list entry to block. One of the following: "cid" Link to this property "content\_path" Link to this property
Link to this property
[Link to this property](<#(resource)%20web3.hostnames.ipfs_universal_paths.content_lists.entries%20%3E%20(model)%20entry_create_response%20%3E%20(schema)>)
class EntryUpdateResponse: … Specify a content list entry to block. id: Optional\[str] Specify the identifier of the hostname. maxLength32 Link to this property content: Optional\[str] Specify the CID or content path of content to block. maxLength500 Link to this property created\_on: Optional\[datetime] formatdate-time Link to this property description: Optional\[str] Specify an optional description of the content list entry. maxLength500 Link to this property modified\_on: Optional\[datetime] formatdate-time Link to this property
type: Optional\[Literal\["cid", "content\_path"]] Specify the type of content list entry to block. One of the following: "cid" Link to this property "content\_path" Link to this property
Link to this property
[Link to this property](<#(resource)%20web3.hostnames.ipfs_universal_paths.content_lists.entries%20%3E%20(model)%20entry_update_response%20%3E%20(schema)>)
class EntryDeleteResponse: … id: str Specify the identifier of the hostname. maxLength32 Link to this property
[Link to this property](<#(resource)%20web3.hostnames.ipfs_universal_paths.content_lists.entries%20%3E%20(model)%20entry_delete_response%20%3E%20(schema)>)