Update credential
Overwrites the stored credential data (e.g. username/password) while keeping the same credential_id.
Headers
Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.
Path Parameters
The unique identifier of the credential to update
"cred_1234567890"
Body
The new credential data to store
Name of the credential
"Amazon Login"
Type of credential to create
password, credit_card, secret Password credential model that requires non-empty values.
- NonEmptyPasswordCredential
- NonEmptyCreditCardCredential
- SecretCredential
Which vault to store this credential in. If omitted, uses the instance default. Use this to mix Skyvern-hosted and custom credentials within the same organization.
skyvern, bitwarden, azure_vault, gcp, custom "skyvern"
Optional proxy location for this credential's pinned proxy identity.
RESIDENTIAL, US-CA, US-NY, US-TX, US-FL, US-WA, RESIDENTIAL_ES, RESIDENTIAL_IE, RESIDENTIAL_GB, RESIDENTIAL_IN, RESIDENTIAL_JP, RESIDENTIAL_FR, RESIDENTIAL_DE, RESIDENTIAL_NZ, RESIDENTIAL_ZA, RESIDENTIAL_AR, RESIDENTIAL_AU, RESIDENTIAL_BR, RESIDENTIAL_TR, RESIDENTIAL_CA, RESIDENTIAL_MX, RESIDENTIAL_IT, RESIDENTIAL_NL, RESIDENTIAL_PH, RESIDENTIAL_KR, RESIDENTIAL_SA, RESIDENTIAL_ISP, NONE Optional advanced reuse key for this credential's pinned proxy identity.
Rotate the Skyvern-managed proxy sticky-session id when updating this credential.
Optional plain browser profile to link as this credential's saved profile. Must be an unmanaged profile in your organization that no other credential already owns.
Keep the same IP across sign-ins that reuse this credential's saved profile.
Login page URL used during the credential test
Response
Successful Response
Response model for credential operations.
Unique identifier for the credential
"cred_1234567890"
Response model for password credentials — non-sensitive fields only.
SECURITY: Must NEVER include password or TOTP secret.
- PasswordCredentialResponse
- CreditCardCredentialResponse
- SecretCredentialResponse
Type of the credential
password, credit_card, secret Name of the credential
"Amazon Login"
Which vault stores this credential (e.g., 'skyvern', 'bitwarden', 'azure_vault', 'custom')
skyvern, bitwarden, azure_vault, gcp, custom Browser profile ID linked to this credential
Whether sign-ins reusing this credential's saved profile keep the same IP
Login page URL used during the credential test
User-provided context describing the login sequence (e.g., 'click SSO button first')
Whether the user intends to save a browser session, regardless of test outcome
ID of the credential folder this credential belongs to, if any
"cfld_1234567890"
Optional proxy location used for the credential's pinned proxy identity.
RESIDENTIAL, US-CA, US-NY, US-TX, US-FL, US-WA, RESIDENTIAL_ES, RESIDENTIAL_IE, RESIDENTIAL_GB, RESIDENTIAL_IN, RESIDENTIAL_JP, RESIDENTIAL_FR, RESIDENTIAL_DE, RESIDENTIAL_NZ, RESIDENTIAL_ZA, RESIDENTIAL_AR, RESIDENTIAL_AU, RESIDENTIAL_BR, RESIDENTIAL_TR, RESIDENTIAL_CA, RESIDENTIAL_MX, RESIDENTIAL_IT, RESIDENTIAL_NL, RESIDENTIAL_PH, RESIDENTIAL_KR, RESIDENTIAL_SA, RESIDENTIAL_ISP, NONE Opaque Skyvern-managed proxy sticky-session id.

