---
title: Registries
---

[Skip to content](#_top)

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

[Containers](https://developers.cloudflare.com/api/python/resources/containers)

Copy Markdown

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

---

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

# Registries

##### [Get the list of configured registries in the account](https://developers.cloudflare.com/api/python/resources/containers/subresources/registries/methods/list)

containers.registries.list(RegistryListParams\*\*kwargs) -> SyncSinglePage\[[RegistryListResponse](<https://developers.cloudflare.com/api/python/resources/containers#(resource)%20containers.registries%20%3E%20(model)%20registry_list_response%20%3E%20(schema)>)]

GET/accounts/{account\_id}/containers/registries

##### [Configure a private external image registry](https://developers.cloudflare.com/api/python/resources/containers/subresources/registries/methods/create)

containers.registries.create(RegistryCreateParams\*\*kwargs) -> [RegistryCreateResponse](<https://developers.cloudflare.com/api/python/resources/containers#(resource)%20containers.registries%20%3E%20(model)%20registry_create_response%20%3E%20(schema)>)

POST/accounts/{account\_id}/containers/registries

##### [Delete a registry from the account](https://developers.cloudflare.com/api/python/resources/containers/subresources/registries/methods/delete)

containers.registries.delete(strdomain, RegistryDeleteParams\*\*kwargs) -> [RegistryDeleteResponse](<https://developers.cloudflare.com/api/python/resources/containers#(resource)%20containers.registries%20%3E%20(model)%20registry_delete_response%20%3E%20(schema)>)

DELETE/accounts/{account\_id}/containers/registries/{domain}

##### ModelsExpand Collapse

<details>

<summary>

class RegistryListResponse: …

An image registry added in a customer account.

</summary>

created\_at: str

UTC timestamp string in ISO 8601 format.

<a href="#(resource)%20containers.registries%20%3E%20(model)%20registry_list_response%20%3E%20(schema)%20%3E%20(property)%20created_at">Link to this property</a>

domain: str

A string representation of a domain name. See RFC-1034 (<a href="https://www.ietf.org/rfc/rfc1034.txt">https://www.ietf.org/rfc/rfc1034.txt</a>). Consider that the limit of a domain name is min 3 and max 253 ASCII characters.

<a href="#(resource)%20containers.registries%20%3E%20(model)%20registry_list_response%20%3E%20(schema)%20%3E%20(property)%20domain">Link to this property</a>

<details>

<summary>

kind: Optional\[Literal\["ECR", "DockerHub", "GAR", "default"]]

The type of registry that is being configured.

</summary>

One of the following:

"ECR"

<a href="#(resource)%20containers.registries%20%3E%20(model)%20registry_list_response%20%3E%20(schema)%20%3E%20(property)%20kind%20%3E%20(member)%200">Link to this property</a>

"DockerHub"

<a href="#(resource)%20containers.registries%20%3E%20(model)%20registry_list_response%20%3E%20(schema)%20%3E%20(property)%20kind%20%3E%20(member)%201">Link to this property</a>

"GAR"

<a href="#(resource)%20containers.registries%20%3E%20(model)%20registry_list_response%20%3E%20(schema)%20%3E%20(property)%20kind%20%3E%20(member)%202">Link to this property</a>

"default"

<a href="#(resource)%20containers.registries%20%3E%20(model)%20registry_list_response%20%3E%20(schema)%20%3E%20(property)%20kind%20%3E%20(member)%203">Link to this property</a>

</details>

<a href="#(resource)%20containers.registries%20%3E%20(model)%20registry_list_response%20%3E%20(schema)%20%3E%20(property)%20kind">Link to this property</a>

public\_key: Optional\[str]

Public component of the registry credentials. For managed registries this is a base64-encoded public key; for external registries the format depends on the registry provider.

<a href="#(resource)%20containers.registries%20%3E%20(model)%20registry_list_response%20%3E%20(schema)%20%3E%20(property)%20public_key">Link to this property</a>

</details>

[Link to this property](<#(resource)%20containers.registries%20%3E%20(model)%20registry_list_response%20%3E%20(schema)>)

<details>

<summary>

class RegistryCreateResponse: …

An image registry added in a customer account.

</summary>

created\_at: str

UTC timestamp string in ISO 8601 format.

<a href="#(resource)%20containers.registries%20%3E%20(model)%20registry_create_response%20%3E%20(schema)%20%3E%20(property)%20created_at">Link to this property</a>

domain: str

A string representation of a domain name. See RFC-1034 (<a href="https://www.ietf.org/rfc/rfc1034.txt">https://www.ietf.org/rfc/rfc1034.txt</a>). Consider that the limit of a domain name is min 3 and max 253 ASCII characters.

<a href="#(resource)%20containers.registries%20%3E%20(model)%20registry_create_response%20%3E%20(schema)%20%3E%20(property)%20domain">Link to this property</a>

<details>

<summary>

kind: Optional\[Literal\["ECR", "DockerHub", "GAR", "default"]]

The type of registry that is being configured.

</summary>

One of the following:

"ECR"

<a href="#(resource)%20containers.registries%20%3E%20(model)%20registry_create_response%20%3E%20(schema)%20%3E%20(property)%20kind%20%3E%20(member)%200">Link to this property</a>

"DockerHub"

<a href="#(resource)%20containers.registries%20%3E%20(model)%20registry_create_response%20%3E%20(schema)%20%3E%20(property)%20kind%20%3E%20(member)%201">Link to this property</a>

"GAR"

<a href="#(resource)%20containers.registries%20%3E%20(model)%20registry_create_response%20%3E%20(schema)%20%3E%20(property)%20kind%20%3E%20(member)%202">Link to this property</a>

"default"

<a href="#(resource)%20containers.registries%20%3E%20(model)%20registry_create_response%20%3E%20(schema)%20%3E%20(property)%20kind%20%3E%20(member)%203">Link to this property</a>

</details>

<a href="#(resource)%20containers.registries%20%3E%20(model)%20registry_create_response%20%3E%20(schema)%20%3E%20(property)%20kind">Link to this property</a>

public\_key: Optional\[str]

Public component of the registry credentials. For managed registries this is a base64-encoded public key; for external registries the format depends on the registry provider.

<a href="#(resource)%20containers.registries%20%3E%20(model)%20registry_create_response%20%3E%20(schema)%20%3E%20(property)%20public_key">Link to this property</a>

</details>

[Link to this property](<#(resource)%20containers.registries%20%3E%20(model)%20registry_create_response%20%3E%20(schema)>)

<details>

<summary>

class RegistryDeleteResponse: …

Result of deleting an image registry from a Containers account.

</summary>

domain: str

A string representation of a domain name. See RFC-1034 (<a href="https://www.ietf.org/rfc/rfc1034.txt">https://www.ietf.org/rfc/rfc1034.txt</a>). Consider that the limit of a domain name is min 3 and max 253 ASCII characters.

<a href="#(resource)%20containers.registries%20%3E%20(model)%20registry_delete_response%20%3E%20(schema)%20%3E%20(property)%20domain">Link to this property</a>

</details>

[Link to this property](<#(resource)%20containers.registries%20%3E%20(model)%20registry_delete_response%20%3E%20(schema)>)

#### RegistriesCredentials

##### [Generate a JWT to interact with the specified image registry.](https://developers.cloudflare.com/api/python/resources/containers/subresources/registries/subresources/credentials/methods/generate)

containers.registries.credentials.generate(strdomain, CredentialGenerateParams\*\*kwargs) -> [CredentialGenerateResponse](<https://developers.cloudflare.com/api/python/resources/containers#(resource)%20containers.registries.credentials%20%3E%20(model)%20credential_generate_response%20%3E%20(schema)>)

POST/accounts/{account\_id}/containers/registries/{domain}/credentials

##### ModelsExpand Collapse

<details>

<summary>

class CredentialGenerateResponse: …

Credentials returned for an authenticated registry configured on a Containers account.

</summary>

account\_id: str

A unique identifier for the user’s account.

<a href="#(resource)%20containers.registries.credentials%20%3E%20(model)%20credential_generate_response%20%3E%20(schema)%20%3E%20(property)%20account_id">Link to this property</a>

password: str

The password to use when authenticating to the image registry.

<a href="#(resource)%20containers.registries.credentials%20%3E%20(model)%20credential_generate_response%20%3E%20(schema)%20%3E%20(property)%20password">Link to this property</a>

registry\_host: str

The domain of the image registry these credentials target.

<a href="#(resource)%20containers.registries.credentials%20%3E%20(model)%20credential_generate_response%20%3E%20(schema)%20%3E%20(property)%20registry_host">Link to this property</a>

username: str

The username to use when authenticating to the image registry.

<a href="#(resource)%20containers.registries.credentials%20%3E%20(model)%20credential_generate_response%20%3E%20(schema)%20%3E%20(property)%20username">Link to this property</a>

</details>

[Link to this property](<#(resource)%20containers.registries.credentials%20%3E%20(model)%20credential_generate_response%20%3E%20(schema)>)