Dealership APIAuthentication

Authentication

Dealership API keys are created inside the Driverseat dashboard by dealership admins. The full key is shown only once, when it is generated.

#Create an API key

  1. 1Sign in to the Driverseat dashboard.
  2. 2Open the dealership you want to connect.
  3. 3Go to Settings → Integrations.
  4. 4Find Dealership API Keys and select Generate Key.
  5. 5Copy the new key immediately and store it in your server-side secret manager.
The generated key starts with sk-driverseat-. Once the creation screen is dismissed, Driverseat only shows the key prefix and last four characters.

#Use an API key

Send the key in the x-api-key header on server-to-server requests.

Shell
curl https://api.driverseat.io/v1/update-photos \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-driverseat-..."

#Rotate an API key

Rotating a key immediately invalidates the current key and creates a replacement. Update every integration that uses the old key before or during rotation.

  1. 1Open Settings → Integrations → Dealership API Keys.
  2. 2Select Rotate Key and confirm.
  3. 3Copy the replacement key and update connected systems.

#Revoke an API key

Revoking a key immediately disables external API access for that dealership until a new key is generated.

  1. 1Open Settings → Integrations → Dealership API Keys.
  2. 2Select Revoke and confirm.
  3. 3Remove the old key from any connected systems or secret stores.