Authorization
Every request needs a Partner API key. Create one in the Partner Portal under Integrations → API Keys with Add Key, where you can restrict it to one or more IPv4 ranges in CIDR notation (203.0.113.0/24, or 203.0.113.10/32 for a single address) and set an expiry date. If that screen is not available to you, ask your Clym account manager.
The key is shown only once, so store it before closing the dialog. It has full access to your partner account — keep it secret and never expose it in client-side code.
Send it as a bearer token:
Authorization: Bearer {YOUR_API_KEY}The Bearer prefix is optional; if you use it, write it exactly as Bearer followed by a single space.
Example
curl --request GET \ --url https://partners.clym.io/api/portal/domains \ --header 'Authorization: Bearer {YOUR_API_KEY}'
A key that is missing, invalid, deactivated or expired returns 401 with the code AUTH.API_KEY, as does a request from an IP address outside the key's allowed ranges. A valid key used on a feature your partner account does not have returns 403.
Deactivating a key in Integrations → API Keys rejects every later request made with it.
