---
title: Fallback Origin
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/python)

[Custom Hostnames](https://developers.cloudflare.com/api/python/resources/custom_hostnames)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# Fallback Origin

##### [Get Fallback Origin for Custom Hostnames](https://developers.cloudflare.com/api/python/resources/custom_hostnames/subresources/fallback_origin/methods/get)

custom\_hostnames.fallback\_origin.get(FallbackOriginGetParams\*\*kwargs) -> [FallbackOriginGetResponse](<https://developers.cloudflare.com/api/python/resources/custom_hostnames#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_get_response%20%3E%20(schema)>)

GET/zones/{zone\_id}/custom\_hostnames/fallback\_origin

##### [Update Fallback Origin for Custom Hostnames](https://developers.cloudflare.com/api/python/resources/custom_hostnames/subresources/fallback_origin/methods/update)

custom\_hostnames.fallback\_origin.update(FallbackOriginUpdateParams\*\*kwargs) -> [FallbackOriginUpdateResponse](<https://developers.cloudflare.com/api/python/resources/custom_hostnames#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_update_response%20%3E%20(schema)>)

PUT/zones/{zone\_id}/custom\_hostnames/fallback\_origin

##### [Delete Fallback Origin for Custom Hostnames](https://developers.cloudflare.com/api/python/resources/custom_hostnames/subresources/fallback_origin/methods/delete)

custom\_hostnames.fallback\_origin.delete(FallbackOriginDeleteParams\*\*kwargs) -> [FallbackOriginDeleteResponse](<https://developers.cloudflare.com/api/python/resources/custom_hostnames#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_delete_response%20%3E%20(schema)>)

DELETE/zones/{zone\_id}/custom\_hostnames/fallback\_origin

##### ModelsExpand Collapse

<details>

<summary>

class FallbackOriginGetResponse: …

</summary>

created\_at: Optional\[datetime]

This is the time the fallback origin was created.

formatdate-time

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_get_response%20%3E%20(schema)%20%3E%20(property)%20created_at">Link to this property</a>

errors: Optional\[List\[str]]

These are errors that were encountered while trying to activate a fallback origin.

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_get_response%20%3E%20(schema)%20%3E%20(property)%20errors">Link to this property</a>

origin: Optional\[str]

Your origin hostname that requests to your custom hostnames will be sent to.

maxLength255

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_get_response%20%3E%20(schema)%20%3E%20(property)%20origin">Link to this property</a>

<details>

<summary>

status: Optional\[Literal\["initializing", "pending\_deployment", "pending\_deletion", 3 more]]

Status of the fallback origin’s activation.

</summary>

One of the following:

"initializing"

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_get_response%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%200">Link to this property</a>

"pending\_deployment"

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_get_response%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%201">Link to this property</a>

"pending\_deletion"

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_get_response%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%202">Link to this property</a>

"active"

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_get_response%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%203">Link to this property</a>

"deployment\_timed\_out"

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_get_response%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%204">Link to this property</a>

"deletion\_timed\_out"

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_get_response%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%205">Link to this property</a>

</details>

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_get_response%20%3E%20(schema)%20%3E%20(property)%20status">Link to this property</a>

updated\_at: Optional\[datetime]

This is the time the fallback origin was updated.

formatdate-time

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_get_response%20%3E%20(schema)%20%3E%20(property)%20updated_at">Link to this property</a>

</details>

[Link to this property](<#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_get_response%20%3E%20(schema)>)

<details>

<summary>

class FallbackOriginUpdateResponse: …

</summary>

created\_at: Optional\[datetime]

This is the time the fallback origin was created.

formatdate-time

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_update_response%20%3E%20(schema)%20%3E%20(property)%20created_at">Link to this property</a>

errors: Optional\[List\[str]]

These are errors that were encountered while trying to activate a fallback origin.

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_update_response%20%3E%20(schema)%20%3E%20(property)%20errors">Link to this property</a>

origin: Optional\[str]

Your origin hostname that requests to your custom hostnames will be sent to.

maxLength255

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_update_response%20%3E%20(schema)%20%3E%20(property)%20origin">Link to this property</a>

<details>

<summary>

status: Optional\[Literal\["initializing", "pending\_deployment", "pending\_deletion", 3 more]]

Status of the fallback origin’s activation.

</summary>

One of the following:

"initializing"

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_update_response%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%200">Link to this property</a>

"pending\_deployment"

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_update_response%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%201">Link to this property</a>

"pending\_deletion"

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_update_response%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%202">Link to this property</a>

"active"

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_update_response%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%203">Link to this property</a>

"deployment\_timed\_out"

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_update_response%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%204">Link to this property</a>

"deletion\_timed\_out"

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_update_response%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%205">Link to this property</a>

</details>

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_update_response%20%3E%20(schema)%20%3E%20(property)%20status">Link to this property</a>

updated\_at: Optional\[datetime]

This is the time the fallback origin was updated.

formatdate-time

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_update_response%20%3E%20(schema)%20%3E%20(property)%20updated_at">Link to this property</a>

</details>

[Link to this property](<#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_update_response%20%3E%20(schema)>)

<details>

<summary>

class FallbackOriginDeleteResponse: …

</summary>

created\_at: Optional\[datetime]

This is the time the fallback origin was created.

formatdate-time

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_delete_response%20%3E%20(schema)%20%3E%20(property)%20created_at">Link to this property</a>

errors: Optional\[List\[str]]

These are errors that were encountered while trying to activate a fallback origin.

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_delete_response%20%3E%20(schema)%20%3E%20(property)%20errors">Link to this property</a>

origin: Optional\[str]

Your origin hostname that requests to your custom hostnames will be sent to.

maxLength255

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_delete_response%20%3E%20(schema)%20%3E%20(property)%20origin">Link to this property</a>

<details>

<summary>

status: Optional\[Literal\["initializing", "pending\_deployment", "pending\_deletion", 3 more]]

Status of the fallback origin’s activation.

</summary>

One of the following:

"initializing"

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_delete_response%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%200">Link to this property</a>

"pending\_deployment"

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_delete_response%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%201">Link to this property</a>

"pending\_deletion"

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_delete_response%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%202">Link to this property</a>

"active"

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_delete_response%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%203">Link to this property</a>

"deployment\_timed\_out"

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_delete_response%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%204">Link to this property</a>

"deletion\_timed\_out"

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_delete_response%20%3E%20(schema)%20%3E%20(property)%20status%20%3E%20(member)%205">Link to this property</a>

</details>

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_delete_response%20%3E%20(schema)%20%3E%20(property)%20status">Link to this property</a>

updated\_at: Optional\[datetime]

This is the time the fallback origin was updated.

formatdate-time

<a href="#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_delete_response%20%3E%20(schema)%20%3E%20(property)%20updated_at">Link to this property</a>

</details>

[Link to this property](<#(resource)%20custom_hostnames.fallback_origin%20%3E%20(model)%20fallback_origin_delete_response%20%3E%20(schema)>)