​
Keys and Secrets

Once you log into the Dashboard, you’ll find an API Keys section in the left menu. On that page, you can view your unique Client ID for the team. You’ll need this ID to authenticate with the Deck API. You will also see secret keys that are specific to each Team – Environment combination. Initially, only the Sandbox secret will be visible. To access the Production secret, go to Settings > Billing and upgrade your plan. Use the appropriate secret key for the correct environment:
  • Use the sandbox secret with the Sandbox environment
  • Use the production secret with the Live environment
Once you have your keys from the Dashboard, you can choose which API server to use.
Connecting via Widget
Connecting via Widget

​
API Environments

EnvironmentURL
Sandboxhttps://sandbox.deck.co/api/v1
Livehttps://live.deck.co/api/v1
When switching environments using the toggle in the Dashboard, the x-deck-client-id and x-deck-secret headers (and subdomain) in your API request will automatically update to match. If you’re not using the Dashboard UI to run Jobs, make sure to manually update these headers and URLs in your integration code. The Widget supports both environments and will automatically target the correct server based on the secret key used to generate the Link token.
ImportantAlways use the secret corresponding to the API server you want to use.Using a production secret with the Sandbox API or a sandbox secret with the Live API will result in a 401 Unauthorized error.