API keys
Learn how to create and manage API keys for your Yorlet account.
API keys are used to authenticate your requests to the Yorlet API. To create an API key, you need to have a Yorlet account.
Secret and publishable keys
Yorlet uses two types of API keys:
- Secret key: This key is used to authenticate your requests to the Yorlet API. Keep this key secure and never expose it in public.
- Publishable key: This key is used to authenticate your requests to the Yorlet API. You can expose this key in public.
Secret keys have full access to your account and can perform any action on your behalf. Keep them secure and never expose them in public. If you suspect that a secret key has been compromised, roll the key immediately.
Roll an API key
To roll an API key:
- Go to the API keys page.
- In the row for the key you want to roll, click the overflow menu (•••), then select Roll key….
- Confirm that you want to roll the key.
- The window displays the new key value. Copy it by clicking it.
- Save the key value. You can’t retrieve it later.
Delete an API key
You cannot delete a publishable key. You can only delete a secret key.
To delete an API key:
- Go to the API keys page.
- In the row for the key you want to delete, click the overflow menu (•••), then select Delete key.
- Confirm that you want to delete the key.
Deleting an API key is irreversible. If you delete an API key, you can’t retrieve it later.
Create a secret API key
To create a secret API key:
- Go to the API keys page.
- Click the Create secret key button.
- Enter a name for the API key and a note (optional).
- Click Create.
- The window displays the new key value. Copy it by clicking it.
- Save the key value. You can’t retrieve it later.
Use an API key
Include the API key in the Authorization
header of your requests to the Yorlet API.
Learn more about API Authentication.