--- title: Secrets Store --- [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** # Secrets Store #### Secrets StoreStores ##### [List account stores](https://developers.cloudflare.com/api/python/resources/secrets_store/subresources/stores/methods/list) secrets\_store.stores.list(StoreListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[StoreListResponse]()] GET/accounts/{account\_id}/secrets\_store/stores ##### [Get a store by ID](https://developers.cloudflare.com/api/python/resources/secrets_store/subresources/stores/methods/get) secrets\_store.stores.get(strstore\_id, StoreGetParams\*\*kwargs) -> [StoreGetResponse]() GET/accounts/{account\_id}/secrets\_store/stores/{store\_id} ##### [Create a store](https://developers.cloudflare.com/api/python/resources/secrets_store/subresources/stores/methods/create) secrets\_store.stores.create(StoreCreateParams\*\*kwargs) -> [StoreCreateResponse]() POST/accounts/{account\_id}/secrets\_store/stores ##### [Delete a store](https://developers.cloudflare.com/api/python/resources/secrets_store/subresources/stores/methods/delete) secrets\_store.stores.delete(strstore\_id, StoreDeleteParams\*\*kwargs) -> object DELETE/accounts/{account\_id}/secrets\_store/stores/{store\_id} ##### ModelsExpand Collapse
class StoreListResponse: … id: str Store Identifier. maxLength32 Link to this property created: datetime When the secret was created. formatdate-time Link to this property modified: datetime When the secret was modified. formatdate-time Link to this property name: str The name of the store. Link to this property account\_id: Optional\[str] Account Identifier. maxLength32 Link to this property
[Link to this property](<#(resource)%20secrets_store.stores%20%3E%20(model)%20store_list_response%20%3E%20(schema)>)
class StoreGetResponse: … id: str Store Identifier. maxLength32 Link to this property created: datetime When the secret was created. formatdate-time Link to this property modified: datetime When the secret was modified. formatdate-time Link to this property name: str The name of the store. Link to this property account\_id: Optional\[str] Account Identifier. maxLength32 Link to this property
[Link to this property](<#(resource)%20secrets_store.stores%20%3E%20(model)%20store_get_response%20%3E%20(schema)>)
class StoreCreateResponse: … id: str Store Identifier. maxLength32 Link to this property created: datetime When the secret was created. formatdate-time Link to this property modified: datetime When the secret was modified. formatdate-time Link to this property name: str The name of the store. Link to this property account\_id: Optional\[str] Account Identifier. maxLength32 Link to this property
[Link to this property](<#(resource)%20secrets_store.stores%20%3E%20(model)%20store_create_response%20%3E%20(schema)>) #### Secrets StoreStoresSecrets ##### [List store secrets](https://developers.cloudflare.com/api/python/resources/secrets_store/subresources/stores/subresources/secrets/methods/list) secrets\_store.stores.secrets.list(strstore\_id, SecretListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[SecretListResponse]()] GET/accounts/{account\_id}/secrets\_store/stores/{store\_id}/secrets ##### [Get a secret by ID](https://developers.cloudflare.com/api/python/resources/secrets_store/subresources/stores/subresources/secrets/methods/get) secrets\_store.stores.secrets.get(strsecret\_id, SecretGetParams\*\*kwargs) -> [SecretGetResponse]() GET/accounts/{account\_id}/secrets\_store/stores/{store\_id}/secrets/{secret\_id} ##### [Create a secret](https://developers.cloudflare.com/api/python/resources/secrets_store/subresources/stores/subresources/secrets/methods/create) secrets\_store.stores.secrets.create(strstore\_id, SecretCreateParams\*\*kwargs) -> SyncSinglePage\[[SecretCreateResponse]()] POST/accounts/{account\_id}/secrets\_store/stores/{store\_id}/secrets ##### [Patch a secret](https://developers.cloudflare.com/api/python/resources/secrets_store/subresources/stores/subresources/secrets/methods/edit) secrets\_store.stores.secrets.edit(strsecret\_id, SecretEditParams\*\*kwargs) -> [SecretEditResponse]() PATCH/accounts/{account\_id}/secrets\_store/stores/{store\_id}/secrets/{secret\_id} ##### [Delete a secret](https://developers.cloudflare.com/api/python/resources/secrets_store/subresources/stores/subresources/secrets/methods/delete) secrets\_store.stores.secrets.delete(strsecret\_id, SecretDeleteParams\*\*kwargs) -> object DELETE/accounts/{account\_id}/secrets\_store/stores/{store\_id}/secrets/{secret\_id} ##### [Delete secrets](https://developers.cloudflare.com/api/python/resources/secrets_store/subresources/stores/subresources/secrets/methods/bulk_delete) secrets\_store.stores.secrets.bulk\_delete(strstore\_id, SecretBulkDeleteParams\*\*kwargs) -> object DELETE/accounts/{account\_id}/secrets\_store/stores/{store\_id}/secrets ##### [Duplicate Secret](https://developers.cloudflare.com/api/python/resources/secrets_store/subresources/stores/subresources/secrets/methods/duplicate) secrets\_store.stores.secrets.duplicate(strsecret\_id, SecretDuplicateParams\*\*kwargs) -> [SecretDuplicateResponse]() POST/accounts/{account\_id}/secrets\_store/stores/{store\_id}/secrets/{secret\_id}/duplicate ##### ModelsExpand Collapse
class SecretListResponse: … id: str Secret identifier tag. maxLength32 Link to this property created: datetime When the secret was created. formatdate-time Link to this property modified: datetime When the secret was modified. formatdate-time Link to this property name: str The name of the secret. Link to this property
status: Literal\["pending", "active", "deleted"] One of the following: "pending" Link to this property "active" Link to this property "deleted" Link to this property
Link to this property store\_id: str Store Identifier. maxLength32 Link to this property comment: Optional\[str] Freeform text describing the secret. Link to this property
scopes: Optional\[List\[Literal\["workers", "ai\_gateway", "dex", 3 more]]] The list of services that can use this secret. One of the following: "workers" Link to this property "ai\_gateway" Link to this property "dex" Link to this property "access" Link to this property "containers" Link to this property "websearch" Link to this property
Link to this property
[Link to this property](<#(resource)%20secrets_store.stores.secrets%20%3E%20(model)%20secret_list_response%20%3E%20(schema)>)
class SecretGetResponse: … id: str Secret identifier tag. maxLength32 Link to this property created: datetime When the secret was created. formatdate-time Link to this property modified: datetime When the secret was modified. formatdate-time Link to this property name: str The name of the secret. Link to this property
status: Literal\["pending", "active", "deleted"] One of the following: "pending" Link to this property "active" Link to this property "deleted" Link to this property
Link to this property store\_id: str Store Identifier. maxLength32 Link to this property comment: Optional\[str] Freeform text describing the secret. Link to this property
scopes: Optional\[List\[Literal\["workers", "ai\_gateway", "dex", 3 more]]] The list of services that can use this secret. One of the following: "workers" Link to this property "ai\_gateway" Link to this property "dex" Link to this property "access" Link to this property "containers" Link to this property "websearch" Link to this property
Link to this property
[Link to this property](<#(resource)%20secrets_store.stores.secrets%20%3E%20(model)%20secret_get_response%20%3E%20(schema)>)
class SecretCreateResponse: … id: str Secret identifier tag. maxLength32 Link to this property created: datetime When the secret was created. formatdate-time Link to this property modified: datetime When the secret was modified. formatdate-time Link to this property name: str The name of the secret. Link to this property
status: Literal\["pending", "active", "deleted"] One of the following: "pending" Link to this property "active" Link to this property "deleted" Link to this property
Link to this property store\_id: str Store Identifier. maxLength32 Link to this property comment: Optional\[str] Freeform text describing the secret. Link to this property
scopes: Optional\[List\[Literal\["workers", "ai\_gateway", "dex", 3 more]]] The list of services that can use this secret. One of the following: "workers" Link to this property "ai\_gateway" Link to this property "dex" Link to this property "access" Link to this property "containers" Link to this property "websearch" Link to this property
Link to this property
[Link to this property](<#(resource)%20secrets_store.stores.secrets%20%3E%20(model)%20secret_create_response%20%3E%20(schema)>)
class SecretEditResponse: … id: str Secret identifier tag. maxLength32 Link to this property created: datetime When the secret was created. formatdate-time Link to this property modified: datetime When the secret was modified. formatdate-time Link to this property name: str The name of the secret. Link to this property
status: Literal\["pending", "active", "deleted"] One of the following: "pending" Link to this property "active" Link to this property "deleted" Link to this property
Link to this property store\_id: str Store Identifier. maxLength32 Link to this property comment: Optional\[str] Freeform text describing the secret. Link to this property
scopes: Optional\[List\[Literal\["workers", "ai\_gateway", "dex", 3 more]]] The list of services that can use this secret. One of the following: "workers" Link to this property "ai\_gateway" Link to this property "dex" Link to this property "access" Link to this property "containers" Link to this property "websearch" Link to this property
Link to this property
[Link to this property](<#(resource)%20secrets_store.stores.secrets%20%3E%20(model)%20secret_edit_response%20%3E%20(schema)>)
class SecretDuplicateResponse: … id: str Secret identifier tag. maxLength32 Link to this property created: datetime When the secret was created. formatdate-time Link to this property modified: datetime When the secret was modified. formatdate-time Link to this property name: str The name of the secret. Link to this property
status: Literal\["pending", "active", "deleted"] One of the following: "pending" Link to this property "active" Link to this property "deleted" Link to this property
Link to this property store\_id: str Store Identifier. maxLength32 Link to this property comment: Optional\[str] Freeform text describing the secret. Link to this property
scopes: Optional\[List\[Literal\["workers", "ai\_gateway", "dex", 3 more]]] The list of services that can use this secret. One of the following: "workers" Link to this property "ai\_gateway" Link to this property "dex" Link to this property "access" Link to this property "containers" Link to this property "websearch" Link to this property
Link to this property
[Link to this property](<#(resource)%20secrets_store.stores.secrets%20%3E%20(model)%20secret_duplicate_response%20%3E%20(schema)>) #### Secrets StoreQuota ##### [View secret usage](https://developers.cloudflare.com/api/python/resources/secrets_store/subresources/quota/methods/get) secrets\_store.quota.get(QuotaGetParams\*\*kwargs) -> [QuotaGetResponse]() GET/accounts/{account\_id}/secrets\_store/quota ##### ModelsExpand Collapse
class QuotaGetResponse: …
secrets: Secrets quota: float The number of secrets the account is entitled to use. Link to this property usage: float The number of secrets the account is currently using. Link to this property
Link to this property
[Link to this property](<#(resource)%20secrets_store.quota%20%3E%20(model)%20quota_get_response%20%3E%20(schema)>)