API keys
Create, use and revoke Sinera API keys from the Developer Portal, and learn what a key can read today.
API keys belong to a Sinera account. You manage them in the Developer Portal under Developers → API keys. You must be signed in with your Sinera account. In a wallet session the page explains that keys are not available and offers to switch.
What a key can do today
A key reads your own account information from the Sinera API:
| Scope | What it reads |
|---|---|
| Profile | Your account profile |
| Wallets | Your linked wallets |
| Preferences | Your preferences |
Each of the three is a separate scope that you grant when you create the key. A key cannot read Atoms, sessions or disputes, and it cannot create anything on the protocol. To read ledger data, use the SDK. The Network page lists the addresses you need.
Create a key
- Select Create API key.
- Give it a name you will recognise later, for example the service that will use it.
- Choose the scopes it needs. Grant only what the service uses.
- Choose when it expires: 7, 30, 90 or 365 days.
- Select create. The portal shows the secret once.
- Copy the secret into your secret manager, then confirm with I have saved it. The dialog does not close until you do.
A secret starts with snr_api_. You can have up to 10 active keys. At the limit, revoke one before you create another.
The secret is shown once
The portal cannot show the secret again. If you lose it, revoke the key and create a new one.
Use a key
Send the key as a bearer token in the Authorization header:
Authorization: Bearer snr_api_…Replace the placeholder with your own secret. Never paste a real key into documentation, tickets or chat.
Revoke a key
Select Revoke on the key's row and confirm. The key stops working and cannot be restored. An expired key also stops working, so plan replacements before the expiry you chose.
Keep keys safe
- Keep keys on your server. Do not put a key in a web page, a mobile app or a repository.
- Use one key per service, so you can revoke one without stopping the others.
- Prefer a short expiry and replace keys on a schedule.
- If a key may have leaked, revoke it first and investigate afterwards.
If the portal refuses
When the Sinera service refuses a request, the portal shows the service's message with a request id. Quote that id when you ask for help at info@sinera.io.