Credentials

CredentialsResource

Methods

create() ->
post/v5/credentials

Create a new credential for storing sensitive data like API keys, tokens, or other secrets.

retrieve() ->
get/v5/credentials/{credential_id}

Retrieve a specific credential by its unique identifier.

Parameters
credential_id: str
Returns
id: str
created_at:
(format: date-time)
created_by_identity_type: str
created_by_user_id: str
credential_metadata: Dict[str, ]
description: str
name: str
type: str
updated_at:
(format: date-time)
object: Optional[str]
(default: "credential")
Request example
200Example
retrieve_by_name() ->
get/v5/credentials/name/{credential_name}

Retrieve a specific credential by its name.

Parameters
credential_name: str
Returns
id: str
created_at:
(format: date-time)
created_by_identity_type: str
created_by_user_id: str
credential_metadata: Dict[str, ]
description: str
name: str
type: str
updated_at:
(format: date-time)
object: Optional[str]
(default: "credential")
Request example
200Example
decrypt() ->
post/v5/credentials/{credential_id}/secret

Retrieve the plaintext payload of a credential by its ID.

decrypt_by_name() ->
post/v5/credentials/name/{credential_name}/secret

Retrieve the plaintext payload of a credential by its name.

list() -> SyncCursorPage[]
get/v5/credentials

Retrieve a paginated list of all credentials for the current account with optional name filtering.

update(, ) ->
patch/v5/credentials/{credential_id}

Update an existing credential's properties including name, description, type, payload, and metadata.

delete() ->
delete/v5/credentials/{credential_id}

Permanently delete a credential and all its associated data.

Domain types

class Credential: ...
class CredentialSecret: ...