Sign in

v65

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0386234904.1 KB
Credentials

Update credential

Overwrites the stored credential data (e.g. username/password) while keeping the same credential_id.

post/v1/credentials/{credential_id}/update

Path parameters

credential_idstring required

The unique identifier of the credential to update

Example:cred_1234567890

The unique identifier of the credential to update

Headers

x-api-keystring nullable

Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.

Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.

Request body

namestring required

Name of the credential

credential_type'password' | 'credit_card' | 'secret' required

Type of credential stored in the system.

vault_type'skyvern' | 'bitwarden' | 'azure_vault' | 'gcp' | 'custom'
proxy_session_idstring nullable

Optional advanced reuse key for this credential's pinned proxy identity.

rotate_proxy_session_idboolean

Rotate the Skyvern-managed proxy sticky-session id when updating this credential.

browser_profile_idstring nullable

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.

pin_saved_session_ipboolean

Keep the same IP across sign-ins that reuse this credential's saved profile.

tested_urlstring nullable

Login page URL used during the credential test

Example request

{
  "name": "Amazon Login",
  "credential": {
    "password": "securepassword123",
    "username": "user@example.com",
    "totp": "JBSWY3DPEHPK3PXP",
    "totp_identifier": "user@example.com"
  },
  "proxy_location": {
    "country": "US",
    "subdivision": "CA",
    "city": "New York"
  }
}

Response

Successful Response

credential_idstring required

Unique identifier for the credential

credential_type'password' | 'credit_card' | 'secret' required

Type of credential stored in the system.

namestring required

Name of the credential

vault_type'skyvern' | 'bitwarden' | 'azure_vault' | 'gcp' | 'custom'
browser_profile_idstring nullable

Browser profile ID linked to this credential

pin_saved_session_ipboolean

Whether sign-ins reusing this credential's saved profile keep the same IP

tested_urlstring nullable

Login page URL used during the credential test

user_contextstring nullable

User-provided context describing the login sequence (e.g., 'click SSO button first')

save_browser_session_intentboolean nullable

Whether the user intends to save a browser session, regardless of test outcome

run_sequentiallyboolean
folder_idstring nullable

ID of the credential folder this credential belongs to, if any

proxy_session_idstring nullable

Opaque Skyvern-managed proxy sticky-session id.

Example response

{
  "credential_id": "cred_1234567890",
  "credential": {
    "username": "user@example.com",
    "totp_identifier": "user@example.com"
  },
  "name": "Amazon Login",
  "folder_id": "cfld_1234567890",
  "proxy_location": {
    "country": "US",
    "subdivision": "CA",
    "city": "New York"
  }
}