API Reference

Secrets Store

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Stores

List account stores

secrets_store.stores.list(StoreListParams**kwargs) -> SyncV4PagePaginationArray[StoreListResponse]

GET/accounts/{account_id}/secrets_store/stores

Get a store by ID

secrets_store.stores.get(strstore_id, StoreGetParams**kwargs) -> StoreGetResponse

GET/accounts/{account_id}/secrets_store/stores/{store_id}

Create a store

secrets_store.stores.create(StoreCreateParams**kwargs) -> StoreCreateResponse

POST/accounts/{account_id}/secrets_store/stores

Delete a store

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

created: datetime

When the secret was created.

formatdate-time

modified: datetime

When the secret was modified.

formatdate-time

name: str

The name of the store.

account_id: Optional[str]

Account Identifier.

maxLength32

class StoreGetResponse: …

id: str

Store Identifier.

maxLength32

created: datetime

When the secret was created.

formatdate-time

modified: datetime

When the secret was modified.

formatdate-time

name: str

The name of the store.

account_id: Optional[str]

Account Identifier.

maxLength32

class StoreCreateResponse: …

id: str

Store Identifier.

maxLength32

created: datetime

When the secret was created.

formatdate-time

modified: datetime

When the secret was modified.

formatdate-time

name: str

The name of the store.

account_id: Optional[str]

Account Identifier.

maxLength32

StoresSecrets

List store secrets

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

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

secrets_store.stores.secrets.create(strstore_id, SecretCreateParams**kwargs) -> SyncSinglePage[SecretCreateResponse]

POST/accounts/{account_id}/secrets_store/stores/{store_id}/secrets

Patch a secret

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

secrets_store.stores.secrets.delete(strsecret_id, SecretDeleteParams**kwargs) -> object

DELETE/accounts/{account_id}/secrets_store/stores/{store_id}/secrets/{secret_id}

Delete secrets

secrets_store.stores.secrets.bulk_delete(strstore_id, SecretBulkDeleteParams**kwargs) -> object

DELETE/accounts/{account_id}/secrets_store/stores/{store_id}/secrets

Duplicate Secret

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

created: datetime

When the secret was created.

formatdate-time

modified: datetime

When the secret was modified.

formatdate-time

name: str

The name of the secret.

status: Literal["pending", "active", "deleted"]

One of the following:

"pending"

"active"

"deleted"

store_id: str

Store Identifier.

maxLength32

comment: Optional[str]

Freeform text describing the secret.

scopes: Optional[List[Literal["workers", "ai_gateway", "dex", 3 more]]]

The list of services that can use this secret.

One of the following:

"workers"

"ai_gateway"

"dex"

"access"

"containers"

"websearch"

class SecretGetResponse: …

id: str

Secret identifier tag.

maxLength32

created: datetime

When the secret was created.

formatdate-time

modified: datetime

When the secret was modified.

formatdate-time

name: str

The name of the secret.

status: Literal["pending", "active", "deleted"]

One of the following:

"pending"

"active"

"deleted"

store_id: str

Store Identifier.

maxLength32

comment: Optional[str]

Freeform text describing the secret.

scopes: Optional[List[Literal["workers", "ai_gateway", "dex", 3 more]]]

The list of services that can use this secret.

One of the following:

"workers"

"ai_gateway"

"dex"

"access"

"containers"

"websearch"

class SecretCreateResponse: …

id: str

Secret identifier tag.

maxLength32

created: datetime

When the secret was created.

formatdate-time

modified: datetime

When the secret was modified.

formatdate-time

name: str

The name of the secret.

status: Literal["pending", "active", "deleted"]

One of the following:

"pending"

"active"

"deleted"

store_id: str

Store Identifier.

maxLength32

comment: Optional[str]

Freeform text describing the secret.

scopes: Optional[List[Literal["workers", "ai_gateway", "dex", 3 more]]]

The list of services that can use this secret.

One of the following:

"workers"

"ai_gateway"

"dex"

"access"

"containers"

"websearch"

class SecretEditResponse: …

id: str

Secret identifier tag.

maxLength32

created: datetime

When the secret was created.

formatdate-time

modified: datetime

When the secret was modified.

formatdate-time

name: str

The name of the secret.

status: Literal["pending", "active", "deleted"]

One of the following:

"pending"

"active"

"deleted"

store_id: str

Store Identifier.

maxLength32

comment: Optional[str]

Freeform text describing the secret.

scopes: Optional[List[Literal["workers", "ai_gateway", "dex", 3 more]]]

The list of services that can use this secret.

One of the following:

"workers"

"ai_gateway"

"dex"

"access"

"containers"

"websearch"

class SecretDuplicateResponse: …

id: str

Secret identifier tag.

maxLength32

created: datetime

When the secret was created.

formatdate-time

modified: datetime

When the secret was modified.

formatdate-time

name: str

The name of the secret.

status: Literal["pending", "active", "deleted"]

One of the following:

"pending"

"active"

"deleted"

store_id: str

Store Identifier.

maxLength32

comment: Optional[str]

Freeform text describing the secret.

scopes: Optional[List[Literal["workers", "ai_gateway", "dex", 3 more]]]

The list of services that can use this secret.

One of the following:

"workers"

"ai_gateway"

"dex"

"access"

"containers"

"websearch"